Skip to main content
설명서에 자주 업데이트를 게시하며 이 페이지의 번역이 계속 진행 중일 수 있습니다. 최신 정보는 영어 설명서를 참조하세요.

이 버전의 GitHub Enterprise는 다음 날짜에 중단되었습니다. 2023-03-15. 중요한 보안 문제에 대해서도 패치 릴리스가 이루어지지 않습니다. 성능 향상, 향상된 보안, 새로운 기능을 위해 최신 버전의 GitHub Enterprise로 업그레이드합니다. 업그레이드에 대한 도움말은 GitHub Enterprise 지원에 문의하세요.

자체 호스팅 실행기 추가

리포지토리, 조직 또는 엔터프라이즈에 자체 호스팅 실행기를 추가할 수 있습니다.

참고: GitHub 호스트 실행기는 현재 GitHub Enterprise Server에서 지원되지 않습니다. GitHub public roadmap에 예정된 향후 지원에 대해 자세히 알아볼 수 있습니다.

리포지토리, 조직 또는 엔터프라이즈에 자체 호스팅 실행기를 추가할 수 있습니다.

조직 또는 엔터프라이즈 관리자인 경우 조직 또는 엔터프라이즈 수준에서 자체 호스팅 실행기를 추가해야 합니다. 이 방법을 사용하면 조직 또는 엔터프라이즈의 여러 리포지토리에서 실행기를 사용할 수 있으며 한 곳에서 실행기를 관리할 수도 있습니다.

자체 호스팅 실행기 또는 프록시 서버에서 자체 호스팅 실행기를 사용하는 지원되는 운영 체제에 대한 자세한 내용은 "자체 호스팅 실행기 정보"을 참조하세요.

경고: 프라이빗 리포지토리에는 자체 호스팅 실행기만 사용하는 것이 좋습니다. 퍼블릭 리포지토리의 포크가 워크플로에서 코드를 실행하는 끌어오기 요청을 만들어 자체 호스팅 실행기 컴퓨터에서 위험한 코드를 실행할 수 있기 때문입니다.

자세한 내용은 "자체 호스팅 실행기 정보"을 참조하세요.

자동화를 설정하여 자체 호스팅 실행기 수를 스케일링할 수 있습니다. 자세한 내용은 "자체 호스팅 실행기로 자동 스케일링"을 참조하세요.

필수 조건

  • GitHub Enterprise Server에 대해 GitHub Actions를 사용 설정해야 합니다. 사이트 관리자는 인스턴스에서 GitHub Actions를 사용하도록 설정하고 구성할 수 있습니다. 자세한 내용은 "GitHub Enterprise Server용 GitHub Actions 시작"을 참조하세요.

  • 사용자 환경에서 자체 호스팅 실행기로 사용할 컴퓨터에 액세스할 수 있어야 합니다.

  • 자체 호스트 실행기와 GitHub Enterprise Server 간의 연결은 HTTP(포트 80) 또는 HTTPS(포트 443)를 초과합니다. HTTPS를 통한 연결을 보장하려면 GitHub Enterprise Server 인스턴스에 대한 TLS를 구성합니다. 자세한 내용은 "AUTOTITLE"을 참조하세요. 자세한 내용은 "AUTOTITLE"을 참조하세요.

리포지토리에 자체 호스팅 실행기 추가

단일 리포지토리에 자체 호스팅 실행기를 추가할 수 있습니다. 사용자 리포지토리에 자체 호스팅 실행기를 추가하려면 리포지토리 소유자여야 합니다. 조직 리포지토리의 경우 조직 소유자이거나 리포지토리에 대한 관리자 액세스 권한이 있어야 합니다. REST API를 사용하여 자체 호스팅 실행기를 추가하는 방법에 대한 자세한 내용은 "동작.

  1. GitHub Enterprise Server 인스턴스에서 리포지토리의 기본 페이지로 이동합니다. 1. 리포지토리 이름 아래에서 설정을 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.

    탭을 보여 주는 리포지토리 헤더의 스크린샷. "설정" 탭은 진한 주황색 윤곽선으로 강조 표시됩니다. 1. 왼쪽 사이드바에서 작업.

  2. 왼쪽 사이드바의 “작업”에서 실행기를 클릭합니다.

  3. 자체 호스팅 실행기 새로 만들기를 클릭합니다.

  4. 자체 호스팅 실행기 컴퓨터의 운영 체제 이미지 및 아키텍처를 선택합니다.

  5. 실행기 애플리케이션을 다운로드하고 자체 호스팅 실행기 컴퓨터에 설치하는 방법을 보여 주는 지침이 표시됩니다.

    자체 호스팅 실행기 컴퓨터에서 셸을 열고 표시되는 순서대로 각 셸 명령을 실행합니다.

    참고: Windows에서 자체 호스팅 실행기 애플리케이션을 서비스로 설치하려면 관리자 권한으로 셸을 열어야 합니다. 또한 Windows 시스템 계정이 실행기 디렉터리에 액세스할 수 있도록 자체 호스팅 실행기 애플리케이션의 디렉터리로 C:\actions-runner를 사용하는 것이 좋습니다.

    지침은 다음 작업을 완료하는 단계를 안내합니다.

    • 자체 호스팅 실행기 애플리케이션 다운로드 및 추출
    • config 스크립트를 실행하여 자체 호스팅 실행기 애플리케이션을 구성하고 GitHub Actions에 등록합니다. config 스크립트에는 요청을 인증하기 위해 대상 URL 및 자동으로 생성된 시간 제한 토큰이 필요합니다.
    • 자체 호스팅 실행기 애플리케이션을 실행하여 컴퓨터를 GitHub Actions에 연결합니다. ### 자체 호스트 실행기를 성공적으로 추가했는지 확인

