安裝 Cloud SDK

這個頁面提供了下載和安裝 Google Cloud SDK 的相關說明。

系統需求

Cloud SDK 必須在 Linux、Mac OS X 和 Windows 上執行,且需要 Python 2.7.x。某些隨附於 Cloud SDK 的工具另有額外需求。例如,Google App Engine 開發作業專用的 Java 工具就需要 Java 1.7 以上版本。

安裝選項

請透過下列任一種方法來安裝 Cloud SDK:

  • 下載任何版本的版本化封存檔,包含舊版本
  • 執行互動式安裝程式來下載並安裝最新版本
  • 使用 apt-get (僅限 Debian 和 Ubuntu) 下載並安裝最新版本
  • 使用 yum (Red Hat 和 CentOS) 下載並安裝最新版本

這些安裝方法會安裝預設的 Cloud SDK 元件,包括 gcloudgsutilbq 指令列工具。如需安裝其他元件,您可以利用 gcloud components install 指令或安裝適用的 debRPM 套件。

版本化封存檔

Cloud SDK 為每個版本提供可下載的版本化封存檔。在名為 google-cloud-sdk 的目錄中,每個版本化封存檔都含有獨立的 Cloud SDK 安裝檔,您可以將其複製到檔案系統上的任何位置。

版本化封存檔是為特定版本的 Cloud SDK 非互動式安裝程序而設計,適用於以下情況:

  • 您需要特定版本的 Cloud SDK。例如:

    • 您正在使用 gcloud 或其他 Cloud SDK 元件編寫指令碼,並希望確保您的指令碼不會因 Cloud SDK 更新而中斷。

    • 您正在使用 Cloud SDK 做為 CI (持續整合) 程序或工作系統的一部分,以便控制您的依附元件,進而確保系統各部分之間的相容性。

    • 您正在為多台必須保持同步的電腦執行 Cloud SDK 自動部署作業。

  • 您不想執行互動式安裝。

以下步驟說明如何從版本化的封存檔中安裝最新版的 Cloud SDK:

  1. 下載以下其中一項:

    平台 套件 大小 SHA256 總和檢查碼
    Linux 64 位元

    (x86_64)

    google-cloud-sdk-183.0.0-linux-x86_64.tar.gz 18.3 MB 6e5c76999ff3f14621d26e3c76967dc4c43613344947ab42fcc764311642c898
    Linux 32 位元

    (x86)

    google-cloud-sdk-183.0.0-linux-x86.tar.gz 17.9 MB 943faf4b47049e29f9a67f6e56a473486373b50876d5aeb31651eb2e327d5572
    Mac OS X 64 位元

    (x86_64)

    google-cloud-sdk-183.0.0-darwin-x86_64.tar.gz 14.4 MB 605332cb305a04d377572d61063db88433862521f1aa4887d3b3fbfaaf1519a2
    Mac OS X 32 位元

    (x86)

    google-cloud-sdk-183.0.0-darwin-x86.tar.gz 14.4 MB b10d8c097d1501624eeaf01c72f036d1333fe7ef672c2a2fbeb49fb3a239950c
    Windows 64 位元

    (x86_64)

    google-cloud-sdk-183.0.0-windows-x86_64.zip 91.4 MB c855014fc5105cbfffbb014bfd50828061ba30605bbfd37af52b3706e7a8aacd
    Windows 64 位元

    (x86_64) 隨附 Python

    google-cloud-sdk-183.0.0-windows-x86_64-bundled-python.zip 129.8 MB b30c06b885653951c0ef4330138537d40b9ead61fb85a693a1f469331a837ece
    Windows 32 位元

    (x86)

    google-cloud-sdk-183.0.0-windows-x86.zip 91.6 MB 6c194acb87e2f3d6fddb2aa67aa547e23b4677e3831b327a2a6e7af201bb8796
    Windows 32 位元

    (x86) 隨附 Python

    google-cloud-sdk-183.0.0-windows-x86-bundled-python.zip 125.9 MB fbdb5beabdf0c74887a0c21f587e9f4bba3e2a9ab17dd32b24e28e7a7425f3e5

  2. 將檔案解壓縮到您檔案系統上的任何位置。

  3. 選用:執行安裝指令碼,將 Cloud SDK 工具新增到您的路徑。這個動作亦會產生相關指令,並在 bash 殼層 (僅限 Linux 和 Mac OS) 中完成指令,並啟用使用報告。

    • 使用 Linux 或 Mac OS X:

      ./google-cloud-sdk/install.sh
      

      為了將 Cloud SDK 指令列工具新增到您的 PATH,您必須在設定檔中讀取並執行 /your/gcloud/filepath/path.bash.inc。另外,在設定檔中讀取並執行 /your/gcloud/filepath/completion.bash.inc,以完成 gcloud 的殼層指令。

    • 使用 Windows:

      .\google-cloud-sdk\install.bat
      

    執行 install.sh --helpinstall.bat --help,取得您可以傳送到這個指令碼的標記清單。

  4. 執行 gcloud init 來初始化 SDK:

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

