下載 gdcloud CLI

本文說明如何在 Google Distributed Cloud (GDC) 實體隔離環境中下載 gdcloud CLI。GDC 提供多種 gdcloud CLI 套件選項,適用於各種用途,例如:

  • 平台:選取與本機環境對應的作業系統 (OS) 和架構。
  • GDC 版本:選取 gdcloud CLI 的二進位檔版本,這會對應至 GDC 修補程式版本。建議您使用最新版本,但也可以下載封存版本,用於特定用途。
  • 類型:根據需求選取套裝組合類型。Full 套件類型包含所選平台支援的所有 gdcloud CLI 指令。Lite 套件類型包含 Full 套件中的 gdcloud CLI 指令子集,可縮減下載大小。

    Full 和 Lite 封裝封存檔都包含 bin/component_bundles/ 目錄,用於安裝 storage-cli-dependencies 等元件。如果將獨立 gdcloud CLI 二進位檔複製到解壓縮套件目錄外,就不會包含元件套件,也無法執行 gdcloud components install。

可用的 gdcloud CLI 套件可讓您彈性地依偏好執行 CLI。詳情請參閱「可用的 gdcloud CLI 套件」。

本文件適用於所有 GDC 工作人員,他們必須使用專屬指令列介面工具,處理實體隔離硬體和軟體工作流程。詳情請參閱「GDC 實體隔離方案說明文件的目標對象」。

事前準備

  • 確認您可透過網路存取運作中的 GDC 環境,且知道 GDC 控制台網址 (主機名稱)。與 Google Cloud CLI 不同,gdcloud CLI 不開放公開下載,您必須直接從 GDC 控制台下載套件。如果沒有這個網址,請與基礎架構操作員或平台管理員聯絡。

  • 設定組織網路政策,允許來自組織外部特定 CIDR 的流量傳送至 Artifact Registry。在 OrganizationNetworkPolicy 資源設定中使用服務 all。

下載 gdcloud CLI

從 GDC 控制台將 gdcloud CLI 套件下載到系統:

  1. 登入並前往 GDC「Welcome」(歡迎) 頁面。

  2. 前往「Connect with CLI」(使用 CLI 連線) 專區。

    使用 GDC 控制台下載 CLI 套件。

  3. 按一下「Download CLI Bundle」。

  4. 選擇要查看的支援平台。

    下載 CLI 套件

  5. 選擇與所選平台對應的類型和版本。

  6. 按一下「Download」(下載),將 gdcloud CLI 套件下載到本機環境。或者,如果您想從指令列啟動下載,可以選取「Copy Bundle URL」(複製套件網址) 複製下載網址。

解壓縮 gdcloud CLI 套件

將下載的 gdcloud CLI 套件內容解壓縮至檔案系統中的任何位置。請勿更動解壓縮後的 google-distributed-cloud-hosted-cli 目錄,以便 bin/gdcloud 在 bin/component_bundles/ 中找到元件封存檔。

如要取代現有安裝,請移除現有的 google-distributed-cloud-hosted-cli 目錄,並將封存檔解壓縮至相同位置。

  • 解壓縮套件:

    tar -xf BUNDLE_PATH/CLI_TAR_FILE
    

    更改下列內容:

    • BUNDLE_PATH:gdcloud CLI 套件的路徑。除非刻意變更套件下載路徑,否則預設路徑為 ~/Downloads。
    • CLI_TAR_FILE:您下載的 gdcloud CLI tar 檔案名稱,例如 gdcloud_cli_windows_amd64.tar.gz。

後續步驟