Skip to main content

대형 실행기 관리하기

조직 또는 엔터프라이즈에 대해 더 큰 실행기을(를) 구성할 수 있습니다.

누가 이 기능을 사용할 수 있나요?

대형 러너은(는) GitHub Team 플랜 또는 GitHub Enterprise Cloud 플랜을 사용하는 조직 및 기업만 사용할 수 있습니다.

Enterprise or organization owners can manage larger runners. Users with the "Manage organization runners and runner groups" permission can manage larger runners at the organization level.

Note

  • 이 문서의 정보 및 지침은 Linux 및 Windows 운영 체제의 더 큰 실행기에만 적용됩니다.

엔터프라이즈에 더 큰 실행기 추가

엔터프라이즈 소유자는 더 큰 실행기을(를) 엔터프라이즈에 추가하고 조직에 할당할 수 있습니다. 기본적으로 엔터프라이즈에 대해 더 큰 실행기이(가) 만들어지면 엔터프라이즈의 모든 조직에서 액세스할 수 있는 기본 실행기 그룹에 추가됩니다. 모든 조직에 실행기 액세스 권한이 부여되지만 각 조직의 리포지토리에는 액세스 권한이 부여되지 않습니다. 각 조직에 대해 조직 소유자가 엔터프라이즈 실행기 액세스 권한이 있는 리포지토리를 지정하도록 실행기 그룹을 구성해야 합니다. 자세한 내용은 “리포지토리에서 더 큰 실행기에 액세스하도록 허용”을 참조하세요.

사용 가능한 옵션 목록에서 운영 체제 및 하드웨어 구성을 선택할 수 있습니다. 이 실행기의 새 인스턴스가 자동 크기 조정을 통해 배포되면 여기서 정의한 것과 동일한 운영 체제 및 하드웨어 구성을 사용합니다.

새 실행기는 기본 그룹에 자동으로 할당되거나 실행기 생성 프로세스 중에 실행기를 조인해야 하는 그룹을 선택할 수 있습니다. 또한 실행기를 등록한 후 실행기 그룹 멤버 자격을 수정할 수 있습니다. 자세한 내용은 "더 큰 실행기 액세스 제어"을(를) 참조하세요.

  1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음 엔터프라이즈를 클릭합니다.

  2. 엔터프라이즈 목록에서 보려는 엔터프라이즈를 클릭합니다.

  3. 페이지 왼쪽의 엔터프라이즈 계정 사이드바에서 정책을 클릭합니다.

  4. " 정책"에서 작업을 클릭합니다.

  5. 실행기 탭을 클릭합니다.

  6. 새 실행기를 클릭한 다음 새 GitHub 호스트형 실행기를 클릭합니다.

  7. 새 실행기를 구성하는 데 필요한 세부 정보를 완료합니다.

    • 이름새 실행기의 이름을 입력합니다. 보다 쉽게 식별하려면 하드웨어 및 운영 구성(예: ubuntu-20.04-16core)을 나타내야 합니다.

    • 플랫폼: 사용 가능한 옵션에서 플랫폼을 선택합니다. 플랫폼을 선택하면 특정 이미지를 선택할 수 있습니다.

    • 이미지: 사용 가능한 옵션에서 이미지를 선택합니다. 이미지를 선택하면 특정 크기를 선택할 수 있습니다.

      • GitHub 소유: GitHub에서 관리하는 이미지의 경우 이 탭에서 이미지를 선택합니다.
      • 파트너: 파트너가 관리하는 이미지의 경우 이 탭에서 이미지를 선택합니다. Windows 11 바탕 화면 및 GPU 최적화 이미지는 이 탭 아래에 있습니다.
    • 크기: 사용 가능한 옵션의 목록에서 하드웨어 구성을 선택합니다. 사용 가능한 크기는 이전 단계에서 선택한 이미지에 따라 달라집니다. GPU 실행기에서 GPU 기반 탭에서 크기를 선택합니다.

    • 최대 동시 실행: 언제든지 활성화할 수 있는 최대 작업 수를 선택합니다.

    • 실행기 그룹: 실행기가 속할 그룹을 선택합니다. 이 그룹은 수요에 맞게 확장 및 축소되므로 실행기의 여러 인스턴스를 호스트합니다.

    • 네트워킹: 더 큰 실행기의 인스턴스에 고정 IP 주소 범위를 할당할지를 선택합니다. 고정 IP 주소를 모두 합쳐 더 큰 실행기 최대 10개를 사용할 수 있습니다.

    Note

    대형 러너의 이름은 해당 기능을 지정할 수 있습니다. 예를 들어 더 큰 실행기을(를) code scanning 기본 설정에 사용하려면 실행기 이름을 code-scanning로 지정해야 합니다. code scanning 및 대형 러너에 대한 자세한 내용은 "기본 설정에 대해 대형 러너 구성하기"을 참조하세요.

  8. 실행기 만들기를 클릭합니다.

  9. 조직이 더 큰 실행기에 액세스할 수 있게 하려면 실행기가 할당된 실행기 그룹을 사용할 수 있는 조직을 지정합니다. 자세한 내용은 "더 큰 실행기 액세스 제어"을(를) 참조하세요.

