名前
gdcloud topic configurations - 名前付き構成の補足ヘルプ。
説明
gdcloud CLI のプロパティは、名前付き構成に保存できます。名前付き構成は、gdcloud CLI の動作に影響を与える Key-Value ペアのコレクションです。名前付き構成は、複数のプロジェクトまたは組織を管理する場合に便利です。構成に保存される一般的なプロパティには、組織コンソールの URL やプロジェクト ID などがあります。構成を使用すると、これらの設定やその他の設定をグループとして定義し、有効にすることができます。構成データは $HOME/.config/gdcloud/
に保存されます。構成は、次のような場合に特に便利です。+ 複数のプロジェクトを扱う。プロジェクトごとに個別の構成を作成できます。- 複数の組織コンソール URL を使用する。
* 独立したタスクを実行する たとえば、1 つの構成を使用して、1 つのプロジェクトの Object Storage サービスを操作し、別のプロジェクトの関連のないサービスを管理できます。名前付き構成に保存されたプロパティ情報は、すべての gdcloud CLI コマンドで読み取ることができます。プロパティを設定するには、gdcloud config set
コマンドを使用します。
構成を作成
名前付き構成は、ユーザーが定義することも、gdcloud CLI に組み込むこともできます。ユーザー定義の構成には、johndoe
、default
、jeff-staging
、foo2
などの小文字の名前が付けられます。これらは、次の正規表現 ^[a-z][-a-z0-9]*$
で定義されます。新しい構成を作成するには、
gdcloud init
このガイドでは、最初の名前付き構成の設定、新しい名前付き構成の作成、既存の名前付き構成の再初期化について説明します。既存の構成を再初期化すると、既存のプロパティがすべて削除されます。
新しい空の構成を作成するには、
gdcloud config configurations create [CONFIG_NAME]
構成を使用する
gdcloud CLI には、プロパティ値を提供するアクティブな構成が 1 つ以下である必要があります。非アクティブな構成は、gdcloud CLI の実行に影響しません。構成を有効にするには、
gdcloud config configurations activate [CONFIG_NAME]
アクティブな構成のプロパティを表示して変更するには、
gdcloud config list
gdcloud config set
また、gdcloud config configurations
グループのコマンドを使用すると、有効な構成と有効でない構成を一覧表示、有効化、名前変更、説明、削除できます。
フラグ --configuration my-config
を使用して、1 回の gdcloud 呼び出しで構成を有効にできます。
使用可能なプロパティ
accessibility
* screen_reader
* 設定されている場合、gdcloud CLI はスクリーン リーダーを有効にします。
auth
* login_config_cert_path
* 現在のログイン構成証明書を保存するファイルのパス。
component_manager
* disable_update_check
* 設定すると、gdcloud CLI は自動的に更新を確認しません。
core
* disable_prompts
* True の場合、すべてのユーザー プロンプトでデフォルトの回答が想定されます。ただし、ユーザー入力が必要なプロンプトについては、エラーが発生します。* format
* コマンド出力リソースの印刷形式を設定します。デフォルトは、コマンド固有の人間が読みやすい出力形式です。core/format
と --format
の両方が指定されている場合は、--format
が優先されます。サポートされている形式は、csv
、json
、table
、text
、yaml
に限定されます。* organization_console_url
* 現在の組織の UI/コンソールの URL。先頭は https //console.
であることにご注意ください。例: https //console.org-name.gdch.google.com
。* project
* 現在のプロジェクト名。
storage
* s3_access_key_id
* S3 ストレージ オブジェクトのアクセスキー ID。ユーザーの一意の識別子です。* s3_custom_ca_certs_file
* S3 ストレージ オブジェクトのカスタム証明書ファイル。* s3_endpoint
* S3 オブジェクトの URL は S3_ENDPOINT/$BUCKET_NAME/$OBJECT_NAME
で構成されています。S3_ENDPOINT
は、S3 ストレージ バケットが配置されているロケーションです。* s3_secret_access_key
* リクエストの署名に使用される S3 ストレージ オブジェクトの秘密鍵。