gdcloud CLI の概要

この概要ドキュメントでは、gdcloud CLI、その利点、インストール ワークフロー、Google Distributed Cloud（GDC）エアギャップ環境での運用ニーズに最適な構成方法について説明します。

このドキュメントは、エアギャップ ハードウェアとソフトウェアのワークフローに専用のコマンドライン インターフェース ツールを使用する必要がある GDC を使用するすべてのユーザーを対象としています。 詳細については、 GDC エアギャップ ドキュメントの対象読者をご覧ください。

gdcloud CLI とは

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

gdcloud CLI を使用すると、インフラストラクチャのブートストラップ、認証の管理、ローカル構成のカスタマイズを行うことができます。

gdcloud CLI をダウンロードしてインストールする

gdcloud CLI の使用を開始するには:

  1. バンドルをダウンロードします。
  2. ツールをインストールします。
  3. 構成を初期化します。

現在の gdcloud CLI のバージョンは 1.16 です。以前のバージョンの gdcloud CLI は、ダウンロード アーカイブからダウンロード してインストールできます。

プロパティ

gdcloud CLI のプロパティは、gdcloud CLI ツールの動作に影響を与える設定です。

ユーザー補助機能の有効化

スクリーン リーダーの利便性を向上させるために、gdcloud CLI には accessibility/screen_reader プロパティが付属しています。

ユーザー補助プロパティを有効にするには、次のように実行します。

gdcloud config set accessibility/screen_reader true

gdcloud CLI に付属のユーザー補助機能の詳細については、ユーザー補助機能の有効化ガイドをご覧ください。

構成

構成とは、gdcloud CLI のプロパティのセットです。構成は「プロファイル」のように機能します。

gdcloud CLI の使用を開始する際に、単一の 構成（名前は default）を使用します。gdcloud init または gdcloud config set コマンドを実行することで、プロパティを設定できます。ほとんどのユースケースでは、default 構成で十分です。

複数のプロジェクトや組織で作業する場合は、gdcloud config configurations create を使用して複数の構成を設定し、構成を切り替えることができます。構成内ではプロパティをカスタマイズできます。たとえば、有効な構成内でプロジェクトを設定するには、プロジェクト プロパティを次のように使用します。

gdcloud config set project PROJECT_ID

これらのコンセプトの詳細については、 gdcloud CLI 構成の管理をご覧ください。

利用可能な gdcloud CLI バンドル

GDC では、さまざまなオペレーティング システム（OS）とダウンロード サイズをサポートするために、複数の gdcloud CLI バンドルオプションを提供しています。環境とロールの要件に基づいて適切なバンドルを選択してください。

プラットフォーム パッケージ名 gdcloud コマンドのサポート
Linux - 64 ビット（x86_64） gdcloud_cli_linux_amd64_VERSION.tar.gz すべての gdcloud コマンド。
Linux Lite - 64 ビット（x86_64） gdcloud_cli_linux_amd64_lite_VERSION.tar.gz 次のコマンドグループは除きます。
  • gdcloud appliance
  • gdcloud system
macOS - 64 ビット（ARM64、Apple シリコン） gdcloud_cli_darwin_arm64_VERSION.tar.gz 次のコマンドグループは除きます。
  • gdcloud appliance
  • gdcloud kms
  • gdcloud system
macOS - 64 ビット（x86_64） gdcloud_cli_darwin_amd64_VERSION.tar.gz 次のコマンドグループは除きます。
  • gdcloud appliance
  • gdcloud kms
  • gdcloud system
Windows - 64 ビット（x86_64） gdcloud_cli_windows_amd64_VERSION.tar.gz 次のコマンドグループは除きます。
  • gdcloud appliance
  • gdcloud kms
  • gdcloud system

利用可能なすべての gdcloud CLI コマンドの詳細については、 gdcloud CLI リファレンス ドキュメントをご覧ください。

次のステップ