조직에 더 큰 실행기 추가

조직 소유자 및 "조직 실행기 및 실행기 그룹 관리" 권한을 가진 사용자는 조직에 더 큰 실행기를 추가하여 이를 사용할 수 있는 리포지토리를 제어할 수 있습니다. 조직을 위한 새 실행기를 만들 때 기본적으로 조직의 모든 리포지토리는 실행기 액세스 권한이 있습니다. 실행기를 사용할 수 있는 리포지토리를 제한하려면 특정 리포지토리에 대한 액세스 권한이 있는 실행기 그룹에 할당합니다. 자세한 내용은 "리포지토리에서 대형 러너에 액세스하도록 허용"을 참조하세요.

사용 가능한 옵션 목록에서 운영 체제 및 하드웨어 구성을 선택할 수 있습니다. 이 실행기의 새 인스턴스가 자동 크기 조정을 통해 배포되면 여기서 정의한 것과 동일한 운영 체제 및 하드웨어 구성을 사용합니다.

새 실행기는 기본 그룹에 자동으로 할당되거나 실행기 생성 프로세스 중에 실행기를 조인해야 하는 그룹을 선택할 수 있습니다. 또한 실행기를 등록한 후 실행기 그룹 멤버 자격을 수정할 수 있습니다. 자세한 내용은 "더 큰 실행기 액세스 제어"을(를) 참조하세요.

  1. GitHub에서 조직의 기본 페이지로 이동합니다.

  2. 조직 이름에서 설정을 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.

    조직 프로필에 있는 여러 탭의 스크린샷. "설정" 탭이 진한 주황색으로 표시됩니다.

  3. 왼쪽 사이드바에서 작업을 클릭한 다음 길행기를 클릭합니다.

  4. 새 실행기를 클릭한 다음 새 GitHub 호스트형 실행기를 클릭합니다.

  5. 새 실행기를 구성하는 데 필요한 세부 정보를 완료합니다.

    • 이름새 실행기의 이름을 입력합니다. 보다 쉽게 식별하려면 하드웨어 및 운영 구성(예: ubuntu-20.04-16core)을 나타내야 합니다.

    • 플랫폼: 사용 가능한 옵션에서 플랫폼을 선택합니다. 플랫폼을 선택하면 특정 이미지를 선택할 수 있습니다.

    • 이미지: 사용 가능한 옵션에서 이미지를 선택합니다. 이미지를 선택하면 특정 크기를 선택할 수 있습니다.

      • GitHub 소유: GitHub에서 관리하는 이미지의 경우 이 탭에서 이미지를 선택합니다.
      • 파트너: 파트너가 관리하는 이미지의 경우 이 탭에서 이미지를 선택합니다. Windows 11 바탕 화면 및 GPU 최적화 이미지는 이 탭 아래에 있습니다.
    • 크기: 사용 가능한 옵션의 목록에서 하드웨어 구성을 선택합니다. 사용 가능한 크기는 이전 단계에서 선택한 이미지에 따라 달라집니다. GPU 실행기에서 GPU 기반 탭에서 크기를 선택합니다.

    • 최대 동시 실행: 언제든지 활성화할 수 있는 최대 작업 수를 선택합니다.

    • 실행기 그룹: 실행기가 속할 그룹을 선택합니다. 이 그룹은 수요에 맞게 확장 및 축소되므로 실행기의 여러 인스턴스를 호스트합니다.

    • 네트워킹: 더 큰 실행기의 인스턴스에 고정 IP 주소 범위를 할당할지를 선택합니다. 고정 IP 주소를 모두 합쳐 더 큰 실행기 최대 10개를 사용할 수 있습니다.

    Note

    대형 러너의 이름은 해당 기능을 지정할 수 있습니다. 예를 들어 더 큰 실행기을(를) code scanning 기본 설정에 사용하려면 실행기 이름을 code-scanning로 지정해야 합니다. code scanning 및 대형 러너에 대한 자세한 내용은 "기본 설정에 대해 대형 러너 구성하기"을 참조하세요.

  6. 실행기 만들기를 클릭합니다.

  7. 리포지토리가 더 큰 실행기에 액세스할 수 있도록 하게 사용할 수 있는 리포지토리 목록에 추가합니다. 자세한 내용은 “리포지토리에서 더 큰 실행기에 액세스하도록 허용”을 참조하세요.

