コンポーネントとは、個別にインストール可能な Google Cloud CLI の構成要素のことです。コマンドライン ツール（gcloud、bq、gsutil）、アルファ版 / ベータ版リリースレベルの gcloud CLI コマンドや、gcloud CLI の特定のツールとの依存関係を含むパッケージなどがあります。
最も一般的なコンポーネントは、デフォルトでインストールされます。gcloud alpha または gcloud beta コマンドをインタラクティブに実行する際に、alpha コンポーネントや beta コンポーネントがインストールされていない場合、インストールするかどうか尋ねるメッセージが gcloud CLI に表示されます。
インストールするように選択すると、コンポーネントがインストールされて、コマンドが実行されます。その他のコンポーネントは、それらを要求するコマンドを実行すると、gcloud CLI によってオンデマンドでインストールされます。
使ってみる
Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。
無料で開始デフォルトのコンポーネント
gcloud CLI をインストールすると、次のコンポーネントがデフォルトでインストールされます。
| ID | 名前 | 説明 |
|---|---|---|
gcloud |
デフォルトの gcloud CLI コマンド | Google Cloud を操作するためのツール。このコンポーネントと共にインストールされるのは、リリースレベルが一般提供かプレビューのコマンドだけです。その他のリリースレベルのコマンドを使用するには、gcloud alpha コマンドや gcloud beta コマンド コンポーネントを別途インストールする必要があります。 |
bq
| BigQuery コマンドライン ツール | BigQuery 内のデータを操作するためのツール |
gsutil |
Cloud Storage タスクを実行するための従来のツール。代わりに gcloud storage コマンドを使用してください。 |
|
core |
gcloud CLI コアライブラリ | gcloud CLI ツールが内部で使用するライブラリ。 |
アルファ版コンポーネントとベータ版コンポーネント
gcloud CLI には、gcloud CLI のアルファ版コマンドとベータ版コマンドを含む 2 つのコンポーネントが用意されています。これらのコンポーネントは、デフォルトではインストールされませんが、gcloud CLI の最初のインストールの完了後、いつでも手動でインストールできます。これらのコンポーネントは以下のとおりです。
| ID | 名前 | 説明 |
|---|---|---|
alpha |
gcloud CLI アルファ版コマンド | リリースレベルがアルファ版の gcloud CLI コマンド。 |
beta |
gcloud CLI ベータ版コマンド | リリースレベルがベータ版の gcloud CLI コマンド。 |
リリースレベルが一般提供の gcloud CLI コマンドは gcloud CLI コンポーネントの一部であるため、gcloud CLI をインストールすると自動的にインストールされます。
デフォルトでインストールされないすべての追加コンポーネントと外部パッケージ マネージャーのリストについては、以下をご覧ください。
gcloud CLI のコンポーネントの管理
必要に応じて、gcloud CLI のコンポーネントの一覧表示、インストール、更新、削除を行えます。
注: APT やyum などのパッケージ管理システムを使用して gcloud CLI をインストールしている場合、これらの手順は動作しません。この方法でインストールした場合には gcloud CLIコンポーネント・マネージャが無効になっているためです。代わりに、こちらのパッケージを使用してください。
コンポーネントの一覧を表示する
使用可能なコンポーネントと現在インストールされているコンポーネントのリストを表示するには、gcloud components list を実行します。
gcloud components list
次のサンプルは、使用可能なコンポーネントがすべて含まれているわけではありません。最新のコンポーネントを確認するには、gcloud CLI のインストールを更新し、gcloud components list を実行します。
| ステータス | コンポーネント名 | ID | サイズ |
|---|---|---|---|
| インストール済み | App Engine Go 拡張機能 | app-engine-go | 97.7 MiB |
| インストールされていません | AppCtl | appctl | 21.0 MiB |
| インストール済み | Cloud Bigtable コマンドライン ツール | cbt | 4.0 MiB |
| インストール済み | Cloud Bigtable Emulator | bigtable | 3.8 MiB |
| インストール済み | Cloud Datastore エミュレータ | cloud-datastore-emulator | 17.8 MiB |
| インストールされていません | Cloud Firestore エミュレータ | cloud-firestore-emulator | 60.4 MiB |
| インストール済み | Cloud Pub/Sub Emulator | pubsub-emulator | 33.2 MiB |
| インストール済み | Cloud SQL Proxy | cloud_sql_proxy | 7.6 MiB |
| インストール済み | Cloud Spanner エミュレータ | cloud-spanner-emulator | 21.8 MiB |
| インストール済み | Google Cloud Build のローカル ビルダー | cloud-build-local | 4.4 MiB |
| インストール済み | gcloud App Java Extensions | app-engine-java | 118.9 MiB |
| インストール済み | gcloud app PHP 拡張機能 | app-engine-php | 21.9 MiB |
| インストール済み | gcloud app Python Extensions（追加ライブラリ） | app-engine-python-extras | 27.8 MiB |
| インストール済み | kubectl | kubectl | 12.2 MiB |
| インストール済み | Cloud BigQuery コマンドライン ツール | bq | < 1 MiB |
| インストール済み | Cloud SDK Core Libraries | core | 7.2 MiB |
| インストール済み | Cloud Storage コマンドライン ツール | gsutil | 3.3 MiB |
| インストール済み | gcloud Alpha Commands | alpha | < 1 MiB |
| インストール済み | gcloud Beta Commands | ベータ版 | < 1 MiB |
| インストール済み | gcloud App Python Extensions | App Engine（Python） | 6.1 MiB |
コンポーネントをインストールする
現行バージョンの gcloud CLI でコンポーネントをインストールするには、gcloud components install を実行します。
gcloud components install [COMPONENT-ID]
gcloud CLI により、指定したコンポーネントがインストールされます。
たとえば、kubectl コマンドをインストールするには次のように指定します。
gcloud components install kubectl
コンポーネントを更新する
gcloud components update コマンドを使用して、インストールされているすべてのコンポーネントを、使用可能な最新バージョンの gcloud CLI に更新します。
gcloud components update
古いバージョンの gcloud CLI がインストールされている場合、インストールされているすべてのコンポーネントが gcloud CLI によって更新されます。
以前正常に動作していたバージョンに戻す必要があり、gcloud CLI を直接インストール（パッケージ マネージャーではなく、インタラクティブ インストーラ、静的バージョン、Windows インストーラ、Homebrew などを使用して）している場合は、gcloud components update を使用して、指定したバージョンに戻します。
gcloud components update --version VERSION
apt-get または yum を使用してダウンロードするときにバージョンを指定するための手順を参照してください。
コンポーネントを削除する
コンポーネントを削除するには、ID を指定して gcloud components remove コマンドを実行します。
gcloud components remove [COMPONENT-ID]
コンポーネントは、いつでも gcloud components install コマンドを使用して再インストールできます。
追加コンポーネント
gcloud CLI コマンドの依存関係を含む追加コンポーネントは gcloud CLI でも利用できますが、デフォルトではインストールされません。コンポーネントすべてのリストについては、gcloud components list を実行してください。インストール可能な追加コンポーネントは、ステータスが Not Installed と表示されます。
外部パッケージ マネージャ
apt または yum のパッケージ マネージャーを使用して gcloud CLI をインストールした場合は、追加の gcloud CLI コンポーネントも同じパッケージ マネージャーを使用してインストールできます。パッケージ マネージャーでこれらのパッケージが見つからない場合は、パッケージ ソースとして https://packages.cloud.google.com/ を構成する方法について、apt を使用したインストールまたは yum を使用したインストールをご確認ください。
| gcloud CLI コンポーネント | APT パッケージ | YUM パッケージ |
|---|---|---|
app-engine-go |
google-cloud-cli-app-engine-go |
google-cloud-cli-app-engine-go |
app-engine-java |
google-cloud-cli-app-engine-java |
google-cloud-cli-app-engine-java |
app-engine-python |
google-cloud-cli-app-engine-python |
google-cloud-cli-app-engine-python |
bigtable |
google-cloud-cli-bigtable-emulator |
google-cloud-cli-bigtable-emulator |
cbt |
google-cloud-cli-cbt |
google-cloud-cli-cbt |
cloud-build-local |
google-cloud-cli-cloud-build-local |
google-cloud-cli-cloud-build-local |
docker-credential-gcr |
まだ提供されていません。 | まだ提供されていません。 |
gcd-emulator |
google-cloud-cli-datastore-emulator |
google-cloud-cli-datastore-emulator |
kubectl |
kubectl |
kubectl |
pubsub-emulator |
google-cloud-cli-pubsub-emulator |
google-cloud-cli-pubsub-emulator |