gcloud CLI コンポーネントを管理する

コンポーネントは、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 コマンドライン ツール Cloud 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 コンポーネントは、必要に応じてリスト、インストール、更新、削除できます。

コンポーネントの一覧を表示する

使用可能なコンポーネントと現在インストールされているコンポーネントのリストを表示するには、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 ローカル 4.4 MiB
インストール済み gcloud App Java Extensions app-engine-java 118.9 MiB
インストール済み gcloud app PHP 拡張機能 App Engine エンジン 21.9 MiB
インストール済み gcloud app Python 拡張機能（追加ライブラリ） 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

コンポーネントを更新する

インストールされている Cloud SDK のすべてのコンポーネントを、使用可能な最新バージョンに更新するには、gcloud components update コマンドを使用します。

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