리포지토리에서 더 큰 실행기에 액세스하도록 허용

리포지토리에는 실행기 그룹을 통해 더 큰 실행기에 대한 액세스 권한이 부여됩니다. 엔터프라이즈 관리자는 엔터프라이즈 수준 실행기 그룹에 대한 액세스 권한이 부여된 조직을 선택할 수 있으며 조직 소유자 및 "조직 실행기 및 실행기 그룹 관리" 권한을 가진 사용자는 모든 더 큰 실행기에 대한 리포지토리 수준 액세스를 제어할 수 있습니다.

조직 소유자는 조직의 리포지토리에 대해 엔터프라이즈 수준 실행기 그룹을 사용하고 구성하거나 액세스를 제어하는 조직 수준 실행기 그룹을 만들 수 있습니다. "조직 실행기 및 실행기 그룹 관리" 권한을 가진 사용자는 조직 수준 실행기 그룹만 관리할 수 있습니다. 자세한 내용은 "사용자 지정 조직 역할 소개"을(를) 참조하세요.

  • 엔터프라이즈 수준의 실행기 그룹: 기본적으로 조직의 리포지토리는 엔터프라이즈 수준 실행기 그룹에 액세스할 수 없습니다. 엔터프라이즈 실행기 그룹에 대한 리포지토리 액세스 권한을 부여하려면 조직 소유자가 각 엔터프라이즈 실행기 그룹을 구성하고 액세스 권한이 있는 리포지토리를 선택해야 합니다.
  • 조직 수준의 실행기 그룹: 기본적으로 조직의 모든 리포지토리에는 조직 수준 실행기 그룹에 대한 액세스 권한이 부여됩니다. 액세스 권한이 있는 리포지토리를 제한하려면 조직 소유자 및 "조직 실행기 및 실행기 그룹 관리" 권한을 가진 사용자는 조직 실행기 그룹을 구성하고 액세스 권한을 가질 리포지토리를 선택해야 합니다.

