gcloud CLI のコンポーネントの管理

コンポーネントとは、個別にインストール可能な Google Cloud CLI の構成要素のことです。コマンドライン ツール(gcloudbqgsutil)、アルファ版 / ベータ版リリースレベルの 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 アルファ < 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
パッケージ マネージャーを使用してインストールされた gcloud CLI のバージョンをダウングレードする場合は、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