安裝 Google Cloud CLI

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

事前準備

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud 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 Google Cloud project.

安裝 gcloud CLI 586.0.0 版

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

    (x86_64)

    		 google-cloud-cli-linux-x86_64.tar.gz 88.0 MB c1cd1823624a33f2341d0d384aafe2d7b24c1b77c9b131087d772ee0791ff2be
    Linux 64 位元

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 53.3 MB 67573751523f808db2a7dc9137d8df0faf91f78303e2c346f62ac2db4ae66f9f
    Linux 32 位元

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 53.3 MB 76ae821a3a11b1b69a394c71c2ffe4d820a109f6acaec95a3f46b767a8a63bcc

    如要下載 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. 從解壓縮的資料夾根目錄執行安裝指令碼： 
    ./google-cloud-sdk/install.sh
     指令碼會提示您執行下列設定動作。如要接受，請在系統提示時說出「接受」Y。
    • 將 gcloud CLI 新增至 PATH。
    • 啟用指令完成功能。
    • 選擇傳送匿名使用統計資料，協助我們改善 gcloud CLI。
    您也可以提供旗標，以非互動方式執行安裝作業。 如要查看可用的旗標，請執行： 
    ./google-cloud-sdk/install.sh --help
  5. 選用：如果您在上一步更新 PATH，請開啟新的終端機，讓變更生效。
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
  • 並已安裝 ca-certificates、gnupg 和 curl。如要安裝這些套件，請執行下列指令： 
    sudo apt-get install 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