gcloud CLI の初期化

このページでは、gcloud CLI を初期化する方法について説明します。

gcloud CLI をインストールした後、gcloud init を実行して初期設定タスクを行います。gcloud init を実行して設定を変更することや、新しい構成を作成することもできます。

gcloud init によって実行される設定手順は次のとおりです。

  • gcloud CLI を承認し、お使いのユーザー アカウント認証情報で Google Cloud にアクセスするようにします。すでにアクセスが承認されている場合はアカウントを選択できます。
  • gcloud CLI の構成をセットアップし、一連の基本プロパティを設定します。たとえば、上記のステップで設定した有効なアカウント、現在のプロジェクト、Google Compute Engine のデフォルトのリージョンとゾーン(該当する場合)などです。

gcloud init の代わりに次のコマンドを実行することもできます。

コマンド 説明
gcloud auth login 設定を作成せずにユーザー アカウントを使用して承認を行います。
gcloud auth activate-service-account ユーザー アカウントではなくサービス アカウントを使用して承認を行います。
インタラクティブではなくウェブブラウザを使用しない承認に役立ちます。
gcloud config [COMMAND]
gcloud config configurations [COMMAND]
gcloud CLI の構成とプロパティを作成および管理します。

gcloud CLI を初期化します。

gcloud CLI を初期化するには:

  1. gcloud init を実行します。

    gcloud init
    

    リモート ターミナル セッションを使用している場合は、必要に応じて --no-launch-browser フラグを使用して、ブラウザベースの承認フローが開始されないようにすることができます。

    gcloud init --no-launch-browser
    
  2. プロンプトが表示されたら、構成を作成または選択します。

    新しい gcloud CLI 環境を初期化する場合は、gcloud init により default という名前の構成が自動的に作成されて、アクティブな構成として設定されます。既存の構成がある場合、gcloud init によりオプションの選択を求めるプロンプトが表示されます。選択できるオプションは、アクティブな構成の再初期化、別の構成への切り替え、新しい構成の作成、のいずれかです。

  3. プロンプトが表示されたら、承認ステップを完了します。

    Google Cloud へのアクセスがすでに承認されているかどうかに応じて、ウェブブラウザでログインしてアクセスを許可するように求められるか、既存のアカウントを選択するように求められます。

    --no-launch-browser フラグを使用した場合にログインを求められたら、指定された承認 URL をコピーして別のブラウザ ウィンドウに貼り付けて、表示されるプロンプトに沿って操作する必要があります。

    このステップが完了すると、gcloud init により、構成の account プロパティが指定したアカウントに設定されます。

  4. 入力を求められたら、現在の Google Cloud プロジェクトを選択します。

    アクセスできるプロジェクトが(ユーザー アカウントのデフォルト プロジェクトを含め)1 つしかない場合は、そのプロジェクトが gcloud init によって自動的に選択されます。

    それ以外の場合は、オーナー編集者閲覧者の権限が付与されているプロジェクトのリストからプロジェクトを選択できます。gcloud init により、構成の project プロパティが選択したプロパティに設定されます。200 を超えるプロジェクトにアクセスする場合は、プロジェクト ID の入力、新規プロジェクトの作成、プロジェクトの一覧表示を求めるプロンプトが表示されます。

    This account has a lot of projects! Listing them all can take a while.
     [1] Enter a project ID
     [2] Create a new project
     [3] List projects
    Please enter your numeric choice:
    
  5. プロンプトが表示されたら、Compute Engine のデフォルトのゾーンを選択します。

    Compute Engine API を有効にしていない場合や、プロジェクト レベルのメタデータにすでにデフォルトのゾーンがある場合は、このステップは表示されません。gcloud init により、構成の region および zone プロパティが、選択したゾーンで設定されます。

gcloud init コマンドで設定されたプロパティを表示するには、gcloud config list コマンドを使用します。

[compute]
region = us-east1
zone = us-east1-b
[core]
account = [email protected]
disable_usage_reporting = False
project = example-project

次のステップ

  • ツールの認可の詳細については、gcloud CLI の承認をご覧ください。
  • Cloud クライアント ライブラリ(および Google API クライアント ライブラリ)のアプリケーションのデフォルト認証情報(ADC)の承認する詳細については、ADC の認証情報を指定する方法をご覧ください。
  • 構成を管理する詳細については、gcloud CLI の構成をご覧ください。
  • プロパティを管理する詳細については、gcloud CLI のプロパティをご覧ください。