자체 호스트 실행기를 추가하는 단계를 완료하면 이제 실행기와 실행기 상태가 “자체 호스트 실행기”에 나열됩니다.

실행기에서 작업을 수락하려면 자체 호스트 실행기 애플리케이션이 활성화되어 있어야 합니다. 실행기 애플리케이션이 GitHub Enterprise Server에 연결되어 작업을 받을 준비가 되면 머신의 터미널에 다음 메시지가 표시됩니다.

√ Connected to GitHub

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

자세한 내용은 "자체 호스팅 실행기 모니터링 및 문제 해결"을 참조하세요.

조직에 자체 호스팅 실행기 추가

자체 호스팅 실행기를 조직 수준에서 추가하여 조직의 여러 리포지토리에 대한 작업을 처리하는 데 사용할 수 있습니다. 조직에 자체 호스팅 실행기를 추가하려면 조직 소유자여야 합니다. REST API를 사용하여 자체 호스팅 실행기를 추가하는 방법에 대한 자세한 내용은 "동작.

  1. GitHub Enterprise Server 인스턴스에서 조직의 기본 페이지로 이동합니다. 1. 조직 이름에서 설정을 클릭합니다.

     조직 설정 단추 1. 왼쪽 사이드바에서 작업.

  2. 왼쪽 사이드바의 “작업”에서 실행기를 클릭합니다. 1. 새 실행기를 클릭합니다. 1. 자체 호스팅 실행기 컴퓨터의 운영 체제 이미지 및 아키텍처를 선택합니다.

  3. 실행기 애플리케이션을 다운로드하고 자체 호스팅 실행기 컴퓨터에 설치하는 방법을 보여 주는 지침이 표시됩니다.

    자체 호스팅 실행기 컴퓨터에서 셸을 열고 표시되는 순서대로 각 셸 명령을 실행합니다.

    참고: Windows에서 자체 호스팅 실행기 애플리케이션을 서비스로 설치하려면 관리자 권한으로 셸을 열어야 합니다. 또한 Windows 시스템 계정이 실행기 디렉터리에 액세스할 수 있도록 자체 호스팅 실행기 애플리케이션의 디렉터리로 C:\actions-runner를 사용하는 것이 좋습니다.

    지침은 다음 작업을 완료하는 단계를 안내합니다.

    • 자체 호스팅 실행기 애플리케이션 다운로드 및 추출
    • config 스크립트를 실행하여 자체 호스팅 실행기 애플리케이션을 구성하고 GitHub Actions에 등록합니다. config 스크립트에는 요청을 인증하기 위해 대상 URL 및 자동으로 생성된 시간 제한 토큰이 필요합니다.
    • 자체 호스팅 실행기 애플리케이션을 실행하여 컴퓨터를 GitHub Actions에 연결합니다. ### 자체 호스트 실행기를 성공적으로 추가했는지 확인

자체 호스트 실행기를 추가하는 단계를 완료하면 이제 실행기와 실행기 상태가 “자체 호스트 실행기”에 나열됩니다.

실행기에서 작업을 수락하려면 자체 호스트 실행기 애플리케이션이 활성화되어 있어야 합니다. 실행기 애플리케이션이 GitHub Enterprise Server에 연결되어 작업을 받을 준비가 되면 머신의 터미널에 다음 메시지가 표시됩니다.

√ Connected to GitHub

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

자세한 내용은 "자체 호스팅 실행기 모니터링 및 문제 해결"을 참조하세요.

참고: 보안상의 이유로 퍼블릭 리포지토리는 기본적으로 실행기 그룹에서 실행기를 사용할 수 없지만 실행기 그룹의 설정에서 이를 재정의할 수 있습니다. 자세한 내용은 "그룹을 사용하여 자체 호스팅 실행기에 대한 액세스 관리"을 참조하세요.