리포지토리에서 더 큰 실행기에 액세스할 수 있으면 더 큰 실행기을(를) 워크플로 파일에 추가할 수 있습니다. 자세한 내용은 "더 큰 실행기에서 작업 실행"을(를) 참조하세요.

  1. 실행기 그룹이 있는 조직의 기본 페이지로 이동합니다.
  2. 설정을 클릭합니다.
  3. 왼쪽 사이드바에서 작업을 클릭한 다음 실행기 그룹을 클릭합니다.
  4. 페이지의 목록 중 하나에서 실행기 그룹을 선택합니다. 조직 수준 실행기 그룹은 페이지 맨 위에 나열되고 엔터프라이즈 수준 실행기 그룹은 "엔터프라이즈에서 공유"에 나열됩니다.
  5. 실행기 그룹 페이지의 "리포지토리 액세스"에서 모든 리포지토리 또는 선택한 리포지토리를 선택합니다. 특정 리포지토리에 대한 액세스 권한을 부여하도록 선택한 경우 을(를) 클릭한 다음 목록에서 액세스 권한을 부여할 리포지토리를 선택합니다.

Warning

고정된 IP 범위를 사용 중이라면, 개인 리포지토리에는 더 큰 실행기만 사용하는 것이 좋습니다. 리포지토리의 포크가 워크플로에서 코드를 실행하는 끌어오기 요청을 만들어 더 큰 실행기에서 위험한 코드를 실행할 수 있기 때문입니다. 자세한 정보는 "더 큰 실행기 액세스 제어"을(를) 참조하세요.

더 큰 실행기의 이름 변경

Note

대형 러너의 이름은 해당 기능을 지정할 수 있습니다. 예를 들어 더 큰 실행기을(를) code scanning 기본 설정에 사용하려면 실행기 이름을 code-scanning로 지정해야 합니다. code scanning 및 대형 러너에 대한 자세한 내용은 "기본 설정에 대해 대형 러너 구성하기"을 참조하세요.

더 큰 실행기의 이름을 편집할 수 있습니다.

조직 실행기의 이름 변경

  1. GitHub에서 조직의 기본 페이지로 이동합니다.

  2. 조직 이름에서 설정을 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.

    조직 프로필에 있는 여러 탭의 스크린샷. "설정" 탭이 진한 주황색으로 표시됩니다.

  3. 왼쪽 사이드바에서 작업을 클릭한 다음 길행기를 클릭합니다.

  4. 실행기 목록에서 편집할 실행기를 선택합니다.

  5. “이름” 텍스트 필드에 실행기의 새 이름을 입력합니다.

  6. 저장을 클릭합니다.

엔터프라이즈 실행기의 이름 변경

  1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음 엔터프라이즈를 클릭합니다.

  2. 엔터프라이즈 목록에서 보려는 엔터프라이즈를 클릭합니다.

  3. 페이지 왼쪽의 엔터프라이즈 계정 사이드바에서 정책을 클릭합니다.

  4. " 정책"에서 작업을 클릭합니다.

  5. 실행기 탭을 클릭합니다.

  6. 실행기 목록에서 편집할 실행기를 선택합니다.

  7. “이름” 텍스트 필드에 실행기의 새 이름을 입력합니다.

  8. 저장을 클릭합니다.

더 큰 실행기 자동 크기 조정 구성

특정 실행기 집합에 대해 동시에 실행할 수 있는 최대 작업 수를 제어할 수 있습니다. 이 필드를 더 높은 값으로 설정하면 병렬 처리로 인해 워크플로가 차단되는 것을 방지할 수 있습니다.

조직 실행기를 위한 자동 크기 조정 구성

  1. GitHub에서 조직의 기본 페이지로 이동합니다.

  2. 조직 이름에서 설정을 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.

    조직 프로필에 있는 여러 탭의 스크린샷. "설정" 탭이 진한 주황색으로 표시됩니다.

  3. 왼쪽 사이드바에서 작업을 클릭한 다음 길행기를 클릭합니다.

  4. 실행기 목록에서 편집할 실행기를 선택합니다.

  5. "자동 크기 조정" 섹션의 "동시 최대 작업"에서 동시에 실행할 수 있는 최대 작업 수를 입력합니다.

  6. 저장을 클릭합니다.

