Debian 和 Ubuntu 快速入門導覽課程

本頁說明安裝 Google Cloud SDK 並將其初始化的方式,以及如何從指令列執行核心 gcloud 指令。

事前準備

請確認您的作業系統是下列其中一項:

如果您還沒有 Google Cloud Platform 專案,請建立 Google Cloud Platform 專案

然後執行下列步驟:

# Create environment variable for correct distribution
export CLOUD_SDK_REPO="cloud-sdk-$(lsb_release -c -s)"

# Add the Cloud SDK distribution URI as a package source
echo "deb http://packages.cloud.google.com/apt $CLOUD_SDK_REPO main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

# Import the Google Cloud Platform public key
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

# Update the package list and install the Cloud SDK
sudo apt-get update && sudo apt-get install google-cloud-sdk

Docker 提示:如果要在 Docker 映像檔內安裝 Cloud SDK,請改用單一 RUN 步驟:

RUN export CLOUD_SDK_REPO="cloud-sdk-$(lsb_release -c -s)" && \
    echo "deb http://packages.cloud.google.com/apt $CLOUD_SDK_REPO 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 add - && \
    apt-get update -y && apt-get install google-cloud-sdk -y

疑難排解提示:您可能需要安裝 lsb_版本,才能擷取正確的 Canonical 版本名稱。

疑難排解提示:如果您因為金鑰過期無法取得最新的更新,請取得最新的 apt-get.gpg 金鑰檔案

初始化 SDK

使用 gcloud init 指令執行數個常見的 SDK 設定工作。這些包含使用您的使用者帳戶憑證和設定預設的 SDK 配置來授權 SDK 工具存取 Google Cloud Platform。

如要初始化 SDK:

  1. 在命令提示字元中輸入以下指令:

    gcloud init
    

    附註:如要避免指令啟動網路瀏覽器,請改用 gcloud init --console-only。如果要在不開啟網路瀏覽器並以非互動的方式進行授權,請使用Google Cloud Platform 主控台建立具有適當範圍的服務帳戶,並透過對應的 JSON 金鑰檔案使用 gcloud auth activate-service-account

  2. 使用 Google 使用者帳戶並接受登入選項:

    To continue, you must log in. Would you like to log in (Y/n)? Y
    
  3. 在您的瀏覽器上,於系統提示時登入 Google 使用者帳戶,按一下 [Allow] (允許) 以授予存取 Google Cloud Platform 資源的權限。

  4. 在命令提示字元中,從具有擁有者編輯者檢視者權限的清單上選取 Cloud Platform 專案:

    Pick cloud project to use:
     [1] [my-project-1]
     [2] [my-project-2]
     ...
     Please enter your numeric choice:
    

    如果您只有一項專案,則 gcloud init 會自動為您選取。

  5. 如果您已啟用 Google Compute Engine API,gcloud init 可讓您選取預設 Compute Engine 區域:

    Which compute zone would you like to use as project default?
     [1] [asia-east1-a]
     [2] [asia-east1-b]
     ...
     [14] Do not use default zone
     Please enter your numeric choice:
    

    gcloud init 會確認您已成功完成設定步驟:

    gcloud has now been configured!
    You can use [gcloud config] to change more gcloud settings.
    
    Your active configuration is: [default]
    

執行核心 gcloud 指令

執行下列 gcloud 指令來檢視您的 SDK 安裝相關資訊:

  1. 如果要列出本機系統上已儲存憑證的帳戶:

    gcloud auth list
    

    gcloud 會顯示具有憑證之帳戶的清單:

           Credentialed Accounts
    ACTIVE             ACCOUNT
    *                  example-user-1@gmail.com
                       example-user-2@gmail.com
    
  2. 如何列出您所使用 SDK 配置中的屬性:

    gcloud config list
    

    gcloud 會顯示屬性清單:

    [core]
    account = example-user-1@gmail.com
    disable_usage_reporting = False
    project = example-project
    
  3. 如何查看您的 Cloud SDK 安裝和使用中 SDK 設定的相關資訊:

    gcloud info
    

    gcloud 會顯示您的 Cloud SDK 安裝相關摘要資訊,這包含您系統中的相關資訊、已安裝 SDK 元件、使用中的使用者帳戶與目前專案,以及使用中 SDK 設定的屬性。

  4. 如何查看 gcloud 指令和指令列中的其他主題相關資訊:

    gcloud help
    

    舉例來說,如果您想查看 gcloud compute instances create 的說明:

    gcloud help compute instances create
    

    gcloud 會顯示包含指令說明、指令標記和引數的清單,以及如何使用它的說明主題。

後續步驟

  • 請閱讀 gcloud 工具指南以取得 gcloud 指令列工具的基本說明,包含重要概念、指令慣例和實用提示的快速簡介。
  • 請閱讀 gcloud 參考指南以取得每個 gcloud 指令的詳細介紹頁面,包含說明、標記和範例等等。您可以使用這些指令在 Google Cloud Platform 上執行各種工作。
  • 安裝額外的 Cloud SDK APT 套件
本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Cloud SDK 說明文件