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.10 至 3.15。根據預設,Windows 版 Google Cloud CLI 隨附 Python 3。如要使用 Google Cloud CLI,您的作業系統必須能執行支援的 Python 版本。
- 安裝程式會安裝所有必要的依附元件,包括所需的 Python 版本。
雖然 Google Cloud CLI 預設會安裝及管理 Python 3,但如有需要,您可以取消勾選「Install Bundled 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:不建立桌面捷徑 (預設為建立捷徑)