gdcloud CLI を使用する

gdcloud CLI は、Google Distributed Cloud（GDC）のエアギャップ リソースの作成と管理を行うための一連のツールです。これらのツールを使用すると、コマンドラインから、またはスクリプトや自動化を通じて、一般的なタスクを実行できます。gdcloud CLI を使用すると、インフラストラクチャのブートストラップ、認証の管理、ローカル構成のカスタマイズを行うことができます。

このドキュメントは、エアギャップされたハードウェアとソフトウェアのワークフローを管理するために GDC の専用 CLI を設定する必要があるすべてのユーザー グループを対象としています。詳細については、GDC エアギャップの対象ユーザーに関するドキュメントをご覧ください。

始める前に

  • GDC コンソールにアクセスできることを確認し、組織の URL をメモします。詳細については、GDC コンソールへのアクセスをご覧ください。

  • システムの信頼できる証明書ストアにインストールされている認証局（CA）証明書があることを確認します。詳細については、GDC 信頼バンドルを取得するをご覧ください。

  • 組織外の特定の CIDR からアーティファクト レジストリへのトラフィックを許可する組織のネットワーク ポリシーがあることを確認します。たとえば、OrganizationNetworkPolicy リソースでサービス名 all を構成します。詳細については、組織のネットワーク ポリシーを作成するをご覧ください。

  • デバイスにブラウザがインストールされていることを確認します。

gdcloud CLI を設定する

gdcloud CLI を設定するには、次の操作を行います。

  1. ブラウザに組織のグローバル URL またはゾーン URL を入力して、GDC コンソールを開きます。

  2. ホームページで [Download CLI Bundle] を選択します。

  3. GDC 環境に対応する Linux プラットフォームと gdcloud CLI バンドル バージョンを選択します。

    Linux 以外のプラットフォームを選択した場合、構成手順が若干異なることがあります。また、Linux 以外の gdcloud CLI バンドルでは、gdcloud コマンドのサブセットのみが提供されることに注意してください。詳細については、使用可能な gdcloud CLI バンドルをご覧ください。

  4. [ダウンロード] をクリックします。

  5. デバイスで Downloads フォルダに移動します。

    cd ~/Downloads

  6. gdcloud CLI バンドルの内容を抽出します。

    tar -xf ./gdcloud_cli.tar.gz

  7. gdcloud CLI バンドルをパスに追加します。

    eval echo 'export GDCLOUD_PATH=$(pwd)/google-distributed-cloud-hosted-cli' >> ~/.bashrc
echo 'export PATH="$GDCLOUD_PATH/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

  8. gdcloud CLI が正しくインストールされていることを確認します。

    gdcloud version

    出力は次のようになります。

    gdcloud version: 1.15.0-gdch.380608

  9. gdcloud CLI を初期化します。

    gdcloud init

  10. プロンプトが表示された 2 つのプロパティを指定して、初期化を完了します。

    • organization_console_url: 現在の GDC 組織のコンソールの URL。この URL はグローバルまたはゾーンにできます。例: https://console.org-1.google.gdch.test/

    • project: GDC プロジェクトの名前。既存のプロジェクトがない場合は、default を使用します。

    初期化後に gdcloud CLI 構成を更新するには、gdcloud CLI 構成を管理するをご覧ください。

  11. gdcloud-k8s-auth-plugin コンポーネントをインストールします。

    gdcloud components install gdcloud-k8s-auth-plugin

  12. gdcloud CLI で認証してログインします。

    gdcloud auth login

    ブラウザにリダイレクトされ、ID を選択してログインします。

  13. 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

次のステップ