NAME
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_region
* S3 ストレージ バケットが配置されている S3 リージョンの名前。デフォルトは us-east-1 です。
* s3_secret_access_key
* リクエストの署名に使用される S3 ストレージ オブジェクトの秘密鍵。