安裝 gcloud CLI

本頁說明如何選擇及維護 Google Cloud CLI 安裝項目。Google Cloud CLI 包含 gcloud、gsutil 和 bq 指令列工具。如需 gcloud CLI 功能清單，請參閱「所有功能」。

如要使用支援的程式設計語言存取 Google Cloud API，可以下載 Cloud 用戶端程式庫。

安裝操作說明

以下操作說明適用於安裝 Google Cloud CLI。如要瞭解如何安裝其他元件，例如 Alpha 版或 Beta 版層級的 gcloud CLI 指令，請參閱「管理 gcloud CLI 元件」。

Linux
  1. 確認您使用的是支援的 Python 版本。Google Cloud CLI 需要 Python 3.9 至 3.14。請注意，x86_64 Linux 套件包含預設會優先使用的 Python 解譯器。如要瞭解如何選擇及設定 Python 解譯器，請參閱 gcloud topic startup。
  2. 下載下列其中一個檔案：
    平台 套件名稱 大小 SHA256 總和檢查碼
    Linux 64 位元

    (x86_64)

    		 google-cloud-cli-linux-x86_64.tar.gz 150.5 MB 31000673c1f9e18ec7b38823748031c58949cb0479d36ede999ae8cad6097ae3
    Linux 64 位元

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 57.1 MB a1c1a88274e8bf11561771b9373b566cbb044f1cb3884e454625ec9449ea33f2
    Linux 32 位元

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 57.1 MB 32ff2bea65cd5c79aa86b948219c1e861a0434cc99011f4d977c4a9810e595de

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

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/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. (選用) 將 gcloud CLI 新增至 PATH。 您也可以選擇為殼層啟用指令補齊功能，並收集使用統計資料。使用下列指令執行安裝指令碼 (來自您在上一步驟中解壓縮的資料夾根目錄)： 
    ./google-cloud-sdk/install.sh
     您也可以非互動式地執行這項操作 (例如使用指令碼)，並以旗標形式提供偏好設定。如要查看可用旗標，請執行： 
    ./google-cloud-sdk/install.sh --help
    • 如要傳送匿名使用統計資料，協助我們改善 gcloud CLI，請在系統提示時回答 Y。
    • 如要將 gcloud CLI 新增至 PATH 並啟用指令完成功能，請在系統提示時回答 Y。
  5. 如果您在上一個步驟中更新了 PATH，請開啟新的終端機，讓變更生效。
  6. 如要初始化 gcloud CLI，請執行 gcloud init： 
    7. ./google-cloud-sdk/bin/gcloud init
  7. 選用：使用元件管理員安裝其他元件。
Debian/Ubuntu

套件內容

套件格式的 gcloud CLI 可安裝於 Debian 和 Ubuntu 系統。這個套件只包含 gcloud、gcloud alpha、gcloud beta、gsutil 和 bq 指令，不包含 kubectl 或使用 gcloud 指令部署應用程式所需的 App Engine 擴充功能。如需這些元件，您必須另行安裝。

事前準備

安裝 gcloud CLI 前，請確認您的作業系統符合下列需求：

  • Ubuntu 版本尚未終止服務，或 Debian 穩定版本尚未終止服務
  • 最近更新了套件： 
    sudo apt-get update
  • 已安裝 apt-transport-https 和 curl： 
    sudo apt-get install apt-transport-https ca-certificates gnupg curl
