安裝 gsutil

必要條件：安裝 Python 版本管理工具 (pyenv)，並安裝合適的 Python 版本。

1. 設定全域 Python 版本：
   • 如要將 Python 3.12.x 設為全域版本：

     pyenv global 3.12.x

   • 或者，您也可以為特定專案資料夾在本機設定 Python 版本：

     pyenv local 3.12.x

2. 確認使用正確的 Python 版本：

   python --version

   畫面上會顯示下列訊息：

   Python 3.12.x

1. 確認您使用的是支援的 Python 版本。Google Cloud CLI 需要 Python 3.8 至 3.13。請注意，x86_64 Linux 套件包含預設會優先使用的 Python 解譯器。如要瞭解如何選擇及設定 Python 解譯器，請參閱 gcloud topic startup。
2. 下載下列其中一個檔案：

   平台	套件名稱	大小	SHA256 總和檢查碼
   Linux 64 位元 (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	149.7 MB	01d322b29107e57f13e1418c789b9c3c0e6db1eb8e182d41ab6de09e6e0ca805
   Linux 64 位元 (Arm)	google-cloud-cli-linux-arm.tar.gz	56.3 MB	009a1ca0b114e4049cadb517a81c2a4b697d180425da1d2fdb456952d7f070b5
   Linux 32 位元 (x86)	google-cloud-cli-linux-x86.tar.gz	56.3 MB	1fea8bf6373c49c435ab4089aa128f981da425408b28f88b6c4a91d18b19e3a3

   如要下載 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：

./google-cloud-sdk/bin/gcloud init

7. 選用：使用元件管理員安裝其他元件。

套件格式的 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

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

1. 使用 gcloud CLI 存放區資訊更新 DNF。 下列範例指令適用於 Red Hat Enterprise Linux 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

2. 如果要在 Fedora 34 或 35 上安裝，請安裝 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