安裝 Google Cloud CLI

按照本指南的操作說明操作前，請先參閱「設定 Cloud de Confiance的 Google Cloud CLI」。

本快速入門導覽課程說明安裝及初始化 Google Cloud CLI 的建議方法。初始化後，請執行幾個核心 gcloud CLI 指令，查看安裝資訊並確認安裝成功。

事前準備

  1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Cloud de Confiance project.

安裝 gcloud CLI 590.0.0 版

Linux
  1. 確認您使用的是支援的 Python 版本。Google Cloud CLI 須使用 Python 3.10 至 3.15。x86_64 Linux 套件包含一個 Python 解譯器，預設會優先使用。如要瞭解如何選擇及設定 Python 解譯器，請參閱 gcloud topic startup 說明文件。
  2. 下載下列其中一項：
    平台 套件名稱 大小 SHA256 核對和
    Linux 64 位元

    (x86_64)

    		 google-cloud-cli-linux-x86_64.tar.gz 94.0 MB 351ed4a2812c5525c1cee00334257a42c020fcaffa27d3067c1eec0a618dd83f
    Linux 64 位元

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 54.4 MB dc3ad610faefe6f9d2e4472affe1db71836315f43ab3a3747221eb7595b431cb
    Linux 32 位元

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 54.4 MB 704d32be816d1aef1250721e52fc2d9e0802eab6eac513aef97db4c7ace19b2b

    如要下載 Linux 封存檔案，請執行下列指令： 

    curl -O https://storage.s3nsapis.fr/cloud-sdk-release/google-cloud-cli-linux-x86_64.tar.gz

    請參閱上表，並將 google-cloud-cli-linux-x86_64.tar.gz 替換為適用於您設定的 *.tar.gz 套件名稱。

  3. 如要將檔案內容擷取至檔案系統，請執行下列指令： 
    tar -xf google-cloud-cli-linux-x86_64.tar.gz
     如要取代現有安裝，請刪除現有的 google-cloud-sdk 目錄，然後將封存檔解壓縮至相同位置。
  4. 從解壓縮資料夾的根目錄執行安裝指令碼：
    ./google-cloud-sdk/install.sh
     指令碼會提示您執行下列設定動作。如要接受，請在系統提示時回答「Y」。
    • 將 gcloud CLI 新增至 PATH。
    • 啟用指令自動完成功能。
    • 選擇加入傳送匿名使用統計資料，協助改善 gcloud CLI。
    您也可以提供旗標，以非互動方式執行安裝作業。 如要查看可用的旗標，請執行：
    ./google-cloud-sdk/install.sh --help
  5. 選用：如果您在上一個步驟中更新了 PATH，請開啟新的終端機，讓變更生效。
macOS
  1. 確認您使用的是支援的 Python 版本。Google Cloud CLI 必須使用 Python 3.10 至 3.15。

    如要檢查 Python 版本，請執行 python3 -V 或 python -V。

    gcloud 安裝程式預設會安裝 Python 3.14 版和必要的擴充功能模組。

    如要進一步瞭解如何設定 Python 直譯器，請參閱 gcloud topic startup 說明文件。

  2. 下載下列其中一項：
    平台 套件 大小 SHA256 核對和
    macOS 64 位元

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz 54.5 MB 9ff4e7c7fa49eca2e61af3d6ba31735ed08f90e5fae503d19d4c1c520f818736
    macOS 64 位元

    (ARM64, Apple silicon)

    		 google-cloud-cli-darwin-arm.tar.gz 54.4 MB b1f80ffe9cc970ff1935b4adfddd0fb89d7e7b3341a88d70216d4283211b8d2d
    macOS 32 位元

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 52.9 MB b2da028700b7af4ebc2364fc59398921a3c2d67f91fe63d3a7a42648a54eb6ab

    或者，您也可以透過指令列下載封存檔。 將 FILE_NAME 替換為上表中的平台套件名稱。

    curl -O https://storage.s3nsapis.fr/cloud-sdk-release/FILE_NAME
  3. 將檔案內容擷取至檔案系統中的偏好位置。常見做法是將其解壓縮到主目錄。

    在 macOS 上，您可以在偏好的位置開啟下載的 .tar.gz 檔案。或者，您也可以從指令列執行： 

    tar -xf FILE_NAME

    如要取代現有安裝項目，請刪除現有的 google-cloud-sdk 目錄，然後將封存檔解壓縮至相同位置。

  4. 從解壓縮資料夾的根目錄執行安裝指令碼：
    ./google-cloud-sdk/install.sh
     指令碼會提示您執行下列設定動作。如要接受，請在系統提示時回答「Y」。
    • 視需要安裝 Python 3.14 和建議的模組。
    • 將 gcloud CLI 新增至 PATH，並啟用指令自動完成功能。
    • 選擇加入傳送匿名使用統計資料，協助改善 gcloud CLI。
    您也可以提供旗標，以非互動方式執行安裝作業。 如要查看可用的旗標，請執行：
    ./google-cloud-sdk/install.sh --help
     如要在啟用螢幕閱讀器模式的情況下執行安裝指令碼，請按照下列步驟操作： 
    ./google-cloud-sdk/install.sh --screen-reader=true
  5. 選用：如果您在上一個步驟中更新了 PATH，請開啟新的終端機，讓變更生效。
Windows

