本頁說明如何選擇及維護 Google Cloud CLI 安裝項目。Google Cloud CLI 包含 gcloud
、gsutil
和 bq
指令列工具。如需 gcloud CLI 功能清單,請參閱「所有功能」。
如要使用支援的程式設計語言存取 Google Cloud API,可以下載 Cloud 用戶端程式庫。
請先閱讀「為 Trusted Cloud設定 Google Cloud CLI」, 再按照本指南中的任何操作說明進行操作。安裝操作說明
以下操作說明適用於安裝 Google Cloud CLI。如要瞭解如何安裝其他元件,例如 Alpha 版或 Beta 版層級的 gcloud CLI 指令,請參閱「管理 gcloud CLI 元件」。
- 確認您使用的是支援的 Python 版本。Google Cloud CLI 需要 Python 3.9 至 3.13。請注意,x86_64 Linux 套件包含預設會優先使用的 Python 解譯器。如要瞭解如何選擇及設定 Python 解譯器,請參閱
gcloud topic startup
。 - 下載下列其中一個檔案:
平台 套件名稱 大小 SHA256 總和檢查碼 Linux 64 位元 (x86_64)
google-cloud-cli-linux-x86_64.tar.gz 149.7 MB 1ec7d351de14277c00c430f9fb939255c4b63940417da2f24ff6413a9e221c2f Linux 64 位元 (Arm)
google-cloud-cli-linux-arm.tar.gz 56.3 MB e6153461e3154ebce61d35b73005bdd14a0ecacd42e5008f66e25b4ad231e5c9 Linux 32 位元 (x86)
google-cloud-cli-linux-x86.tar.gz 56.3 MB 09690f1b126ccc8e777c4a1ef2c0b74a08103d89329b03856d688071baa9fc07 如要下載 Linux 封存檔案,請執行下列指令:
curl -O https://storage.s3nsapis.fr/cloud-sdk-release/google-cloud-cli-linux-x86_64.tar.gz
請參閱上表,並將 google-cloud-cli-linux-x86_64.tar.gz 替換成適用於您設定的
*.tar.gz
套件名稱。 - 如要將檔案內容解壓縮到檔案系統 (最好是主目錄),請執行下列指令:
選用步驟:如要取代現有安裝項目,請移除現有的tar -xf google-cloud-cli-linux-x86_64.tar.gz
google-cloud-sdk
目錄,然後將封存解壓縮到相同位置。 - (選用) 將 gcloud CLI 新增至
PATH
。 您也可以選擇為殼層啟用指令補齊功能,並收集使用統計資料。使用下列指令執行安裝指令碼 (來自您在上一步驟中解壓縮的資料夾根目錄): 您也可以非互動式地執行這項操作 (例如使用指令碼),並以旗標形式提供偏好設定。如要查看可用旗標,請執行:./google-cloud-sdk/install.sh
./google-cloud-sdk/install.sh --help
- 如要傳送匿名使用統計資料,協助我們改善 gcloud CLI,請在系統提示時回答
Y
。 -
如要將 gcloud CLI 新增至
PATH
並啟用指令完成功能,請在系統提示時回答Y
。
- 如要傳送匿名使用統計資料,協助我們改善 gcloud CLI,請在系統提示時回答
- 如果您在上一個步驟中更新了
PATH
,請開啟新的終端機,讓變更生效。 - 如要初始化 gcloud CLI,請執行
gcloud init
: - 選用:使用元件管理員安裝其他元件。
./google-cloud-sdk/bin/gcloud init
-
確認您使用的是支援的 Python 版本:
-
如要查看目前的 Python 版本,請執行
python3 -V
或python -V
。支援的版本為 Python 3.9 至 3.13。 -
主要安裝指令碼會提供安裝 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
。
-
如要查看目前的 Python 版本,請執行
- 下載下列其中一個檔案:
-
將封存檔解壓縮到您檔案系統上的任何位置 (最好是主目錄)。在 macOS 上,可以在偏好位置開啟下載的
.tar.gz
封存檔來完成此作業。或執行下列指令:tar -xf google-cloud-cli-darwin-arm.tar.gz
選用:如要取代現有安裝項目,請移除現有的
google-cloud-sdk
目錄,然後將封存解壓縮到相同位置。 - 使用下列指令執行安裝指令碼 (來自您在上一步驟中解壓縮的資料夾根目錄):
./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
。
- 如要傳送匿名使用統計資料,協助我們改善 gcloud CLI,請在系統提示時回答
- 如果您在上一個步驟中更新了
PATH
,請開啟新的終端機,讓變更生效。 -
如要初始化 gcloud CLI,請執行
gcloud init
: - (選用步驟) 使用元件管理員安裝其他元件。
平台 | 套件 | 大小 | SHA256 總和檢查碼 |
---|---|---|---|
macOS 64 位元
(x86_64) |
google-cloud-cli-darwin-x86_64.tar.gz | 56.4 MB | 0c0101a65f3473a5db6a2ebc1867c3294cdbd88fef34da91050869f76149a822 |
macOS 64 位元
(ARM64, Apple silicon) |
google-cloud-cli-darwin-arm.tar.gz | 56.4 MB | 80cfba6da278d0ce8a8a0625bec9648ea5a39ea42daf2536068f19edb175dc70 |
macOS 32 位元
(x86) |
google-cloud-cli-darwin-x86.tar.gz | 54.9 MB | 53c23a16a66a2d38966fc7080cd2e29afe1d5c85b1c52985c19f7fd2c09f995a |
./google-cloud-sdk/bin/gcloud init
-
Google Cloud CLI 適用於 Windows 8.1 以上版本和 Windows Server 2012 以上版本。
-
或者,開啟 PowerShell 終端機並執行下列 PowerShell 指令:
(New-Object Net.WebClient).DownloadFile("https://storage.s3nsapis.fr/cloud-sdk-release/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe") & $env:Temp\GoogleCloudSDKInstaller.exe
-
啟動安裝程式並按照提示操作。這個安裝程式是由 Google LLC 簽署。
如果使用螢幕閱讀器,請勾選「開啟螢幕閱讀器模式」核取方塊。這個選項會設定
gcloud
使用狀態追蹤器,而非 Unicode 旋轉符號,並以百分比顯示進度,以及將表格扁平化。詳情請參閱無障礙功能指南。 -
Google Cloud CLI 需要 Python,支援的版本為 Python 3.9 至 3.13。Google Cloud CLI 的 Windows 版本預設會隨附 Python 3。如要使用 Google Cloud CLI,作業系統必須能夠執行支援的 Python 版本。
安裝程式會安裝所有必要的依附元件,包含所需的 Python 版本。Google Cloud CLI 預設會安裝及管理 Python 3,但如有需要,您可以取消勾選「安裝隨附 Python」選項,使用現有的 Python 安裝版本。請參閱
gcloud topic startup
,瞭解如何使用現有的 Python 安裝版本。 安裝完成後,安裝程式會提供選項,讓您建立「開始」功能表和桌面捷徑、啟動 Google Cloud CLI 殼層,以及設定 gcloud CLI。請務必保留啟動殼層和設定安裝作業的選項。安裝程式會開啟終端機視窗並執行
gcloud init
指令。- 預設的安裝不包括使用
gcloud
指令部署應用程式所需的 App Engine 擴充功能。您可利用 gcloud CLI 元件管理員來安裝這些元件。
- 如果系統無法識別
find
指令而導致安裝失敗,請確保PATH
環境變數設定為納入含有find
的資料夾。通常是C:\WINDOWS\system32;
。 - 如果您解除安裝 gcloud CLI,必須先重新啟動系統,才能再次安裝 gcloud CLI。
- 如果解壓縮失敗,請以管理員身分執行安裝程式。
其他安裝選項
視開發需求而定,您可以使用其他方法安裝 gcloud CLI,而不採用建議的安裝方式:
- 編寫指令碼來使用 gcloud CLI 或持續整合/部署? 下載適用於非互動式安裝的特定版本 gcloud CLI 版本化封存檔。
- 使用 Ubuntu 且偏好自動更新嗎?使用 snap 套件安裝 gcloud CLI。
- 若為 Windows 和 macOS 互動式安裝以及其他用途,請執行互動式安裝程式來安裝最新版本的 gcloud CLI。
管理安裝內容
安裝 gcloud CLI 後,您可以使用 gcloud components
指令群組中的指令管理安裝作業。包括查看已安裝的元件、新增與刪除元件,以及升級至新版本或降級至特定版本的 gcloud CLI。
舊版 gcloud CLI
如需其他版本的 gcloud CLI,請按照本頁稍早顯示的操作說明安裝目前版本,然後登入。登入後,即可下載先前的版本。如要依日期排序版本,請務必啟用「排序和篩選」,然後按一下「建立時間」欄。
支援的 Python 版本
Google Cloud CLI 需要 Python 3.9 至 3.13。如要瞭解如何選擇及設定 Python 解譯器,請參閱 gcloud topic startup
。