安裝
  1. 匯入 Google Cloud 公開金鑰。

    • 如為較新的發行版本 (Debian 9 以上或 Ubuntu 18.04 以上)，請執行下列指令：

      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
    • 如為舊版發行版本，請執行下列指令： 
      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

    • 如果發行版的 apt-key 指令不支援 --keyring 引數，請執行下列指令：

      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

    • 如果您因為金鑰過期而無法取得最新的更新，請取得最新的 apt-get.gpg 金鑰檔案。

  2. 新增 gcloud CLI 發布作業 URI 做為套件來源。
    • 如為較新的發行版本 (Debian 9 以上或 Ubuntu 18.04 以上)，請執行下列指令： 
      echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

    • 如為不支援 signed-by 選項的舊版發行版本，請執行下列指令：

      echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
  3. 更新並安裝 gcloud CLI： 
    sudo apt-get update && sudo apt-get install google-cloud-cli
     如需停用提示或模擬測試等其他 apt-get 選項的資訊，請參閱 apt-get 手冊頁面。

    Docker 提示：如果要在 Docker 映像檔內安裝 gcloud CLI，請改用單一 RUN 步驟：

    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -y
    如為不支援 gpg --dearmor 指令的舊版基礎映像檔： 
    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-cli -y
  4. (選用) 安裝下列任一 附加元件：
    • google-cloud-cli
    • google-cloud-cli-anthos-auth
    • google-cloud-cli-app-engine-go
    • google-cloud-cli-app-engine-grpc
    • google-cloud-cli-app-engine-java
    • google-cloud-cli-app-engine-python
    • google-cloud-cli-app-engine-python-extras
    • google-cloud-cli-bigtable-emulator
    • google-cloud-cli-cbt
    • google-cloud-cli-cloud-build-local
    • google-cloud-cli-cloud-run-proxy
    • google-cloud-cli-config-connector
    • google-cloud-cli-datastore-emulator
    • google-cloud-cli-firestore-emulator
    • google-cloud-cli-gke-gcloud-auth-plugin
    • google-cloud-cli-kpt
    • google-cloud-cli-kubectl-oidc
    • google-cloud-cli-local-extract
    • google-cloud-cli-minikube
    • google-cloud-cli-nomos
    • google-cloud-cli-pubsub-emulator
    • google-cloud-cli-skaffold
    • google-cloud-cli-spanner-emulator
    • google-cloud-cli-terraform-validator
    • google-cloud-cli-tests
    • kubectl

    例如，您可以按照以下方式安裝 google-cloud-cli-app-engine-java 元件：

    sudo apt-get install google-cloud-cli-app-engine-java
  5. 執行 gcloud init 即可開始使用： 
    gcloud init

降級 gcloud CLI 版本

如要還原至特定版本的 gcloud CLI (其中 VERSION 的格式為 123.0.0)，請執行下列指令：

sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0

存放區一律會提供最近十個版本。

注意：如果是 371.0.0 之前的版本，套件名稱為 google-cloud-sdk

Red Hat/Fedora/CentOS

套件內容

您可以取得套件格式的 gcloud CLI，以在 Red Hat Enterprise Linux 7、8 和 9；Fedora 41 和 42；以及 CentOS 7 和 8 系統上安裝。這個套件只包含 gcloud、gcloud alpha、gcloud beta、gsutil 和 bq 指令，不包含 kubectl 或使用 gcloud 指令部署應用程式所需的 App Engine 擴充功能 (這些項目能夠單獨安裝，詳情請見本節稍後內容)。

安裝
  1. 使用 gcloud CLI 存放區資訊更新 DNF。

    • 下列範例指令適用於 Red Hat Enterprise Linux 7、8 或 9 相容的安裝作業，但請務必視需要更新設定，以符合您的設定：

      sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
[google-cloud-cli]
name=Google Cloud CLI
baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM

    • 如要安裝與 RHEL 10 相容的套件，請使用下列指令，並更新 gpgkey：

      sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
[google-cloud-cli]
name=Google Cloud CLI
baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el10-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key-v10.gpg
EOM
  2. 安裝「libxcrypt-compat.x86_64」。 
    sudo dnf install libxcrypt-compat.x86_64
  3. 安裝 gcloud CLI： 
    sudo dnf install google-cloud-cli
  4. (選用) 安裝下列任一附加元件：
    • google-cloud-cli
    • google-cloud-cli-anthos-auth
    • google-cloud-cli-app-engine-go
    • google-cloud-cli-app-engine-grpc
    • google-cloud-cli-app-engine-java
    • google-cloud-cli-app-engine-python
    • google-cloud-cli-app-engine-python-extras
    • google-cloud-cli-bigtable-emulator
    • google-cloud-cli-cbt
    • google-cloud-cli-cloud-build-local
    • google-cloud-cli-cloud-run-proxy
    • google-cloud-cli-config-connector
    • google-cloud-cli-datastore-emulator
    • google-cloud-cli-firestore-emulator
    • google-cloud-cli-gke-gcloud-auth-plugin
    • google-cloud-cli-kpt
    • google-cloud-cli-kubectl-oidc
    • google-cloud-cli-local-extract
    • google-cloud-cli-minikube
    • google-cloud-cli-nomos
    • google-cloud-cli-pubsub-emulator
    • google-cloud-cli-skaffold
    • google-cloud-cli-spanner-emulator
    • google-cloud-cli-terraform-validator
    • google-cloud-cli-tests
    • kubectl

    例如，您可以按照以下方式安裝 google-cloud-cli-app-engine-java 元件：

    sudo dnf install google-cloud-cli-app-engine-java
  5. 執行 gcloud init 即可開始使用： 
    gcloud init