如要在 Windows 使用 Google Cloud CLI，必須安裝 Windows 8.1 以上版本，或 Windows Server 2012 以上版本。

  1. 下載 Google Cloud CLI 安裝程式。

    或者，您也可以開啟 PowerShell 終端機，並執行下列 PowerShell 指令： 

    (New-Object Net.WebClient).DownloadFile("https://storage.s3nsapis.fr/cloud-sdk-release/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")

& $env:Temp\GoogleCloudSDKInstaller.exe

  2. 啟動安裝程式並按照提示操作。這個安裝程式是由 Google LLC 簽署。

    • 如果你使用螢幕閱讀器，請勾選「開啟螢幕閱讀器模式」核取方塊。這個選項會將 gcloud 設為使用狀態追蹤器 (而非 Unicode 旋轉圖示)、以百分比顯示進度，以及簡化表格。詳情請參閱無障礙功能指南。
    • Google Cloud CLI 需要 Python，支援的版本為 Python 3.10 至 3.15。根據預設，Windows 版 Google Cloud CLI 隨附 Python 3。如要使用 Google Cloud CLI，您的作業系統必須能執行支援的 Python 版本。
    • 安裝程式會安裝所有必要的依附元件，包括所需的 Python 版本。 雖然 Google Cloud CLI 預設會安裝及管理 Python 3，但如有需要，您可以取消勾選「Install Bundled Python」(安裝隨附的 Python) 選項，使用現有的 Python 安裝。請參閱 gcloud topic startup，瞭解如何使用現有的 Python 安裝。

  3. 安裝完成後，安裝程式會提供建立「開始」選單和桌面捷徑，以及啟動 Google Cloud CLI 殼層的選項。取消勾選啟動殼層的選項。您將在後續步驟中執行及設定 gcloud CLI。

疑難排解提示

  • 如果因系統無法辨識 find 指令而導致安裝失敗，請確認 PATH 環境變數已設為包含 find 的資料夾。通常是 C:\WINDOWS\system32;。
  • 如果您已解除安裝 gcloud CLI，必須先重新啟動系統，才能再次安裝 gcloud CLI。
  • 如果解壓縮失敗，請以管理員身分執行安裝程式。

初始化 gcloud CLI 並授權

如果您位於 Proxy 或防火牆後方，請參閱「Proxy 設定」，瞭解如何為 gcloud CLI 啟用網路存取權。

安裝 gcloud CLI 後，請初始化該 CLI，授權存取 Cloud de Confiance 並設定預設設定。如要瞭解詳情，請參閱 gcloud init。

  1. 執行 gcloud init，初始化 gcloud CLI：

    gcloud init

    根據預設，這個指令會開啟網路瀏覽器來授權存取權。如要改為透過指令列授權，請新增 --console-only 旗標。如要進行非互動式授權，請在 Cloud de Confiance 控制台中建立具有適當範圍的服務帳戶，然後使用 gcloud auth activate-service-account 搭配其 JSON 金鑰檔案。

  2. 按照提示授權及設定：

    • 系統提示登入時，請接受並在瀏覽器中登入 Google 帳戶。按一下「Allow」(允許)，授予資源存取權。

    • 從您具備擁有者、編輯者或檢視者權限的專案清單中，選取所需專案。如果您只有一項專案，gcloud init 會自動選取。

      如果專案數量超過 200 個，系統會提示您輸入專案 ID、建立專案或列出專案。如果選擇建立專案，也必須啟用計費功能。

    • 如果您已啟用 Compute Engine API，請選取預設的 Compute Engine 可用區。

  3. 選用：如要提升螢幕閱讀器體驗，請使用下列指令啟用 accessibility/screen_reader 屬性：

    gcloud config set accessibility/screen_reader true

    詳情請參閱「啟用無障礙功能」指南。

執行核心指令

執行核心指令，查看 gcloud CLI 安裝作業的相關資訊：

  1. 列出憑證儲存在本機系統的帳戶：

    gcloud auth list

    gcloud CLI 會顯示已儲存憑證的帳戶清單：

    Credentialed Accounts
ACTIVE             ACCOUNT
*                  principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com

  2. 列出 gcloud CLI 有效設定中的屬性：

    gcloud config list

    gcloud CLI 會顯示屬性清單：

    [core]
account = principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com
disable_usage_reporting = False
project = my-project

  3. 查看 gcloud 指令和其他主題的相關資訊：

    gcloud help

    舉例來說，如要查看 gcloud compute instances create 的說明，請執行以下指令：

    gcloud help compute instances create

    gcloud CLI 會顯示說明主題，其中包含指令說明、指令旗標和引數清單，以及指令使用範例。

選用：安裝其他元件

如要安裝其他元件，例如 App Engine 模擬器、kubectl，或 Alpha 或 Beta 版級別的 gcloud CLI 指令，請參閱「管理 gcloud CLI 元件」。

後續步驟

  • 請參閱 gcloud CLI 指南，瞭解 gcloud CLI 的概況，包括重要概念、指令慣例和實用提示。
  • 請參閱 gcloud CLI 參考指南，瞭解各個 gcloud CLI 指令的詳細頁面，包括說明、旗標和範例，可用於在 Cloud de Confiance上執行各種工作。
  • 如要查看常用指令和重要概念的清單，請參閱 gcloud CLI 一覽表。