GitHub 연결

AWS DevOps 에이전트 관리 콘솔에 액세스할 수 있습니다.

관리자 권한이 있는 GitHub 사용자 계정 또는 조직이 있습니다.

앱 등록의 경우 계정 또는 조직에 GitHub 앱을 설치할 수 있는 권한이 있습니다.

개인 액세스 토큰 등록의 경우 개인 액세스 토큰 생성에 설명된 권한이 있는 개인 액세스 토큰이 있습니다.

HTTPS를 통해 액세스할 수 있는 GitHub Enterprise Server 인스턴스(버전 3.x 이상)가 있습니다.

GitHub Enterprise Server 인스턴스의 HTTPS URL이 있습니다(예: https://github.example.com).

(선택 사항) GitHub Enterprise Server 인스턴스에 공개적으로 액세스할 수 없는 경우 프라이빗 연결이 있습니다.

전용 *.ghe.com 하위 도메인에서 호스팅되는 데이터 레지던시가 활성화된 GitHub Enterprise Cloud 조직이 있습니다.

GitHub 앱을 생성하고 설치할 수 있는 권한을 포함하여 조직 관리자 권한이 있습니다.

데이터 레지던시 인스턴스의 HTTPS URL이 있습니다(예: https://octocorp.ghe.com).

앱 등록(권장) - 계정 또는 조직에 AWS DevOps 에이전트 GitHub 앱을 설치합니다. GitHub 앱은 웹후크와 세분화된 권한을 지원합니다. 3단계를 계속합니다.

개인 액세스 토큰 - GitHub 계정의 개인 액세스 토큰으로 인증합니다. 이 옵션은 개별 액세스를 제공하며 웹후크를 지원하지 않습니다. 이 섹션의 나머지 단계를 건너뛰고 개인 액세스 토큰으로 GitHub 등록을 참조하세요.

사용자 - 사용자 이름과 프로필이 있는 개인 GitHub 계정

조직 - 여러 사람이 여러 프로젝트에서 한 번에 협업할 수 있는 공유 GitHub 계정입니다. 조직을 선택하는 경우 GitHub 조직 이름을 입력합니다. 다음 단계에서 해당 조직에 앱을 승인하고 설치해야 하므로 이름은 GitHub 조직 이름과 정확히 일치해야 합니다.

읽기 및 쓰기(기본값): GitHub 앱은 읽기 및 쓰기 권한을 모두 요청합니다. 이렇게 하면 모든 기능이 활성화됩니다. DevOps Agent는 인라인 풀 요청 설명을 게시하고, 수정 사항을 제안하고, 워크플로를 트리거할 수 있습니다.

읽기 전용: GitHub 앱은 읽기 권한만 요청합니다. DevOps Agent는 코드 및 풀 요청을 볼 수 있지만 설명을 게시하거나 수정 사항을 제안하거나 워크플로를 트리거할 수는 없습니다.

브라우저 기반 콜백(기본값) - 제출을 선택하면 AWS DevOps 에이전트가 사용자를 GitHub로 리디렉션하여 GitHub 앱을 승인하고 필요한 경우 설치합니다. 4단계를 계속합니다.

개인 액세스 토큰으로 확인 - 개인 액세스 토큰을 입력합니다. AWS DevOps Agent는 토큰을 한 번 사용하여 지정한 계정 또는 조직에 GitHub 앱이 설치되어 있는지 확인한 다음 폐기합니다. 토큰은 저장되지 않습니다. 제출을 선택하면 등록이 완료되고 GitHub로 리디렉션되지 않습니다.

조직의 경우 토큰 소유자가 조직 소유자여야 합니다. 토큰에는 조직 읽기 권한도 필요합니다. 클래식 토큰의 경우 read:org 범위를 사용합니다. 세분화된 토큰의 경우 관리: 읽기 전용 조직 권한을 사용합니다.

개인 계정의 경우 토큰에 추가 범위가 필요하지 않습니다.

웹후크 없음 - GitHub는 개인 액세스 토큰 등록에 웹후크 이벤트를 보내지 않습니다. AWS DevOps Agent는 풀 요청, 푸시 또는 배포 알림과 같은 실시간 이벤트를 수신하지 않습니다. 자동 릴리스 준비 코드 검토 및 자동 확인 테스트는 개인 액세스 토큰 등록을 통해 연결된 리포지토리에 대해 트리거되지 않습니다. DevOps 에이전트 채팅 또는 코딩 에이전트 통합을 통해 릴리스 준비 코드 검토를 요청할 수 있습니다. 자세한 내용은 릴리스 준비 상태 코드 검토 단원을 참조하십시오. 실시간 이벤트가 필요한 경우 앱 등록을 사용합니다.

리포지토리 액세스는 토큰을 따릅니다 - 조직에 대한 등록 범위를 지정할 때 AWS DevOps 에이전트는 토큰이 액세스할 수 있는 해당 조직의 리포지토리를 나열합니다. 토큰 소유자의 개인 계정을 연결하면 AWS DevOps 에이전트는 토큰 소유자가 소유한 리포지토리만 나열합니다. 에이전트는 토큰이 허용하는 작업만 수행할 수 있습니다.

토큰 업데이트 없음 - 기존 GitHub 등록의 토큰을 업데이트할 수 없습니다. 만료되거나 교체된 토큰을 교체하려면 등록을 취소하고 GitHub를 새 토큰으로 다시 등록합니다. 그런 다음 리포지토리를 에이전트 스페이스에 다시 연결합니다.

repo - 리포지토리 콘텐츠 및 메타데이터를 읽는 데 필요합니다.

read:org - 조직에 대한 등록 범위를 지정할 때 필요합니다. AWS DevOps 에이전트는 이를 사용하여 토큰 소유자가 조직의 활성 멤버인지 확인합니다.

조직에 대한 등록 범위를 지정하는 경우 리소스 소유자를 해당 조직으로 설정합니다. AWS DevOps 에이전트가 액세스할 수 있는 리포지토리를 선택합니다.

리포지토리 권한에서 콘텐츠: 읽기 전용 및 메타데이터: 읽기 전용을 부여합니다.

조직 권한에서 조직에 대한 등록 범위를 지정할 때 멤버: 읽기 전용 권한을 부여합니다.

Invalid GitHub personal access token - 토큰이 유효하지 않거나 만료되었습니다. 새 토큰을 생성하고 다시 시도하세요.

GitHub personal access token does not have sufficient permissions - 클래식 토큰에 repo 범위를 추가하거나 세분화된 토큰과 함께 사용하려는 리포지토리에 대한 읽기 액세스 권한을 부여합니다.

The GitHub token's user is not a member of organization "<name>" - 조직 이름을 확인합니다. 토큰에 read:org 범위(클래식) 또는 조직 구성원 읽기 액세스(세분화)가 있는지 확인합니다.

membership in organization "<name>" is "<state>", not active - 토큰 소유자에게 조직에 대한 보류 중인 초대가 있습니다. 초대를 수락하고 다시 시도하세요.

Failed to reach GitHub - GitHub Enterprise URL과 네트워크 구성을 확인합니다. 프라이빗 연결은 섹션을 참조하세요프라이빗 연결 문제 해결.

A GitHub service for "<owner>" is already registered with this account - AWS 계정에 이미이 GitHub 계정 또는 조직에 대한 등록이 있습니다. 기존 등록을 사용하거나 먼저 등록을 취소합니다.

The DevOps Agent GitHub App is not installed on the requested organization or account - 먼저 브라우저 기반 콜백에 등록하여 GitHub 앱을 설치한 다음 다시 시도하세요.

You do not have permission to install or access the DevOps Agent GitHub App on this organization - 조직에 대한 소유자(관리자) 권한이 있는 GitHub 계정을 사용합니다.

GitHub App verification is only supported for github.com - 데이터 레지던시가 있는 GitHub Enterprise Server 및 GitHub Enterprise Cloud의 경우 브라우저 기반 콜백을 사용합니다.

기능 - 각 리포지토리에 대한 코드 검토 및 자동 테스트 기능을 선택합니다. 이 섹션에서는 두 가지 리포지토리별 설정을 제공합니다.

리포지토리 목록 - 연결 단계에서 선택한 모든 리포지토리를 표시합니다. 검색 필드를 사용하여 리포지토리를 이름으로 필터링합니다. 각 리포지토리에는 두 기능에 대한 독립적인 확인란이 있습니다.

런타임 역할(선택 사항) - 선택한 리포지토리에서 자동화된 기능을 실행하기 위해 DevOps 에이전트가 수임하는 IAM 역할을 선택합니다. 이 역할은 프라이빗 패키지 레지스트리 및 아티팩트 스토리지 시스템과 같은 빌드 중에 필요한 내부 서비스에 액세스할 때 사용됩니다. 기본 에이전트 역할과 다른 역할을 사용하는 것이 좋습니다.

대상 브랜치(필수) - 정규식(예: 또는 )으로 입력된 하나 이상의 브랜치 이름 main 또는 패턴입니다release/.*. 풀 요청의 대상(기본) 브랜치가 이러한 패턴 중 하나와 일치하는 경우에만 검토가 트리거됩니다.

트리거 이벤트(선택 사항) - 검토를 트리거하는 풀 요청 이벤트: 풀 요청을 검토할 준비가 되었거나 풀 요청 초안이 작성되었습니다. 해당하는 모든 이벤트와 일치하도록 비워 둡니다.

리포지토리에 대한 액세스 요청 - GitHub 앱 설치 중에 특정 권한을 검토할 수 있습니다.

배포 이벤트 및 기타 리포지토리 이벤트를 수신합니다.

코드 변경 사항을 운영 인시던트와 연관시킬 수 있는 Allow AWS DevOps Agent

GitHub 설정을 통해 언제든지 제거할 수 있습니다.

리포지토리 액세스 업데이트 - GitHub 앱이 액세스할 수 있는 리포지토리를 변경하려면 GitHub 계정 또는 조직 설정으로 이동합니다. 데이터 레지던시가 있는 GitHub Enterprise Server 또는 GitHub Enterprise Cloud의 경우 인스턴스 설정으로 이동합니다. 그런 다음 설치된 GitHub 앱으로 이동하여 AWS DevOps 에이전트 앱 구성을 수정합니다.

연결된 리포지토리 보기 - AWS DevOps 에이전트 콘솔에서 에이전트 스페이스를 선택하고 기능 탭으로 이동하여 파이프라인 섹션에서 연결된 리포지토리를 봅니다.

개인 액세스 토큰 교체 - 기존 GitHub 등록의 토큰을 업데이트할 수 없습니다. 토큰을 교체하려면 기능 공급자 페이지에서 등록을 취소합니다. 그런 다음 새 토큰으로 GitHub를 다시 등록하고 리포지토리를 에이전트 스페이스에 다시 연결합니다. GitHub 설정에서 이전 토큰을 취소합니다.

GitHub 연결 제거 - 에이전트 공간에서 GitHub를 연결 해제하려면 파이프라인 섹션에서 연결을 선택한 다음 제거를 선택합니다. 계정에서 GitHub 등록을 제거하려면 기능 공급자 페이지로 이동하여 GitHub 섹션에서 등록을 찾은 다음 등록 취소를 선택합니다.

GitHub 앱을 제거하려면 GitHub 계정 또는 조직 설정으로 이동합니다.

다시 연결하려면 AWS DevOps 에이전트 콘솔에서 GitHub를 다시 등록합니다.

앱 제거 - 설정 > 애플리케이션 > 설치된 GitHub 앱으로 이동하여 앱에서 구성을 선택한 다음 제거합니다.

앱 삭제 - 설정 > 개발자 설정 > GitHub 앱으로 이동하여 앱을 선택하고 고급 탭으로 이동한 다음 GitHub 앱 삭제를 선택합니다. 경고: GitHub 앱 삭제는 영구적이며 실행 취소할 수 없습니다. 새 앱을 생성하려면 AWS DevOps 에이전트 콘솔에서 GitHub를 다시 등록합니다.