設定本機驗證

您必須先在環境中設定本機驗證，才能夠從系統存取或與代管存放區互動。

完成設定本機驗證後，您就可以存取您擁有適當角色與權限的代管存放區。您也可以執行標準 Git 作業，例如 git clone、git pull 和 git push。本機驗證不必在Google Cloud 主控台執行作業 (例如瀏覽存放區的內容)。

Cloud Source Repositories 支援下列類型的驗證：

使用 SSH 進行驗證

Cloud Source Repositories 可讓您使用 SSH 公開金鑰驗證存取代管存放區。在此情境下，首先要在您想存取存放區的本機系統上產生金鑰組。接著，您可以使用 Google Cloud註冊公開金鑰。如果您在系統上已經有 SSH 金鑰，您可以將這些金鑰重新用於驗證。每個 Google 帳戶最多可以註冊 20 個公開金鑰。

Cloud Source Repositories 支援三種 SSH 金鑰類型：

  • RSA (僅適用於超過 2048 位元的金鑰)
  • ECDSA
  • ED25519

產生金鑰組

SSH 金鑰組包含本機系統上的私密金鑰，以及您透過 Google Cloud註冊的公開金鑰。

Linux 或 macOS

  1. 確認您的本機系統已安裝 OpenSSH。

  2. 在命令提示字元中輸入下列指令：

    ssh-keygen -t [KEY_TYPE] -C "[USER_EMAIL]"

    其中：

    • [USER_EMAIL] 是你的電子郵件地址。
    • [KEY_TYPE] 可以是下列任一值：
      • rsa
      • ecdsa
      • ed25519

    例如：

    ssh-keygen -t rsa -C "user@example.com"

    1. 出現提示時，請輸入公開金鑰檔案的檔案名稱。如要接受預設的 ~/.ssh 位置，請按下 Enter 鍵，否則請指定檔案名稱。

    2. 出現提示時，請將通關密語留空，然後按下 Enter 鍵。

  3. 註冊金鑰

Windows

  1. 確認您的本機系統已安裝 PuTTY。

  2. 在 Windows「開始」功能表中啟動 PuTTYGen。

  3. 在隨即開啟的視窗中，於「Parameters」Parameters欄位選取金鑰類型。

  4. 點按「生成」。

    PuTTYGen 會顯示產生的公開金鑰字串。

  5. 指定通關密碼以保護金鑰組。

  6. 如要將產生的金鑰組儲存至本機系統，請按一下「Save Public Key」(儲存公開金鑰) 和「Save Private Key」(儲存私密金鑰)。

使用現有金鑰

您也可以將現有的金鑰組用於 SSH 驗證。

Linux 或 macOS

根據預設，公開金鑰檔案位於 ~/.ssh 目錄。

在命令提示字元中輸入下列指令：

ls -a ~/.ssh

預設檔案名稱為：

  • id_rsa.pub
  • id_ecdsa.pub
  • id_ed25519.pub

Windows

  1. 在 Windows「開始」功能表中啟動 PuTTYGen。

  2. 在隨即開啟的視窗中，按一下「載入」。

  3. 瀏覽本機檔案系統尋找您的公開金鑰檔案並選取該檔案。

    PuTTYGen 會顯示公開金鑰字串。如果您在儲存金鑰檔案時指定了通關密碼，則在您檢視公開金鑰之前，PuTTYGen 會先提示您輸入。

註冊公開金鑰

  1. 在 Google Cloud 控制台中，開啟「管理 SSH 金鑰」頁面。

    Open Cloud Source Repositories

  2. 按一下「註冊安全殼層金鑰」。

    系統會開啟「Register SSH Key」對話方塊。

  3. 在「Key name」欄位中，輸入金鑰的專屬名稱。

  4. 在「Key」欄位中，複製公開金鑰檔案中的金鑰字串。

  5. 按一下「註冊」。

完成設定 SSH 驗證後，您可以複製任何存放區 (只要您擁有必要角色與權限)，或將本機存放區的內容推送到空白代管存放區。

使用 gcloud CLI 進行驗證

Cloud Source Repositories 可讓您使用 gcloud CLI 進行驗證。在此情境中，您可於系統執行 gcloud init 指令設定本機驗證。

  1. 確認您的本機系統已安裝 gcloud CLI。

  2. 在命令提示字元中執行 gcloud init：

    gcloud init

  3. 按照畫面上的指示操作。

使用 gcloud CLI 設定驗證後，您可以使用標準 Git 指令與 Cloud Source Repositories 上的代管存放區互動。

使用手動產生的憑證進行驗證

您也可以將手動產生的憑證用於驗證。Cloud Source Repositories 提供一組指令碼，可讓您手動產生存取代管存放區所需的憑證。

  1. 前往「Configure Git」(設定 Git) 頁面產生憑證。

    前往「設定 Git」頁面

  2. 開啟終端機視窗。

  3. 輸入以下指令：

    git clone https://source.developers.google.com/p/PROJECT_ID/r/REPOSITORY_NAME

    其中：

    • PROJECT_ID 是您的專案名稱
    • REPOSITORY_NAME 是您的存放區名稱

使用手動產生的憑證完成設定驗證後，您可以使用標準 Git 指令與 Cloud Source Repositories 上的代管存放區互動。