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

コンポーネントとは、個別にインストール可能な Google Cloud CLI の構成要素のことです。コマンドライン ツール（gcloud、bq、gsutil）、アルファ版 / ベータ版リリースレベルの gcloud CLI コマンドや、gcloud CLI の特定のツールとの依存関係を含むパッケージなどがあります。

最も一般的なコンポーネントは、デフォルトでインストールされます。gcloud alpha または gcloud beta コマンドをインタラクティブに実行する際に、alpha コンポーネントや beta コンポーネントがインストールされていない場合、インストールするかどうか尋ねるメッセージが gcloud CLI に表示されます。 インストールするように選択すると、コンポーネントがインストールされて、コマンドが実行されます。その他のコンポーネントは、それらを要求するコマンドを実行すると、gcloud CLI によってオンデマンドでインストールされます。

デフォルトのコンポーネント

gcloud CLI をインストールすると、次のコンポーネントがデフォルトでインストールされます。

アルファ版コンポーネントとベータ版コンポーネント

gcloud CLI には、gcloud CLI のアルファ版コマンドとベータ版コマンドを含む 2 つのコンポーネントが用意されています。これらのコンポーネントは、デフォルトではインストールされませんが、gcloud CLI の最初のインストールの完了後、いつでも手動でインストールできます。これらのコンポーネントは以下のとおり��す。

リリースレベルが一般提供の gcloud CLI コマンドは gcloud CLI コンポーネントの一部であるため、gcloud CLI をインストールすると自動的にインストールされます。

デフォルトでインストールされないすべての追加コンポーネントと外部パッケージ マネージャーのリストについては、以下をご覧ください。

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

必要に応じて、gcloud CLI のコンポーネントの一覧表示、インストール、更新、削除を行えます。

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

使用可能なコンポーネントと現在インストールされているコンポーネントのリストを表示するには、gcloud components list を実行します。

gcloud components list

次のサンプルは、使用可能なコンポーネントがすべて含まれているわけではありません。最新のコンポーネントを確認するには、gcloud CLI のインストールを更新し、gcloud components list を実行します。

コンポーネントをインストールする

現行バージョンの 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 と表示されます。

外部パッケージ マネージャ

apt または yum のパッケージ マネージャーを使用して gcloud CLI をインストールした場合は、追加の gcloud CLI コンポーネントも同じパッケージ マネージャーを使用してインストールできます。パッケージ マネージャーでこれらのパッケージが見つからない場合は、パッケージ ソースとして https://packages.cloud.google.com/ を構成する方法について、apt を使用したインストールまたは yum を使用したインストールをご確認ください。