GitHub Connect를 사용하여 GitHub.com 작업에 자동 액세스 사용

엔터프라이즈의 GitHub Actions에서 GitHub.com의 작업을 사용하도록 허용하려면 엔터프라이즈 인스턴스를 GitHub Enterprise Cloud에 연결할 수 있습니다.

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

Enterprise owners can enable access to public GitHub.com actions.

이 문서의 내용

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

GitHub.com 작업에 대한 자동 액세스 정보

기본적으로 GitHub Enterprise Server의 GitHub Actions 워크플로는 GitHub.com 또는 GitHub Marketplace의 작업을 직접 사용할 수 없습니다. 엔터프라이즈 인스턴스에서 GitHub.com의 모든 작업을 사용할 수 있도록 GitHub Connect를 사용하여 GitHub Enterprise Cloud와 GitHub Enterprise Server를 통합할 수 있습니다.

GitHub.com,의 작업을 사용하려면 GitHub Enterprise Server 및 모두 자체 호스트 실행기에서 GitHub.com에 아웃바운드 연결을 만들 수 있어야 합니다. GitHub.com의 인바운드 연결은 필요하지 않습니다. 자세한 정보. 자세한 내용은 "자체 호스트형 실행기 정보" 항목을 참조하세요.

또는 엔터프라이즈에서 허용되는 작업을 더 엄격하게 제어하려는 경우 actions-sync 도구를 사용하여 수동으로 작업을 다운로드하고 엔터프라이즈 인스턴스에 동기화할 수 있습니다. 자세한 내용은 "GitHub.com에서 수동으로 작업 동기화"을(를) 참조하세요.

GitHub Connect를 사용하는 작업 확인 정보

워크플로가 작업이 저장된 리포지토리를 참조하여 작업을 사용하는 경우 GitHub Actions는 먼저 GitHub Enterprise Server 인스턴스에서 리포지토리를 찾으려고 합니다. GitHub Enterprise Server 인스턴스에 리포지토리가 없는 경우 GitHub.com에 자동으로 액세스할 수 있는 경우 GitHub Actions는 GitHub.com에서 리포지토리를 찾으려고 합니다.

사용자가 GitHub.com의 조직 및 리포지토리 이름과 일치하는 조직 및 리포지토리를 엔터프라이즈에서 이미 만든 경우 엔터프라이즈 리포지토리가 GitHub.com 리포지토리 대신 사용됩니다. 자세한 내용은 “GitHub.com에서 액세스된 작업의 네임스페이스 사용 자동 중지”를 참조하세요.

일반 GitHub.com 작업에 대한 자동 액세스 사용

엔터프라이즈에서 GitHub.com의 일반 작업에 액세스할 수 있도록 설정하기 전에 다음을 수행해야 합니다.

  1. GitHub Enterprise Server의 오른쪽 위 모서리에서 프로필 사진과 엔터프라이즈 설정을 차례로 클릭합니다.

    GitHub Enterprise Server에서 프로필 사진 클릭할 때 나타나는 드롭다운 메뉴의 스크린샷 "엔터프라이즈 설정" 옵션이 진한 주황색 윤곽선으로 강조 표시됩니다.

  2. 엔터프라이즈 계정 사이드바에서 GitHub Connect 을(를) 클릭합니다.

  3. “사용자가 워크플로 실행에서 GitHub.com의 작업을 활용할 수 있음”에서 드롭다운 메뉴를 사용하여 사용을 선택합니다.

  4. GitHub Connect를 사용 설정한 후에는 정책을 사용하여 엔터프라이즈의 리포지토리에서 사용할 수 있는 퍼블릭 작업을 제한할 수 있습니다. 자세한 내용은 "엔터프라이즈에서 GitHub Actions에 대한 정책 적용"을(를) 참조하세요.

GitHub.com에서 액세스된 작업의 네임스페이스 사용 자동 중지

GitHub Connect를 사용하도록 설정할 때 사용자에게 표시되는 기존 워크플로에 대한 동작 변화는 없습니다. GitHub Actions가 GitHub Enterprise Server 인스턴스에서 각 작업을 검색한 후에 GitHub.com으로 대체되기 때문입니다. 이렇게 하면 엔터프라이즈에서 만든 사용자 지정 버전의 작업이 GitHub.com의 해당 작업 대신 사용됩니다.

GitHub.com에서 액세스된 작업의 네임스페이스 사용 자동 중지는 GitHub Enterprise Server 인스턴스에 액세스할 수 있는 악의적인 사용자의 중간자(man-in-the-middle) 공격 가능성을 차단합니다. GitHub.com의 작업을 처음으로 사용할 때 GitHub Enterprise Server 인스턴스에서 해당 네임스페이스가 사용 중지됩니다. 이렇게 하면 GitHub.com의 조직 및 리포지토리 이름과 일치하는 조직 및 리포지토리를 엔터프라이즈에서 만드는 모든 사용자가 차단됩니다. 따라서 워크플로를 실행할 때 의도한 작업이 항상 실행됩니다.

GitHub.com의 작업을 사용한 후 GitHub Enterprise Server 인스턴스에서 동일한 이름의 작업을 만들려는 경우 먼저 해당 조직 및 리포지토리의 네임스페이스를 사용할 수 있도록 설정해야 합니다.

  1. 페이지의 오른쪽 상단에 있는 GitHub Enterprise Server의 관리 계정에서 을 클릭합니다.

  2. “Site admin”(사이트 관리자) 페이지에 아직 없는 경우 왼쪽 상단에서 Site admin(사이트 관리자)을 클릭합니다.

  3. 왼쪽 사이드바의 사이트 관리자에서 사용 중지된 네임스페이스를 클릭합니다.

  4. GitHub Enterprise Server 인스턴스에서 사용할 네임스페이스의 오른쪽에서 사용 중지 취소를 클릭합니다.

  5. 관련 조직으로 이동하여 새 리포지토리를 만듭니다.

    팁: 네임스페이스 사용 중지를 취소하는 경우 항상 가능한 한 빨리 해당 이름으로 새 리포지토리를 만듭니다. 로컬 리포지토리를 만들기 전에 워크플로가 GitHub.com에서 연결된 작업을 호출하면 네임스페이스가 다시 사용 중지됩니다. 워크플로에서 사용된, 자주 실행되는 작업의 경우 로컬 리포지토리를 만들기 전에 네임스페이스가 다시 사용 중지된 것을 발견할 수도 있습니다. 이 경우, 새 리포지토리를 만들 때까지 관련 워크플로를 일시적으로 사용하지 않도록 설정할 수 있습니다.