자체 호스팅 러너 추가하기

자체 호스팅 러너 추가하기

저장소, 조직, 또는 엔터프라이즈에 자체 호스팅 러너를 추가할 수 있어요. 러너 애플리케이션을 다운로드·설치하고 config 스크립트를 실행해 GitHub Actions에 등록해요.

출처: 문서

본문

Warning

자체 호스팅 러너는 비공개 저장소에만 사용할 것을 권장해요. 공개 저장소의 포크는 워크플로에서 코드를 실행하는 풀 리퀘스트를 만들어 자체 호스팅 러너 머신에서 위험한 코드를 잠재적으로 실행할 수 있기 때문이에요.

자세한 내용은 안전한 사용 참조를 참고하세요.

사전 요구 사항

자체 호스팅 러너를 추가하기 전에 그것이 무엇이고 어떻게 작동하는지 이해해야 해요. 자체 호스팅 러너를 참고하세요.

또한 다음 요구 사항을 충족해야 해요:

• 환경에서 자체 호스팅 러너로 사용할 머신에 접근할 수 있어야 해요.

저장소에 자체 호스팅 러너 추가하기

단일 저장소에 자체 호스팅 러너를 추가할 수 있어요. 사용자 저장소에 자체 호스팅 러너를 추가하려면 저장소 소유자여야 해요. 조직 저장소의 경우 조직 소유자이거나 저장소에 대한 admin 접근 권한이 있어야 해요.

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

Note

조직 소유자는 저장소 수준 자체 호스팅 러너를 만들 수 있는 저장소를 선택할 수 있어요.

자세한 내용은 조직의 GitHub Actions 비활성화 또는 제한하기를 참고하세요.

1. GitHub에서 저장소의 메인 페이지로 이동해요.

2. 저장소 이름 아래에서 Settings 탭을 클릭해요.

   

3. 왼쪽 사이드바에서 Actions을 클릭한 다음 Runners을 클릭해요.

4. New self-hosted runner을 클릭해요.

5. 자체 호스팅 러너 머신의 운영 체제 이미지와 아키텍처를 선택해요.

   

6. 러너 애플리케이션을 다운로드해 자체 호스팅 러너 머신에 설치하는 방법을 보여주는 지침이 표시될 거예요.

   자체 호스팅 러너 머신에서 셸을 열고 표시된 순서대로 각 셸 명령을 실행해요.

   Note

   Windows에서 자체 호스팅 러너 애플리케이션을 서비스로 설치하려면 관리자 권한으로 셸을 열어야 해요. 또한 Windows 시스템 계정이 러너 디렉토리에 접근할 수 있도록 자체 호스팅 러너 애플리케이션 디렉토리로 C:\actions-runner 사용을 권장해요.

   지침은 다음 작업을 완료하도록 안내해요:

   • 자체 호스팅 러너 애플리케이션을 다운로드하고 압축을 풀어요.
   • config 스크립트를 실행해 자체 호스팅 러너 애플리케이션을 구성하고 GitHub Actions에 등록해요. config 스크립트는 요청을 인증하기 위해 대상 URL과 자동 생성된 시간 제한 토큰이 필요해요. 토큰은 1시간 후에 만료돼요.
     • Windows에서 config 스크립트는 자체 호스팅 러너 애플리케이션을 서비스로 설치할지 묻기도 해요. Linux와 macOS에서는 러너 추가를 마친 후 서비스를 설치할 수 있어요. 자세한 내용은 자체 호스팅 러너 애플리케이션을 서비스로 구성하기를 참고하세요.
   • 자체 호스팅 러너 애플리케이션을 실행해 머신을 GitHub Actions에 연결해요.

자체 호스팅 러너가 성공적으로 추가되었는지 확인하기

자체 호스팅 러너를 추가하는 단계를 완료하면 러너와 그 상태가 "Runners" 아래에 나열돼요.

러너가 작업을 받아들이려면 자체 호스팅 러너 애플리케이션이 활성 상태여야 해요. 러너 애플리케이션이 GitHub에 연결되어 작업을 받을 준비가 되면 머신의 터미널에 다음 메시지가 보여요.

√ Connected to GitHub