降級 gcloud CLI 版本

如要還原至特定版本的 gcloud CLI (其中 VERSION 的格式為 123.0.0)，請執行： sudo dnf downgrade google-cloud-cli-VERSION 存放區一律會提供最近十個版本。注意：如果是 371.0.0 之前的版本，套件名稱為 google-cloud-sdk

macOS
  1. 確認您使用的是支援的 Python 版本：
    • 如要查看目前的 Python 版本，請執行 python3 -V 或 python -V。支援的版本為 Python 3.9 至 3.14。
    • 主要安裝指令碼會提供安裝 CPython 的 Python 3.12 版。
      • 安裝 Python 時需要 Xcode 指令列工具。
      • 執行 xcode-select -p，確認 Xcode 指令列工具是否已安裝。
      • 如果未安裝 Xcode Command Line Tools，請執行 sudo xcode-select --install 安裝。
    • 如要安裝支援的 Python 版本，請前往 Python.org 的「Python Releases for macOS」。
    • 如果電腦上安裝了多個 Python 解譯器，請在殼層中設定 CLOUDSDK_PYTHON 環境變數，指向偏好解譯器的路徑。
    • 如要進一步瞭解如何選擇及設定 Python 解譯器，請參閱 gcloud topic startup。
  2. 下載下列其中一個檔案：

    3. 平台 套件 大小 SHA256 總和檢查碼
    macOS 64 位元

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz 57.2 MB b24a11aa4f1816bff3122b3560c909c1eb7109bf8979821251d8bc5679582f10
    macOS 64 位元

    (ARM64, Apple silicon)

    		 google-cloud-cli-darwin-arm.tar.gz 57.1 MB b4d2b8b63593ad226cf1c4da0667ffa4a9cb923bd41ec269e67891491aeb126a
    macOS 32 位元

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 55.7 MB 6e66bdc92029fd3a3856e6a9bc03f2799079184ff3fe436c7ade1ef1a8f03452
  3. 將封存檔解壓縮到您檔案系統上的任何位置 (最好是主目錄)。在 macOS 上，可以在偏好位置開啟下載的 .tar.gz 封存檔來完成此作業。或執行下列指令： 
    tar -xf google-cloud-cli-darwin-arm.tar.gz

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

  4. 使用下列指令執行安裝指令碼 (來自您在上一步驟中解壓縮的資料夾根目錄)：
    ./google-cloud-sdk/install.sh

    指令碼會提示安裝 Python 3.12 和某些建議的模組。

    您也可以提供偏好設定做為標記，以非互動方式 (例如使用指令碼) 進行安裝。如要說明可用的旗標，請執行： 
    ./google-cloud-sdk/install.sh --help
     如要在開啟螢幕閱讀器模式的情況下執行安裝指令碼，請按照下列步驟操作： 
    ./google-cloud-sdk/install.sh --screen-reader=true
     選用：
    • 如要傳送匿名使用統計資料，協助我們改善 gcloud CLI，請在系統提示時回答 Y。
    • 如要將 gcloud CLI 新增至 PATH 並啟用指令完成功能，請在系統提示時回答 Y。
  5. 如果您在上一個步驟中更新了 PATH，請開啟新的終端機，讓變更生效。
  6. 如要初始化 gcloud CLI，請執行 gcloud init： 
    7. ./google-cloud-sdk/bin/gcloud init
  7. (選用步驟) 使用元件管理員安裝其他元件。
