對 GitHub 存放區進行鏡像作業

本主題說明如何將 GitHub 存放區鏡射到 Cloud Source Repositories。透過此設定，您推送至 GitHub 存放區的修訂版本會複製或建立鏡射到 Cloud Source Repositories 託管的存放區。

只有 Bitbucket Cloud 和 GitHub Cloud 存放區可以鏡像到 Cloud Source Repositories；系統不支援自託管 Bitbucket 和 GitHub 鏡像。

如果您將 GitHub 存放區鏡射到 Cloud Source Repositories，以便與 Cloud Build 整合，且不需要任何其他 Cloud Source Repositories 功能，請改為按照 Cloud Build 指示從 GitHub 建構存放區。

事前準備

複製存放區時，您必須提供 GitHub 驗證憑證。這些憑證可讓 Cloud Source Repositories 存取 GitHub 存放區的內容。

如果您使用的是 GitHub 組織，建議您採用自動化工作 (例如建立存放區鏡射) 專用的機器使用者帳戶。這個帳戶對您的存放區，必須具備管理員存取權。

對 GitHub 存放區建立鏡像

本節說明如何將 GitHub 存放區鏡射到 Cloud Source Repositories。

建立鏡像存放區

在這個程序中，您需要使用 GitHub 電腦使用者憑證，才能授予 GitHub 存放區的Google Cloud 讀取存取權。

  1. 在 Google Cloud 控制台中，開啟 Cloud Source Repositories。

    Open Cloud Source Repositories

  2. 按一下「新增存放區」。

    「Add a repository」(新增存放區) 頁面會隨即開啟。

  3. 選取「連結外部存放區」，然後按一下「繼續」。

    隨即會開啟「連結外部存放區」頁面。

  4. 在「Project」下拉式清單中，選取鏡像存放區所屬的 Google Cloud專案。

    如果您沒有專案，可以按一下「建立專案」建立專案。

  5. 在「Git 供應商」下拉式清單中，選取「GitHub」。

  6. 選取核取方塊，授權 Cloud Source Repositories 儲存您的憑證。

  7. 按一下 [Connect to GitHub] (連結至 GitHub)。

  8. 使用您的電腦使用者憑證登入 GitHub。

  9. 按一下 [Authorize GoogleCloudPlatform] (授權 GoogleCloudPlatform)。

    這個選項會授予 Google Cloud 對 GitHub 使用者帳戶中所有存放區的讀取存取權。

    驗證完成後，您會返回「連結外部存放區」頁面。此時會開啟存放區清單。

  10. 從存放區清單中選取要鏡射的存放區。

  11. 按一下 [Connect Selected Repository] (連結所選存放區)。

    主要存放區頁面會隨即開啟。這個頁面包含本 Google Cloud 專案的存放區清單，包括您剛才建立的新存放區。

識別 GitHub 存放區

Cloud Source Repositories 可讓您清楚識別哪些存放區是 GitHub 存放區的鏡像：

  • 每個 GitHub 存放區都會以 GitHub 標誌表示。
  • 存放區的名稱會在開頭加上 github_。

強制存放區同步處理

設定鏡射之後，每當使用者修訂變更，Cloud Source Repositories 即會自動同步處理您的存放區與鏡射存放區。Cloud Source Repositories 可讓您查看鏡像存放區上次同步處理的時間，讓您視需要手動強制同步處理。

  1. 在 Google Cloud 主控台中，瀏覽已建立鏡像的 GitHub 存放區。

  2. 按一下「設定」圖示 。

    系統會顯示同步處理狀態。

    鏡射存放區同步處理狀態

  3. 如要手動強制同步處理存放區，請按一下「Sync from GitHub」。