자체 호스팅 러너 제거하기

저장소에서 자체 호스팅 러너를 영구적으로 제거할 수 있어요. 제거 명령은 러너를 GitHub에서 제거하고, 머신의 구성 파일과 서비스를 정리해요.

출처: 문서

본문

저장소에서 러너 제거하기

Note

이 절차는 자체 호스팅 러너를 영구적으로 제거해요. 러너가 작업을 할당받지 않도록 일시적으로 중지만 하려면 머신을 종료하거나 run 애플리케이션을 중지하면 돼요. 러너는 "Offline" 상태로 할당된 채로 남아 있으며, run 애플리케이션으로 러너를 다시 시작할 때까지 어떤 작업도 실행하지 않아요.

자체 호스팅 러너가 14일 이상 GitHub Actions에 연결되지 않으면 GitHub에서 자동으로 제거돼요. 임시(ephemeral) 자체 호스팅 러너는 1일 이상 GitHub Actions에 연결되지 않으면 GitHub에서 자동으로 제거돼요.

JIT(Just-in-time) 러너는 단일 작업만 실행할 수 있어요. JIT 러너가 작업을 실행한 적이 없으면 자동으로 제거돼요. 자동 제거 전에 JIT 러너를 제거하려면 GitHub에서 JIT 러너를 제거해야 해요.

사용자 저장소에서 자체 호스팅 러너를 제거하려면 저장소 소유자여야 해요. 조직 소유자는 조직의 저장소에서 러너를 제거할 수 있어요.

자체 호스팅 러너 머신에 대한 접근 권한도 있는 것을 권장해요.

REST API로 자체 호스팅 러너를 제거하는 방법은 자체 호스팅 러너를 위한 REST API 엔드포인트를 참고하세요.

이와 달리 GitHub의 저장소나 조직에 접근할 수 없어 러너를 제거할 수 없지만 러너 머신을 재사용하려면, 자체 호스팅 러너 애플리케이션 디렉토리(러너 소프트웨어를 다운로드해 압축을 푼 디렉토리) 안의 .runner 파일을 삭제할 수 있어요. 이렇게 하면 자체 호스팅 러너 애플리케이션을 다시 다운로드하지 않고도 러너를 등록할 수 있어요.

GitHub에서 저장소의 메인 페이지로 이동해요.
저장소 이름 아래에서 Settings 탭을 클릭해요.
왼쪽 사이드바에서 Actions을 클릭한 다음 Runners을 클릭해요.
러너 목록에서 구성할 러너의 이름을 클릭해요.
Remove을 클릭해요.
자체 호스팅 러너를 제거하는 지침이 표시될 거예요. 러너가 여전히 접근 가능한지에 따라 다음 단계 중 하나를 완료해 러너를 제거해요:
- 러너 머신에 접근할 수 있다면: 머신의 운영 체제에 대한 화면 지침을 따라 제거 명령을 실행해요. 지침에는 필수 URL과 자동 생성된 시간 제한 토큰이 포함돼요.
  
  제거 명령은 다음 작업을 수행해요:
  - GitHub에서 러너를 제거해요.
  - 머신의 자체 호스팅 러너 애플리케이션 구성 파일을 제거해요.
  - 대화형 모드로 실행 중이 아니라면 구성된 서비스를 제거해요.
- 머신에 접근할 수 없다면: Force remove this runner을 클릭해 GitHub이 러너를 강제로 제거하게 해요.

조직에서 러너 제거하기

Note

이 절차는 자체 호스팅 러너를 영구적으로 제거해요. 러너가 작업을 할당받지 않도록 일시적으로 중지만 하려면 머신을 종료하거나 run 애플리케이션을 중지하면 돼요. 러너는 "Offline" 상태로 할당된 채로 남아 있으며, run 애플리케이션으로 러너를 다시 시작할 때까지 어떤 작업도 실행하지 않아요.

자체 호스팅 러너가 14일 이상 GitHub Actions에 연결되지 않으면 GitHub에서 자동으로 제거돼요. 임시(ephemeral) 자체 호스팅 러너는 1일 이상 GitHub Actions에 연결되지 않으면 GitHub에서 자동으로 제거돼요.

JIT(Just-in-time) 러너는 단일 작업만 실행할 수 있어요. JIT 러너가 작업을 실행한 적이 없으면 자동으로 제거돼요. 자동 제거 전에 JIT 러너를 제거하려면 GitHub에서 JIT 러너를 제거해야 해요.

조직에서 자체 호스팅 러너를 제거하려면 조직 소유자여야 해요. 자체 호스팅 러너 머신에 대한 접근 권한도 있는 것을 권장해요. REST API로 자체 호스팅 러너를 제거하는 방법은 자체 호스팅 러너를 위한 REST API 엔드포인트를 참고하세요.

GitHub에서 조직의 메인 페이지로 이동해요.
조직 이름 아래에서 Settings 탭을 클릭해요.
왼쪽 사이드바에서 Actions을 클릭한 다음 Runners을 클릭해요.
러너 목록에서 구성할 러너의 이름을 클릭해요.
Remove을 클릭해요.
자체 호스팅 러너를 제거하는 지침이 표시될 거예요. 러너가 여전히 접근 가능한지에 따라 다음 단계 중 하나를 완료해 러너를 제거해요:
- 러너 머신에 접근할 수 있다면: 머신의 운영 체제에 대한 화면 지침을 따라 제거 명령을 실행해요. 지침에는 필수 URL과 자동 생성된 시간 제한 토큰이 포함돼요.
  
  제거 명령은 다음 작업을 수행해요:
  - GitHub에서 러너를 제거해요.
  - 머신의 자체 호스팅 러너 애플리케이션 구성 파일을 제거해요.
  - 대화형 모드로 실행 중이 아니라면 구성된 서비스를 제거해요.
- 머신에 접근할 수 없다면: Force remove this runner을 클릭해 GitHub이 러너를 강제로 제거하게 해요.

엔터프라이즈에서 러너 제거하기

GitHub Enterprise Cloud를 사용한다면 엔터프라이즈에서도 러너를 제거할 수 있어요. 자세한 내용은 GitHub Enterprise Cloud 문서를 참고하세요.