このページでは、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 を初期化するには:
gcloud init
を実行します。gcloud init
リモート ターミナル セッションを使用している場合は、必要に応じて
--no-launch-browser
フラグを使用して、ブラウザベースの承認フローが開始されないようにすることができます。gcloud init --no-launch-browser
プロンプトが表示されたら、構成を作成または選択します。
新しい gcloud CLI 環境を初期化する場合は、
gcloud init
によりdefault
という名前の構成が自動的に作成されて、アクティブな構成として設定されます。既存の構成がある場合、gcloud init
によりオプションの選択を求めるプロンプトが表示されます。選択できるオプションは、アクティブな構成の再初期化、別の構成への切り替え、新しい構成の作成、のいずれかです。プロンプトが表示されたら、承認ステップを完了します。
Google Cloud へのアクセスがすでに承認されているかどうかに応じて、ウェブブラウザでログインしてアクセスを許可するように求められるか、既存のアカウントを選択するように求められます。
--no-launch-browser
フラグを使用した場合にログインを求められたら、指定された承認 URL をコピーして別のブラウザ ウィンドウに貼り付けて、表示されるプロンプトに沿って操作する必要があります。このステップが完了すると、
gcloud init
により、構成のaccount
プロパティが指定したアカウントに設定されます。入力を求められたら、現在の 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:
プロンプトが表示されたら、Compute Engine のデフォルトのゾーンを選択します。
Compute Engine API を有効にしていない場合や、プロジェクト レベルのメタデータにすでにデフォルトのゾーンがある場合は、このステップは表示されません。
gcloud init
により、構成のregion
およびzone
プロパティが、選択したゾーンで設定されます。
gcloud init
コマンドで設定されたプロパティを表示するには、gcloud config list
コマンドを使用します。
[compute] region = us-east1 zone = us-east1-b [core] account = dana@example.com disable_usage_reporting = False project = example-project
次のステップ
- ツールの認可の詳細については、gcloud CLI の承認をご覧ください。
- Cloud クライアント ライブラリ(および Google API クライアント ライブラリ)のアプリケーションのデフォルト認証情報(ADC)の承認する詳細については、ADC の認証情報を指定する方法をご覧ください。
- 構成を管理する詳細については、gcloud CLI の構成をご覧ください。
- プロパティを管理する詳細については、gcloud CLI のプロパティをご覧ください。