gdcloud CLI 是一組工具，可用於建立及管理 Google Distributed Cloud (GDC) 氣隙資源。您可以使用這些工具，透過指令列、指令碼和自動化機制執行常見工作。gdcloud CLI 可用來啟動基礎架構、管理驗證，以及自訂本機設定。
本文適用於所有需要設定 GDC 專屬 CLI 的目標對象群組，以便管理無網路連線的硬體和軟體工作流程。詳情請參閱 GDC 氣隙環境適用的目標對象說明文件。
事前準備
確認您有權存取 GDC 控制台，並記下貴機構的網址。詳情請參閱「GDC 控制台存取權」。
確認您已在系統的信任憑證存放區中安裝憑證授權單位 (CA) 憑證。詳情請參閱「擷取 GDC 信任組合」。
確認您有機構網路政策，允許來自機構外部特定 CIDR 的流量連線至構件登錄服務。舉例來說，在
OrganizationNetworkPolicy資源中設定服務名稱all。詳情請參閱「建立機構網路政策」。確認裝置已安裝瀏覽器。
設定 gdcloud CLI
如要設定 gdcloud CLI，請完成下列步驟：
在瀏覽器中輸入機構的全球或區域網址，開啟 GDC 控制台。
在首頁中選取「Download CLI Bundle」(下載 CLI 套件)。
選取 Linux 平台，以及與 GDC 環境相應的 gdcloud CLI 組合包版本。
選擇非 Linux 平台時，設定步驟可能略有不同。此外，請注意，部分非 Linux gdcloud CLI 套件只提供部分 gdcloud 指令。詳情請參閱「可用的 gcloud CLI 套件」。
點選 [下載]。
在裝置上前往
Downloads資料夾：cd ~/Downloads擷取 gdcloud CLI 組合的內容：
tar -xf ./gdcloud_cli.tar.gz將 gdcloud CLI 組合新增至路徑：
eval echo 'export GDCLOUD_PATH=$(pwd)/google-distributed-cloud-hosted-cli' >> ~/.bashrc echo 'export PATH="$GDCLOUD_PATH/bin:$PATH"' >> ~/.bashrc source ~/.bashrc確認 gdcloud CLI 已正確安裝：
gdcloud version輸出結果會與下列內容相似：
gdcloud version: 1.15.0-gdch.380608初始化 gdcloud CLI：
gdcloud init提供系統提示的兩項屬性，完成初始化作業：
organization_console_url：目前 GDC 機構主控台的網址。這個網址可以是全域或區域。例如：https://console.org-1.google.gdch.test/。project：GDC 專案的名稱。如果您沒有現有專案，請使用default。
如要在初始化後更新 gdcloud CLI 設定，請參閱「管理 gdcloud CLI 設定」。
安裝
gdcloud-k8s-auth-plugin元件：gdcloud components install gdcloud-k8s-auth-plugin使用 gdcloud CLI 進行驗證，以便登入：
gdcloud auth login系統會將你重新導向至瀏覽器，以選擇身分並登入。
確認 gdcloud CLI 設定已連線至 GDC 環境：
gdcloud compute images list輸出結果會與下列內容相似：
METADATA.NAME METADATA.NAMESPACE SPEC.OPERATINGSYSTEM.NAME SPEC.MINIMUMDISKSIZE rocky-8-v20250809-gdch vm-system rocky-linux-8 12G ubuntu-20.04-v20250809-gdch vm-system ubuntu-2004 12G ubuntu-22.04-v20250809-gdch vm-system ubuntu-2204 12G ubuntu-24.04-v20250809-gdch vm-system ubuntu-2404 12G