コンポーネントは、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 Datastore エミュレータ | 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 |