엔터프라이즈에 자체 호스팅 실행기 추가

자체 호스팅 실행기를 여러 조직에 할당할 수 있는 엔터프라이즈에 추가할 수 있습니다. 그러면 조직 관리자는 이를 사용할 수 있는 리포지토리를 제어할 수 있습니다.

새 실행기는 기본 그룹에 할당됩니다. 실행기를 등록한 후 실행기 그룹을 수정할 수 있습니다. 자세한 내용은 "그룹을 사용하여 자체 호스팅 실행기에 대한 액세스 관리"을 참조하세요.

엔터프라이즈에 자체 호스팅 실행기를 추가하려면 엔터프라이즈 소유자여야 합니다. REST API를 사용하여 자체 호스트 실행기를 추가하는 방법에 대한 자세한 내용은 GitHub Actions REST API의 엔터프라이즈 엔드포인트를 참조하세요.

  1. GitHub Enterprise Server의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음 엔터프라이즈 설정을 클릭합니다. GitHub Enterprise Server의 프로필 사진에 대한 드롭다운 메뉴의 “엔터프라이즈 설정” 1. 엔터프라이즈 계정 사이드바에서 정책을 클릭합니다. 1. “ 정책”에서 작업을 클릭합니다. 1. 실행기 탭을 클릭합니다. 1. 새 실행기를 클릭합니다. 1. 자체 호스팅 실행기 컴퓨터의 운영 체제 이미지 및 아키텍처를 선택합니다.

  2. 실행기 애플리케이션을 다운로드하고 자체 호스팅 실행기 컴퓨터에 설치하는 방법을 보여 주는 지침이 표시됩니다.

    자체 호스팅 실행기 컴퓨터에서 셸을 열고 표시되는 순서대로 각 셸 명령을 실행합니다.

    참고: Windows에서 자체 호스팅 실행기 애플리케이션을 서비스로 설치하려면 관리자 권한으로 셸을 열어야 합니다. 또한 Windows 시스템 계정이 실행기 디렉터리에 액세스할 수 있도록 자체 호스팅 실행기 애플리케이션의 디렉터리로 C:\actions-runner를 사용하는 것이 좋습니다.

    지침은 다음 작업을 완료하는 단계를 안내합니다.

    • 자체 호스팅 실행기 애플리케이션 다운로드 및 추출
    • config 스크립트를 실행하여 자체 호스팅 실행기 애플리케이션을 구성하고 GitHub Actions에 등록합니다. config 스크립트에는 요청을 인증하기 위해 대상 URL 및 자동으로 생성된 시간 제한 토큰이 필요합니다.
    • 자체 호스팅 실행기 애플리케이션을 실행하여 컴퓨터를 GitHub Actions에 연결합니다.

자체 호스트 실행기를 성공적으로 추가했는지 확인

자체 호스트 실행기를 추가하는 단계를 완료하면 이제 실행기와 실행기 상태가 “자체 호스트 실행기”에 나열됩니다.

실행기에서 작업을 수락하려면 자체 호스트 실행기 애플리케이션이 활성화되어 있어야 합니다. 실행기 애플리케이션이 GitHub Enterprise Server에 연결되어 작업을 받을 준비가 되면 머신의 터미널에 다음 메시지가 표시됩니다.

√ Connected to GitHub

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

자세한 내용은 "자체 호스팅 실행기 모니터링 및 문제 해결"을 참조하세요.

참고: 보안상의 이유로 퍼블릭 리포지토리는 기본적으로 실행기 그룹에서 실행기를 사용할 수 없지만 실행기 그룹의 설정에서 이를 재정의할 수 있습니다. 자세한 내용은 "그룹을 사용하여 자체 호스팅 실행기에 대한 액세스 관리"을 참조하세요.

엔터프라이즈 실행기를 리포지토리에 사용할 수 있도록 만들기

기본적으로 엔터프라이즈의 “기본” 자체 호스팅 실행기 그룹의 실행기는 엔터프라이즈의 모든 조직에서 사용할 수 있지만 각 조직의 일부 리포지토리에는 사용할 수 없습니다.

엔터프라이즈 수준의 자체 호스팅 실행기 그룹을 조직 리포지토리에서 사용할 수 있도록 하려면 실행기 그룹에 대한 조직의 상속된 설정을 변경하여 실행기를 조직의 리포지토리에 사용할 수 있도록 해야 합니다.

실행기 그룹 액세스 설정을 변경하는 방법에 대한 자세한 내용은 "그룹을 사용하여 자체 호스팅 실행기에 대한 액세스 관리.

추가 참고 자료