舊版本

您可以在 Google Cloud Storage 的下載封存檔中,找到舊版本的 Cloud SDK,亦可直接透過 https://storage.googleapis.com/cloud-sdk-release/<archive_name> 取得。

互動式安裝程式

Cloud SDK 也為每個支援的平台提供互動式安裝程式。這個安裝程式讓您以互動模式快速下載、安裝和設定最新版本的 Cloud SDK。當您執行安裝程式時,它會下載 Cloud SDK 元件並將其安裝在本機系統上。安裝程式還會執行其他設定工作,例如將 Cloud SDK 元件新增至您的 PATH,並在殼層中完成指令。

Linux
  1. 在命令提示字元中輸入以下內容:
    curl https://sdk.cloud.google.com | bash
  2. 重新啟動殼層:
    exec -l $SHELL
  3. 執行 gcloud init 來初始化 gcloud 環境:
    gcloud init
Mac OS X
  1. 在命令提示字元中輸入以下內容:
    curl https://sdk.cloud.google.com | bash
  2. 重新啟動殼層:
    exec -l $SHELL
  3. 執行 gcloud init 來初始化 gcloud 環境:
    gcloud init
Windows
  1. 下載 Cloud SDK 安裝程式。這個安裝程式是由 Google Inc. 簽署。

  2. 啟動安裝程式並按照提示操作。如果您的系統沒有安裝 Python 2.7.9 以上版本的 Python 2,請記得勾選安裝「隨附 Python」的選項。Cloud SDK 目前不支援 Python 3。

  3. 安裝完成後,請接受以下選項:

    • 啟動 Cloud SDK Shell
    • 執行 gcloud init

  4. 安裝程式會開啟終端機視窗並執行 gcloud init 指令。

  5. 預設的安裝不包括使用 gcloud 指令部署應用程式需要的 App Engine 擴充功能。您可利用 Cloud SDK 元件管理員來安裝這些元件。

注意:如果您使用的是執行 Windows Server 的 Google Compute Engine 執行個體,則 Internet Explorer 會採用強化安全性設定,這會導致您無法執行前述的安裝程式。請先停用強化安全性設定,重新啟動 Internet Explorer,然後再執行安裝程式。如需在 Windows Server 執行個體上停用強化安全性設定的操作說明,請開啟「Windows 說明及支援」並搜尋「IE ESC」。

您也可以從已下載的 .zip 檔安裝最新版本:

  1. 下載 google-cloud-sdk.zip 並解壓縮其中的內容,方法是在下載的檔案上按滑鼠右鍵並選取 [解壓縮全部]

  2. 啟動 google-cloud-sdk\install.bat 指令碼並依照安裝提示進行操作。

  3. 安裝完成後,重新啟動命令提示字元 (cmd.exe)。

  4. 執行 gcloud init

    C:\> gcloud init

非互動式 (無訊息) 部署

您可以在無提示的情況下完成 Cloud SDK 部署作業,方法是將標記傳送給安裝程式,這樣您就能讓系統自動安裝 Cloud SDK。

Linux 系統:

  • --disable-prompts - 停用提示。

  • --install-dir=DIRECTORY - 將安裝根目錄設為 DIRECTORY。Cloud SDK 將安裝於 DIRECTORY/google-cloud-sdk。預設為 $HOME。

