對 Bitbucket 存放區進行鏡像作業

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

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

如果您是將 Bitbucket 存放區複製到 Cloud Source Repositories，以便與 Cloud Build 整合，且不需要任何其他 Cloud Source Repositories 功能，請改為按照從 Bitbucket Cloud 建構存放區的 Cloud Build 指示操作。

事前準備

為存放區建立鏡射，您必須提供 Bitbucket 驗證憑證。這些憑證可讓 Cloud Source Repositories 存取 Bitbucket 存放區的內容。

建議您建立 Bitbucket 帳戶以專用於自動化工作，例如為存放區建立鏡射。這個帳戶必須具備您存放區的管理員存取權。

鏡像 Bitbucket 存放區

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

建立鏡像存放區

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

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

    開啟 Cloud Source Repositories

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

    「新增存放區」頁面隨即開啟。

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

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

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

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

  5. 在「Git provider」(Git 供應商) 下拉式清單中，選取「Bitbucket」。

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

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

  8. 使用電腦使用者憑證登入 Bitbucket。

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

    此選項會授予存放區的 Google Cloud 讀取權限。

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

  10. 在「Bitbucket Repository URL」(Bitbucket 存放區網址) 欄位中，輸入存放區網址，格式如下：

    https://bitbucket.org/repositories/BITBUCKET_ORGANIZATION/BITBUCKET_REPOSITORY

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

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

識別 Bitbucket 存放區

Cloud Source Repositories 會清楚標示哪些存放區是 Bitbucket 存放區的鏡像：

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

升級 Bitbucket 連線

如果您是使用先前的Google Cloud 主控台介面建立 Bitbucket 存放區的鏡射，在您於目前的Google Cloud 主控台存取已建立鏡射的存放區時，Cloud Source Repositories 會提示您升級。在升級完成前，每次存取存放區時都會看到這些提示。

您必須擁有原始碼存放區管理員角色，才能升級連線。升級連線不會變更 Bitbucket 存放區的建立鏡射行為。

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

    開啟 Cloud Source Repositories

  2. 前往已建立鏡射的 Bitbucket 存放區。

  3. 出現提示時，按一下 [Upgrade Credentials] (升級憑證) 來升級您的連線。

強制同步處理存放區

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

  1. 在 Google Cloud 控制台中，瀏覽至已建立鏡射的 Bitbucket 存放區。

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

    系統會顯示同步狀態。

    鏡射存放區同步處理狀態

  3. 如要手動強制同步處理存放區，請按一下「Sync from Bitbucket」(與 Bitbucket 保持同步)。