Windows
    Google Cloud CLI 適用於 Windows 8.1 以上版本和 Windows Server 2012 以上版本。

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

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

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")

& $env:Temp\GoogleCloudSDKInstaller.exe

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

    如果使用螢幕閱讀器，請勾選「開啟螢幕閱讀器模式」核取方塊。這個選項會將 gcloud 設為使用狀態追蹤器而非 Unicode 旋轉符號，以百分比顯示進度，並將表格扁平化。詳情請參閱無障礙功能指南。

  3. Google Cloud CLI 需要 Python，支援的版本為 Python 3.9 至 3.14。Google Cloud CLI 的 Windows 版本預設會隨附 Python 3。如要使用 Google Cloud CLI，作業系統必須能夠執行支援的 Python 版本。

    安裝程式會安裝所有必要的依附元件，包含所需的 Python 版本。Google Cloud CLI 預設會安裝及管理 Python 3，但如有需要，您可以取消勾選「安裝隨附 Python」選項，使用現有的 Python 安裝版本。請參閱gcloud topic startup，瞭解如何使用現有的 Python 安裝項目。

  4. 安裝完成後，安裝程式會提供選項，讓您建立「開始」功能表和桌面捷徑、啟動 Google Cloud CLI 殼層，以及設定 gcloud CLI。請務必保留啟動殼層和設定安裝作業的選項。安裝程式會開啟終端機視窗並執行 gcloud init 指令。

  5. 預設的安裝不包括使用 gcloud 指令部署應用程式所需的 App Engine 擴充功能。您可利用 gcloud CLI 元件管理員來安裝這些元件。
疑難排解訣竅：
  • 如果系統無法識別 find 指令而導致安裝失敗，請確保 PATH 環境變數設定為納入含有 find 的資料夾。通常是 C:\WINDOWS\system32;。
  • 如果您解除安裝 gcloud CLI，必須先重新啟動系統，才能再次安裝 gcloud CLI。
  • 如果解壓縮失敗，請以管理員身分執行安裝程式。

其他安裝選項

視開發需求而定，您可以使用其他方法安裝 gcloud CLI，而不採用建議的安裝方式：

  • 編寫指令碼來使用 gcloud CLI 或持續整合/部署？ 下載適用於非互動式安裝的特定版本 gcloud CLI 版本化封存檔。
  • 需要以 Docker 映像檔形式執行 gcloud CLI 嗎？使用 gcloud CLI Docker 映像檔，取得最新版 (或特定版本) 的 gcloud CLI。
  • 使用 Ubuntu 且偏好自動更新嗎？使用 snap 套件安裝 gcloud CLI。
  • 若為 Windows 和 macOS 互動式安裝以及其他用途，請執行互動式安裝程式來安裝最新版本的 gcloud CLI。

管理安裝內容

安裝 gcloud CLI 後，您可以使用 gcloud components 指令群組中的指令管理安裝作業。包括查看已安裝的元件、新增與刪除元件，以及升級至新版本或降級至特定版本的 gcloud CLI。

舉例來說，您可以使用下列指令升級 gcloud CLI 版本：

gcloud components update
 注意：如果您使用 apt-get 或 yum 安裝 gcloud CLI，就必須使用 apt-get 或 yum 更新或移除元件，而非 gcloud components。

舊版 gcloud CLI

如需其他版本的 gcloud CLI，請按照本頁稍早顯示的操作說明安裝目前版本，然後登入。登入後，即可下載先前的版本。如要依日期排序版本，請務必啟用「排序和篩選」，然後按一下「建立時間」欄。

支援的 Python 版本

Google Cloud CLI 需要 Python 3.9 至 3.14。如要瞭解如何選擇及設定 Python 解譯器，請參閱 gcloud topic startup。

歡迎試用

如果您未曾使用過 Google Cloud，歡迎建立帳戶來評估我們的產品在實際工作環境中的成效。新客戶還能獲得價值 $300 美元的免費抵免額，可用於執行、測試及部署工作負載。

免費試用