Cloud de Confiance 用に Google Cloud CLI を設定する

このガイドでは、 Cloud de Confianceで使用するために Google Cloud CLI（gcloud CLI）を設定する手順について説明します。gcloud CLI を使用すると、コマンドラインから Cloud de Confianceリソースを作成して操作できます。

gcloud CLI の構成と使用に関する一般的な情報については、Google Cloud CLI のドキュメントをご覧ください。

Google Cloud での設定との違い

Google Cloud での CLI の設定と使用に精通している場合は、次の点に注意してください。

• このガイドで説明するように、 Cloud de Confianceで gcloud CLI を使用するには、追加の初期設定が必要です。
• Cloud Shell は Cloud de Confianceでは使用できません。gcloud CLI がローカルマシンにインストールされている必要があります。
• gcloud init を使用して gcloud CLI を 1 ステップで初期化することはできません。
• Cloud de Confianceで機能またはプロダクトを使用できない場合、対応する gcloud CLI コマンドとパラメータも使用できません。

始める前に

gcloud CLI を初めて設定するには、 Cloud de Confianceの独自のログイン情報に加えて、次のものが必要です。組織の管理者でない場合は、管理者にこの情報を提供してもらってください。

• 組織の Workload Identity プール名。
• 組織のID プロバイダ（IdP）。

gcloud CLI をインストールする

ご使用のオペレーティング システムの手順に沿って gcloud CLI をインストールします。

ログイン構成ファイルを作成する

ユニバースへのアクセスを設定するには、 Cloud de Confianceで使用されるドメインや組織用に設定された IdP など、gcloud CLI 用の JSON 構成ファイルを作成する必要があります。

ログイン構成ファイルを作成するには:

• 次のコマンドを実行します。

  gcloud config set universe_domain s3nsapis.fr
  
  AUDIENCE=locations/global/workforcePools/POOL_ID/providers/PROVIDER_ID
  UNIVERSE_WEB_DOMAIN="cloud.s3nscloud.fr"
  UNIVERSE_API_DOMAIN="s3nsapis.fr"
  
  gcloud iam workforce-pools create-login-config \
  $AUDIENCE \
  --universe-cloud-web-domain="$UNIVERSE_WEB_DOMAIN" \
  --universe-domain="$UNIVERSE_API_DOMAIN" \
  --output-file="wif-login-config.json"
  

  次のように置き換えます。

  • POOL_ID: 組織の Workload Identity プールの固有識別子。
  • PROVIDER_ID: 組織の ID プロバイダ（IdP）。

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

Created login configuration file [wif-login-config.json].

構成ファイルを作成したら、同じマシンからログインしている限り、この手順を繰り返す必要はありません。

gcloud CLI を使用して Cloud de Confiance にログインする

これで、 Cloud de Confianceにログインするたびに構成ファイルを使用できるようになりました。

• コマンドラインからログインするには、次のコマンドを実行します。

  gcloud auth login -–login-config=wif-login-config.json
  

• アプリケーションのデフォルト認証情報（ADC）（Terraform モジュールの実行に必要）を使用する必要がある場合は、次のコマンドを実行します。

  gcloud auth application-default login --login-config=wif-login-config.json
  

ログイン情報が入力できるウェブページが開きます。ログイン後、ドキュメントの残りの部分で説明するように、gcloud CLI を構成して使用できます。

（省略可）デフォルト プロパティを設定する

gcloud CLI を設定すると、default という構成が提供されます。この構成は、デフォルトのフラグ値を提供するプロパティや、ツールの動作を制御するプロパティに使用できます。省略可能ですが、ツールを使用する前に、デフォルト プロジェクトなど、gcloud CLI のデフォルト プロパティを構成することをおすすめします。デフォルトのプロパティは、コマンドを実行するたびにプロジェクトや優先コンピューティング ロケーションを指定する必要がない場合に便利です。

次の手順では、Google Cloud ユーザーに対して gcloud init によって構成されるのと同じプロパティを設定します。

1. デフォルト プロジェクトを設定するには、次のコマンドを実行して、選択したプロジェクト ID を指定します。

   gcloud config set project PROJECT_ID
   

2. Compute Engine または GKE を使用する場合、一部のコマンドではコンピューティングのリージョンまたはゾーンを指定する必要があります。コマンドのデフォルト リージョンを設定するには、次のコマンドを実行します。

   gcloud config set compute/region u-france-east1
   

   デフォルトのゾーンを設定するには、次のコマンドを実行します。

   gcloud config set compute/zone ZONE
   

3. 認証済みユーザーなど、現在の構成のプロパティを表示するには、次のコマンドを実行します。

   gcloud config list
   

gcloud CLI 構成の仕組みと、追加の構成を作成して使用する方法については、gcloud CLI 構成の管理をご覧ください。プロパティの指定の詳細については、gcloud CLI のプロパティを管理するをご覧ください。

（省略可）コマンドを実行する

主要なコマンドを実行して、gcloud CLI のインストールに関する情報を表示します。

1. 認証情報がローカル システムに保存されているアカウントを一覧表示します。

   gcloud auth list
   

   gcloud CLI は、認証されたアカウントのリストを表示します。

   Credentialed Accounts
   ACTIVE             ACCOUNT
   *                  principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com
   

2. アクティブな gcloud CLI 構成のプロパティを一覧表示します。

   gcloud config list
   

   gcloud CLI はプロパティのリストを返します。

   [core]
   account = principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com
   disable_usage_reporting = False
   project = my-project
   

3. gcloud コマンドやその他のトピックに関する情報を表示します。

   gcloud help
   

   たとえば gcloud compute instances create のヘルプを表示するには、次のようにします。

   gcloud help compute instances create
   

   gcloud CLI によって、コマンドの説明、コマンドフラグと引数のリスト、コマンドの使用方法の例などを含むヘルプトピックが表示されます。

次のステップ

• 管理者が Cloud de Confiance組織を初めて設定する場合は、組織を設定するで組織の設定方法をご覧ください。
• Google Cloud CLI でできることの詳細については、 Google Cloud CLI のドキュメントをご覧ください。
• Cloud de Confianceの使用を開始する方法については、 Cloud de Confianceの使用を開始するをご覧ください。