Google Cloud CLI 為每個支援的平台提供安裝程式,且可透過互動或非互動方式部署。
互動式安裝
安裝程式可讓您以互動模式下載、安裝及設定最新版 Google Cloud CLI。執行安裝程式時,系統會下載 Google Cloud CLI 元件,並安裝在本地系統。此外,這個指令還會執行其他設定工作,例如將 gcloud CLI 元件新增至 PATH,以及在殼層中啟用指令完成功能。
-
執行下列指令:
curl https://sdk.cloud.google.com | bash
- 系統提示時,請在檔案系統中選擇
google-cloud-sdk子目錄的位置。預設為您的主目錄。 - 如要傳送匿名使用統計資料,協助我們改善 gcloud CLI,請在系統提示時回答
Y。 - 如要將 gcloud CLI 指令列工具新增至
PATH並啟用指令完成功能,請在系統提示時回答Y。
- 系統提示時,請在檔案系統中選擇
- 重新啟動殼層:
exec -l $SHELL
-
執行
gcloud init來初始化、授權及設定 gcloud CLI。
在 Windows 上使用 Google Cloud CLI 時,必須安裝 Windows 8.1 以上版本,或 Windows Server 2012 以上版本。
-
或者,開啟 PowerShell 終端機並執行下列 PowerShell 指令:
(New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe") & $env:Temp\GoogleCloudSDKInstaller.exe
-
啟動安裝程式並按照提示操作。這個安裝程式是由 Google LLC 簽署。
- 如果使用螢幕閱讀器,請勾選「開啟螢幕閱讀器模式」核取方塊。這個選項會設定
gcloud使用狀態追蹤器而非 Unicode 旋轉符號,以百分比顯示進度,並將表格扁平化。詳情請參閱無障礙功能指南。 - Google Cloud CLI 需要 Python,支援的版本為 Python 3.9 至 3.14。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 CLI。 - 預設安裝不包括使用
gcloud指令部署應用程式所需的 App Engine 擴充功能。您可利用 gcloud CLI 元件管理員來安裝這些元件。
疑難排解提示
- 如果系統無法識別
find指令而導致安裝失敗,請確保PATH環境變數設定為納入含有find的資料夾。通常是C:\WINDOWS\system32;。 - 如果您解除安裝 gcloud CLI,必須先重新啟動系統,才能再次安裝 gcloud CLI。
- 如果解壓縮失敗,請以管理員身分執行安裝程式。
您也可以從下載的 .zip 檔案安裝最新版本:
-
下載 google-cloud-sdk.zip 並解壓縮內容。(在下載的檔案上按一下滑鼠右鍵,然後選取「全部擷取」。)
-
啟動
google-cloud-sdk\install.bat指令碼,然後按照安裝提示操作。 -
安裝完成後,請重新啟動命令提示字元 (
cmd.exe)。 -
執行
gcloud init:C:\> gcloud init
非互動式 (無訊息) 部署
您可以使用安裝指令碼,自動安裝 Google Cloud CLI。
Linux 和 macOS:
將安裝指令碼儲存在本機,而不是透過管道傳送至 Bash。
- 在命令提示字元中輸入以下內容:
curl https://sdk.cloud.google.com > install.sh
-
執行指令碼,並傳遞下列引數:
bash install.sh --disable-prompts
install.sh 選項包括:
--disable-prompts- 停用提示。--install-dir=DIRECTORY- 將安裝根目錄設為DIRECTORY。Google Cloud CLI 會安裝在DIRECTORY/google-cloud-sdk中。預設值為 $HOME。
Windows:
/S- 無訊息安裝。不會顯示安裝程式頁面。使用標記來變更安裝設定。/D- 設定預設安裝目錄。目錄必須為指令列中使用的最後一個參數,即使路徑包含空格,也不能輸入任何引號。系統僅支援絕對路徑,例如/D=C:\CloudSDK/allusers- 為所有使用者安裝/singleuser- 為目前使用者安裝 (預設)/screenreader- 開啟螢幕閱讀器模式 (預設為關閉)/reporting- 啟用使用情形報告 (預設為關閉使用情形報告)/noreporting- 停用使用情形報告 (預設為關閉使用情形報告)/nostartmenu- 不要建立「開始」選單捷徑 (預設為建立捷徑)/nodesktop- 不要建立桌面捷徑 (預設為建立捷徑)