連結至 GitHub Enterprise 存放區

第 1 代 第 2 代

本頁說明如何將 GitHub Enterprise 存放區連結至 Cloud Build。如要進一步瞭解 Cloud Build 存放區，請參閱「Cloud Build 存放區」。

事前準備

• Enable the Cloud Build and Secret Manager APIs.

  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 APIs

• 按照指示連結 GitHub Enterprise 主機。
• 請確認您在要啟用 GitHub Enterprise 觸發條件的存放區中，具備管理員存取權。

連線至 GitHub Enterprise 存放區

主控台

如要將 GitHub Enterprise 存放區連結至主機連線，請完成下列步驟：

1. 在 Google Cloud 控制台中開啟「Repositories」(存放區) 頁面。

   開啟「Repositories」(存放區) 頁面

   畫面會顯示「Repositories」(存放區) 頁面。

2. 選取頁面頂端的「第 2 代」分頁標籤。

3. 按一下「連結存放區」，連結連線中的存放區。

   畫面上會顯示「連結存放區」面板。

4. 在「連結存放區」面板中，輸入下列資訊：

   1. 連線：從下拉式選單中選取連線。

   2. 存放區：選取要連結至連線的存放區。

   3. 存放區名稱：輸入存放區的名稱。

      1. 產生：選取這個選項後，Cloud Build 會自動為所選存放區產生存放區名稱。

      2. 手動：選取這個選項，即可為所選存放區手動指定名稱。

         如果選取「手動」，您可以在「存放區名稱」部分修改所選存放區的名稱。

      注意： 如果您是協作者，必須擁有 GitHub 管理員權限，才能查看存放區。

5. 按一下「連結」，將存放區連結至連線。

您現在已成功將 GitHub Enterprise 存放區連結至連線。

gcloud

如要將 GitHub Enterprise 存放區新增至連線，請輸入下列指令：

   gcloud builds repositories create REPO_NAME \
     --remote-uri=REPO_URI \
     --connection=CONNECTION_NAME --region=REGION

其中：

• REPO_NAME 是存放區的名稱。
• REPO_URI 是 GitHub 存放區的連結。
• CONNECTION_NAME 是在「連結至 GitHub Enterprise 主機」中，於 Cloud Build 建立的 GitHub Enterprise 主機連線名稱。
• REGION 是連線的區域。

注意： 如果您是協作者，必須在 GitHub 中具備管理員權限，才能連結至存放區。

Terraform

如要將 GitHub Enterprise 存放區新增至連線，請將下列程式碼片段新增至 Terraform 設定：

    resource "google_cloudbuildv2_repository" "my-repository" {
      project = "PROJECT_ID"
      name = "REPO_NAME"
      location = :REGION"
      parent_connection = google_cloudbuildv2_connection.my-connection.name
      remote_uri = "REMOTE_URI'
  }

其中：

• PROJECT_ID 是您的 Google Cloud 專案 ID。
• REPO_NAME 是 GitHub 存放區的名稱。
• REGION 是連線的區域。
• URI 是存放區的遠端 URI。例如：https://github.com/myuser/myrepo.git。

注意： 如果您是協作者，必須在 GitHub 中具備管理員權限，才能連結至存放區。

後續步驟

• 瞭解如何從 GitHub Enterprise 建構存放區。
• 瞭解如何在私人網路中透過 GitHub Enterprise 建構存放區。
• 瞭解如何在 Compute Engine 上執行藍綠部署。
• 瞭解如何指定其他存放區做為建構作業的依附元件。