2019-10-24 05:45:56Z: Listening for Jobs

자세한 내용은 자체 호스팅 러너 모니터링 및 문제 해결을 참고하세요.

조직에 자체 호스팅 러너 추가하기

조직 수준에서 자체 호스팅 러너를 추가하면 조직의 여러 저장소에 대한 작업을 처리하는 데 사용할 수 있어요. 조직에 자체 호스팅 러너를 추가하려면 조직 소유자여야 해요. REST API로 자체 호스팅 러너를 추가하는 방법은 자체 호스팅 러너를 위한 REST API 엔드포인트를 참고하세요.

1. GitHub에서 조직의 메인 페이지로 이동해요.

2. 조직 이름 아래에서 Settings 탭을 클릭해요.

   

3. 왼쪽 사이드바에서 Actions을 클릭한 다음 Runners을 클릭해요.

4. New runner을 클릭한 다음 New self-hosted runner을 클릭해요.

5. 자체 호스팅 러너 머신의 운영 체제 이미지와 아키텍처를 선택해요.

   

6. 러너 애플리케이션을 다운로드해 자체 호스팅 러너 머신에 설치하는 방법을 보여주는 지침이 표시될 거예요.

   자체 호스팅 러너 머신에서 셸을 열고 표시된 순서대로 각 셸 명령을 실행해요.

   Note

   Windows에서 자체 호스팅 러너 애플리케이션을 서비스로 설치하려면 관리자 권한으로 셸을 열어야 해요. 또한 Windows 시스템 계정이 러너 디렉토리에 접근할 수 있도록 자체 호스팅 러너 애플리케이션 디렉토리로 C:\actions-runner 사용을 권장해요.

   지침은 다음 작업을 완료하도록 안내해요:

   • 자체 호스팅 러너 애플리케이션을 다운로드하고 압축을 풀어요.
   • config 스크립트를 실행해 자체 호스팅 러너 애플리케이션을 구성하고 GitHub Actions에 등록해요. config 스크립트는 요청을 인증하기 위해 대상 URL과 자동 생성된 시간 제한 토큰이 필요해요. 토큰은 1시간 후에 만료돼요.
     • Windows에서 config 스크립트는 자체 호스팅 러너 애플리케이션을 서비스로 설치할지 묻기도 해요. Linux와 macOS에서는 러너 추가를 마친 후 서비스를 설치할 수 있어요. 자세한 내용은 자체 호스팅 러너 애플리케이션을 서비스로 구성하기를 참고하세요.
   • 자체 호스팅 러너 애플리케이션을 실행해 머신을 GitHub Actions에 연결해요.

자체 호스팅 러너가 성공적으로 추가되었는지 확인하기

자체 호스팅 러너를 추가하는 단계를 완료하면 러너와 그 상태가 "Runners" 아래에 나열돼요.

러너가 작업을 받아들이려면 자체 호스팅 러너 애플리케이션이 활성 상태여야 해요. 러너 애플리케이션이 GitHub에 연결되어 작업을 받을 준비가 되면 머신의 터미널에 다음 메시지가 보여요.

√ Connected to GitHub

2019-10-24 05:45:56Z: Listening for Jobs

자세한 내용은 자체 호스팅 러너 모니터링 및 문제 해결을 참고하세요.

Note

보안상의 이유로 공개 저장소는 기본적으로 러너 그룹의 러너를 사용할 수 없지만, 러너 그룹 설정에서 이를 재정의할 수 있어요. 자세한 내용은 그룹을 사용해 자체 호스팅 러너 접근 관리하기를 참고하세요.

엔터프라이즈에 자체 호스팅 러너 추가하기

GitHub Enterprise Cloud를 사용한다면 엔터프라이즈에 자체 호스팅 러너를 추가할 수 있고, 여러 조직에 할당할 수 있어요. 조직 소유자는 어떤 저장소가 사용할 수 있는지 제어해요. 자세한 내용은 GitHub Enterprise Cloud 문서를 참고하세요.

다음 단계

자체 호스팅 러너 수를 확장하도록 자동화를 설정할 수 있어요. 자세한 내용은 자체 호스팅 러너 참조를 참고하세요.