Windows 系統:

  • /S - 以無訊息的方式安裝。不會顯示安裝程式頁面。使用標記來變更安裝設定。
  • /D - 設定預設的安裝目錄。目錄必須為指令列中使用的最後一個參數,即使路徑包含空格,也不能輸入任何引號。僅支援絕對路徑,例如 /D=C:\CloudSDK
  • /allusers - 為所有使用者安裝
  • /singleuser - 為目前使用者安裝 (預設)
  • /noreporting - 停用使用報告 (預設為傳送使用報告)
  • /nostartmenu - 不要建立開始功能表捷徑 (預設為建立捷徑)
  • /nodesktop - 不要建立桌面捷徑 (預設為建立捷徑)

管理安裝內容

當您透過上述其中一種方法安裝 Cloud SDK 後,可以使用 gcloud components 指令群組中的指令來管理您的安裝內容,包括查看已安裝的元件、新增和刪除元件以及升級到新版本的 Cloud SDK。

如果您透過以下任一種方法安裝 Cloud SDK,就不能使用 gcloud components 來更新和刪除元件。

apt-get (僅限 Debian 和 Ubuntu)

您可以取得套件格式的 Cloud SDK,並在 Debian 和 Ubuntu 系統上予以安裝。這個套件只包含 gcloudgcloud alphagcloud betagsutilbq 指令,不包括 kubectl 或使用 gcloud 指令部署應用程式需要的 App Engine 擴充功能。如需這些元件,您必須按照本節後段的說明分別安裝。

您可以在所有尚未終止服務的官方版 Ubuntu 與 Wheezy 之後的穩定版 Debian 上,以 Debian/Ubuntu 套件安裝 Cloud SDK。

注意:如果您在 Google Compute Engine 上使用執行個體,則系統已預設安裝 Cloud SDK。但您仍然可以按照下面的指示手動安裝 Cloud SDK。

  1. 建立環境變數,以進行正確的發佈作業:
    export CLOUD_SDK_REPO="cloud-sdk-$(lsb_release -c -s)"
  2. 新增 Cloud SDK 發佈作業 URI 作為套件來源:
    echo "deb http://packages.cloud.google.com/apt $CLOUD_SDK_REPO main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
    如果您已安裝 apt-transport-https,可在此步驟中使用「https」而不是「http」。
  3. 匯入 Google Cloud 公開金鑰:
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
  4. 更新並安裝 Cloud SDK:
    sudo apt-get update && sudo apt-get install google-cloud-sdk
  5. (選擇性) 安裝下列任一附加元件:
    • google-cloud-sdk-app-engine-python
    • google-cloud-sdk-app-engine-java
    • google-cloud-sdk-app-engine-go
    • google-cloud-sdk-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-pubsub-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-bigtable-emulator
    • kubectl

    例如,您可以按照以下方式安裝 google-cloud-sdk-app-engine-java 元件:

    sudo apt-get install google-cloud-sdk-app-engine-java
  6. 執行 gcloud init 來開始使用:
    gcloud init

yum (Red Hat 和 CentOS)

您可以取得套件格式的 Cloud SDK,並在 Red Hat Enterprise Linux 7 和 CentOS 7 系統上予以安裝。這個套件只包含 gcloudgcloud alphagcloud betagsutilbq 指令,不包括 kubectl 或使用 gcloud 指令部署應用程式需要的 App Engine 擴充功能。如需要這些指令,您可以單獨安裝

注意:如果您在 Google Compute Engine 上使用執行個體,則系統已預設安裝 Cloud SDK。

  1. 使用 Cloud SDK 存放區資訊來更新 YUM:
    sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
    [google-cloud-sdk]
    name=Google Cloud SDK
    baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el7-x86_64
    enabled=1
    gpgcheck=1
    repo_gpgcheck=1
    gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
           https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
    EOM
    

    重要事項:gpgkey 的第二行必須縮排,如上所示。

  2. 安裝 Cloud SDK:
    yum install google-cloud-sdk
  3. (選擇性) 安裝下列任一附加元件:
    • google-cloud-sdk-app-engine-python
    • google-cloud-sdk-app-engine-java
    • google-cloud-sdk-app-engine-go
    • google-cloud-sdk-bigtable-emulator
    • google-cloud-sdk-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-pubsub-emulator
    • kubectl

    例如,您可以按照以下方式安裝 google-cloud-sdk-app-engine-java 元件:

    yum install google-cloud-sdk-app-engine-java
  4. 執行 gcloud init 來開始使用:
    gcloud init
本頁內容對您是否有任何幫助?請提供意見:

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

這個網頁
Cloud SDK 說明文件