コンポーネントとは、個別にインストール可能な Google Cloud CLI の構成要素のことです。コンポーネント
には、コマンドライン ツール（gcloud、bq、gsutil）、アルファ版、ベータ版、プレビュー
リリースレベルの gcloud CLI コマンド、gcloud CLI の特定のツールとの依存関係を含むパッケージなどがあります。
最も一般的なコンポーネントは、デフォルトでインストールされます。
gcloud alpha、gcloud beta、または gcloud preview コマンドをインタラクティブに実行する際に、alpha コンポーネント、beta コンポーネント、または preview
コンポーネントがインストールされていない場合、インストールするかどうかを gcloud CLI が尋ねます。インストールするように選択すると、コンポーネントがインストールされて、コマンドが実行されます。その他のコンポーネントは、それらを要求するコマンドを実行すると、gcloud CLI によってオンデマンドでインストールされます。
デフォルトのコンポーネント
gcloud CLI をインストールすると、次のコンポーネントがデフォルトでインストールされます。
| ID | 名前 | 説明 |
|---|---|---|
gcloud |
デフォルトの gcloud CLI コマンド | とやり取りするためのツール Cloud de Confiance。このコンポーネントとともにインストールされるのは、リリースレベルが一般提供のコマンド
だけです。その他のリリースレベルのコマンドを使用するには、gcloud alpha
コマンド、gcloud beta コマンド、gcloud preview コマンド コンポーネントを別途インストールする必要があります。 |
bq
| BigQuery コマンドライン ツール | BigQuery 内のデータを操作するためのツール |
gsutil |
Cloud Storage タスクを実行するためのレガシー ツール。代わりに
gcloud storage コマンド
を使用してください。 |
|
core |
gcloud CLI コアライブラリ | gcloud CLI ツールが内部で使用するライブラリ。 |
アルファ版、ベータ版、プレビュー版のコンポーネント
gcloud CLI には、gcloud CLI のアルファ版、ベータ版、プレビュー版のコマンドを含むコンポーネントが用意されています。これらのコンポーネントは、デフォルトではインストールされませんが、gcloud CLI の最初のインストールの完了後、いつでも手動でインストールできます。これらのコンポーネントは以下のとおりです。
| ID | 名前 | 説明 |
|---|---|---|
alpha |
gcloud CLI アルファ版コマンド | リリースレベルがアルファ版の gcloud CLI コマンド。 |
beta |
gcloud CLI ベータ版コマンド | リリースレベルがベータ版の gcloud CLI コマンド。 |
preview |
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 |
| インストール済み | 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 拡張機能（追加ライブラリ） | 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 Preview 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
コンポーネントを削除する
コンポーネントを削除するには、ID を指定して gcloud components remove コマンドを実行します。
gcloud components remove [COMPONENT-ID]
コンポーネントは、いつでも gcloud components install コマンドを使用して再インストールできます。
追加コンポーネント
gcloud CLI コマンドの依存関係を含む追加コンポーネントも gcloud CLI で利用できますが、デフォルトではインストールされません。コンポーネントすべてのリストについては、gcloud components list を実行してください。インストール可能な追加コンポーネントは、ステータスが Not Installed と表示されます。