GitHub 저장소에 연결

이 페이지에서는 GitHub 저장소를 Cloud Build에 연결하는 방법을 설명합니다. Cloud Build 저장소에 대한 자세한 내용은 Cloud Build 저장소를 참조하세요.

시작하기 전에

  • Enable the Cloud Build API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  • 소스 코드를 GitHub 저장소에 준비합니다.
  • GitHub 소스 저장소에 Dockerfile 또는 Cloud Build 구성 파일이 있습니다.
  • 저장소를 처음으로 Cloud Build에 연결하는 경우 저장소에 관리자 수준 권한이 있는지 확인합니다. GitHub 저장소 권한에 대한 자세한 내용은 조직의 저장소 권한 수준을 참조하세요.

  • 이 페이지에서 gcloud 명령어를 사용하려면 Google Cloud CLI를 설치합니다.

GitHub 저장소에 연결

GitHub 저장소를 Cloud Build에 연결하려면 다음 안내를 따르세요.

  1. Google Cloud 콘솔에서 저장소 페이지를 엽니다.

    저장소 페이지 열기

  2. 상단 표시줄의 프로젝트 선택기에서 Google Cloud 프로젝트를 선택합니다.

  3. 페이지 상단에서 1세대 탭을 선택합니다.

  4. 저장소 연결을 클릭합니다.

    저장소 연결 패널이 표시됩니다.

    1. 소스 코드 관리 제공업체 선택에서 GitHub Cloud Build GitHub 앱을 선택합니다.

    2. 계속을 클릭합니다.

      GitHub에 연결을 인증하거나 GitHub 앱을 설치하라는 메시지가 표시될 수 있습니다. 아직 작업을 수행하지 않았으면 다음 단계를 완료합니다.

      1. GitHub에 아직 로그인하지 않았다면 지금 로그인하세요.

        Google Cloud Build 앱을 Google Cloud에 연결하도록 승인하는 승인 페이지가 표시됩니다.

        승인 버튼의 스크린샷

      2. GoogleCloudBuild로 Google Cloud Build 승인을 클릭합니다.

      3. Google Cloud Build 설치를 클릭합니다.

      4. 대화상자가 표시되면 GitHub 사용자 이름 또는 조직을 선택합니다.

      5. 비즈니스 요구사항에 따라 다음 옵션 중 하나를 선택합니다.

        • 모든 저장소 - Cloud Build 앱을 사용하여 액세스할 수 있도록 현재와 미래의 GitHub 저장소를 사용 설정합니다.

        • 특정 저장소만 - 저장소 선택 드롭다운에서 Cloud Build 앱을 사용하여 액세스할 특정 저장소만 사용 설정합니다.

        나중에 추가 저장소를 사용 설정할 수 있습니다. 모든 저장소를 옵션으로 선택하면 Cloud Build 앱이 모든 저장소에 액세스할 수 있습니다. 그러나 이 섹션에 설명된 단계에 따라 각 새 저장소를 Cloud Build를 통해 연결해야 합니다.

      6. 설치를 클릭하여 Cloud Build 앱을 설치합니다.

        대화상자가 닫히고 저장소 페이지가 표시됩니다.

    3. 저장소 선택 섹션에서 다음 필드를 선택합니다.

      • GitHub 계정: Cloud Build GitHub 앱을 설치하는 데 사용되는 GitHub 계정입니다. 이 필드는 미리 선택되어 있을 수 있습니다.

      • 저장소: Cloud Build에 연결할 저장소

      대상 저장소가 하나 이상 표시되지 않으면 GitHub에서 저장소 수정을 클릭하여 Cloud Build GitHub 앱에서 추가 저장소를 사용 설정합니다. 그런 다음 저장소 선택 섹션에서 새 대상 저장소를 선택할 수 있습니다.

    4. GitHub 계정 및 저장소를 선택한 후 동의 면책조항을 읽고 그 옆에 있는 체크박스를 선택하여 표시된 약관에 동의합니다.

    5. 연결을 클릭합니다.

    6. (선택사항) 트리거 만들기 섹션의 이 저장소의 샘플 트리거 만들기 필드에서 트리거를 만들 저장소를 선택합니다. 저장소를 선택한 후 트리거 만들기를 클릭합니다.

    7. 완료를 클릭합니다.

(선택항목) 인증된 GitHub 계정 업데이트

Google 계정과 연결된 GitHub 계정을 업데이트해야 하는 경우 GitHub 페이지로 인증으로 이동합니다. GitHub에 Cloud Build 앱을 설치한 후 Cloud Build 저장소 연결 페이지에 GitHub 앱이 저장소에 설치되지 않았다고 나타나는 경우 이 작업을 수행해야 할 수 있습니다.

다음 단계