엔터프라이즈 실행기를 위한 자동 크기 조정 구성

  1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음 엔터프라이즈를 클릭합니다.

  2. 엔터프라이즈 목록에서 보려는 엔터프라이즈를 클릭합니다.

  3. 페이지 왼쪽의 엔터프라이즈 계정 사이드바에서 정책을 클릭합니다.

  4. " 정책"에서 작업을 클릭합니다.

  5. 실행기 탭을 클릭합니다.

  6. 실행기 목록에서 편집할 실행기를 선택합니다.

  7. "자동 크기 조정" 섹션의 "동시 최대 작업"에서 동시에 실행할 수 있는 최대 작업 수를 입력합니다.

  8. 저장을 클릭합니다.

더 큰 실행기에 대한 고정 IP 주소 만들기

Note

감사 로그 API를 사용하려면 조직에서 GitHub Enterprise Cloud을(를) 사용해야 합니다. GitHub Enterprise Cloud를 체험해 보는 방법에 대한 자세한 내용은 “GitHub Enterprise Cloud 평가판 설정”을 참조하세요.

더 큰 실행기에 대한 고정 IP 주소를 만들 수 있도록 설정할 수 있습니다. 이렇게 하면 더 큰 실행기에 고정 IP 주소 범위가 할당됩니다. 범위 내 할당된 모든 IP 주소는 사용 가능하며 CIDR 표기법을 사용하지 않습니다. 기본적으로 계정에 대한 IP 범위를 사용하여 최대 10개의 다른 더 큰 실행기을(를) 구성할 수 있습니다. 고정 IP 주소 범위에서 10개 이상의 실행기를 사용하려면 GitHub 지원 포털 사용에 문의하세요.

할당된 범위에서 사용 가능한 IP 주소 수는 자동 크기 조정에 지정된 동시 작업 수를 제한하지 않습니다. 실행기 풀 내에는 할당된 범위에서 IP 주소를 많이 재사용할 수 있는 부하 분산 장치가 있습니다. 이렇게 하면 각 컴퓨터에 고정 IP 주소가 할당되는 동안 워크플로가 대규모로 동시에 실행될 수 있습니다.

조직 실행기용 고정 IP 주소 만들기

  1. GitHub에서 조직의 기본 페이지로 이동합니다.

  2. 조직 이름에서 설정을 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.

    조직 프로필에 있는 여러 탭의 스크린샷. "설정" 탭이 진한 주황색으로 표시됩니다.

  3. 왼쪽 사이드바에서 작업을 클릭한 다음 길행기를 클릭합니다.

  4. 실행기 목록에서 편집할 실행기를 선택합니다.

  5. 실행기에 고정 IP 주소를 할당하려면 "네트워킹"에서 실행기에 고유 및 고정 공용 IP 주소 범위 할당을 확인합니다.

  6. 저장을 클릭합니다.

엔터프라이즈 실행기용 고정 IP 주소 만들기

  1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음 엔터프라이즈를 클릭합니다.

  2. 엔터프라이즈 목록에서 보려는 엔터프라이즈를 클릭합니다.

  3. 페이지 왼쪽의 엔터프라이즈 계정 사이드바에서 정책을 클릭합니다.

  4. " 정책"에서 작업을 클릭합니다.

  5. 실행기 탭을 클릭합니다.

  6. 실행기 목록에서 편집할 실행기를 선택합니다.

  7. 실행기에 고정 IP 주소를 할당하려면 "네트워킹"에서 실행기에 고유 및 고정 공용 IP 주소 범위 할당을 확인합니다.

  8. 저장을 클릭합니다.