プロパティとは、gcloud
コマンドライン ツールなどの Cloud SDK ツールの動作を制御する設定です。
プロパティを使用して、プロダクトやサービスの設定を定義できます。たとえば、gcloud
ツールや他の Cloud SDK ツールが承認に使用するアカウントや Compute Engine リソースを操作するときに使用するデフォルト リージョンを指定できます。また、Cloud SDK コンポーネントの自動更新を無効にすることもできます。プロパティは、gcloud
ツールコマンドの詳細レベルやプロンプトの構成など、gcloud
ツールの設定を定義する際にも使用できます。
プロパティとフラグ
gcloud
ツールでは、Cloud SDK プロパティと同じ効果を持つグローバル フラグとコマンドフラグがいくつかサポートされています。たとえば、gcloud
ツールでは --project
フラグと project
プロパティの両方をサポートしています。プロパティを使用すると、コマンドの実行中に同じ設定を維持できます。コマンドを呼び出すたびに、フラグによってコマンドの動作が制御されます。両方を設定すると、フラグによってプロパティがオーバーライドされます。
構成
構成とは、Cloud SDK の一連のプロパティに名前を付けたものです。gcloud
ツールは、最初の有効な構成として default
という名前の構成を使用します。default
はほとんどのユースケースに適した構成です。追加の構成を作成して、必要に応じて切り替えることもできます。
プロパティのリスト表示
アクティブな構成の中のプロパティを一覧表示するには、gcloud config list
を実行します。
gcloud config list
gcloud
ツールはプロパティのリストを返します。
[compute] region = us-east1 zone = us-east1-d [core] account = user@google.com disable_usage_reporting = False project = example-project [metrics] command_name = gcloud.config.list
プロパティの設定
アクティブな構成の中のプロパティを設定するには、gcloud config set
を実行します。
gcloud config set project [PROJECT]
core
プロパティ セクションに含まれていないプロパティを設定するには、セクションを指定し、続けてスラッシュとプロパティ名を指定する必要があります。
gcloud config set compute/zone us-east1-b
環境変数を使用してプロパティを設定する
環境変数を使用してプロパティを設定することもできます。各プロパティには、その設定に使用できる対応する環境変数があります。環境変数の名前は、CLOUDSDK_SECTION_NAME_PROPERTY_NAME
パターンに従います。たとえば、core/project
プロパティと compute/zone
プロパティは次のように設定できます。
CLOUDSDK_CORE_PROJECT=[YOUR_PROJECT_NAME]
CLOUDSDK_COMPUTE_ZONE=[YOUR_ZONE_NAME]
プロパティの設定解除
アクティブな構成の中のプロパティを設定解除するには、gcloud config unset
を使用します。
gcloud config unset disable_usage_reporting
使用可能なプロパティ
すべてのプロパティのリストを表示するには、gcloud topic configurations
またはgcloud config set --help
を実行して、[Available Properties] セクションを探します。
次のステップ
- 構成について詳しくは、Cloud SDK の構成をご覧ください。