SDK コンポーネントの管理

コンポーネントとは

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

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

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

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

ID 名前 説明
gcloud デフォルトの gcloud CLI コマンド Google Cloud を操作するためのツール。このコンポーネントと共にインストールされるのは、リリースレベルが一般提供かプレビューのコマンドだけです。その他のリリースレベルのコマンドを使用するには、gcloud alpha コマンドや gcloud beta コマンド コンポーネントを別途インストールする必要があります。
bq BigQuery Command-Line Tool Google BigQuery 内のデータを操作するためのツール。
gsutil Cloud Storage Command-Line Tool Google Cloud Storage に関連するタスクを実行するためのツール。
core Cloud SDK Core Libraries SDK ツールが内部で使用するライブラリ。

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

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

ID 名前 説明
alpha gcloud CLI アルファ版コマンド リリースレベルがアルファ版の gcloud CLI コマンド。
beta gcloud CLI ベータ版コマンド リリースレベルがベータ版の gcloud CLI コマンド。

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

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

Cloud SDK のコンポーネントの管理

必要に応じて、Google Cloud SDK のコンポーネントの一覧表示、インストール、更新、削除を行うことができます。

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

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

gcloud components list
┌──────────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                                  Components                                          │
├───────────────┬───────────────────────────────────────────────┬──────────────────────────┬───────────┤
│     Status    │                         Name                  │            ID            │    Size   │
├───────────────┼───────────────────────────────────────────────┼──────────────────────────┼───────────┤
│ Installed     │ App Engine Go Extensions                      │ app-engine-go            │  97.7 MiB │
│ Installed     │ Cloud Bigtable Command Line Tool              │ cbt                      │   4.0 MiB │
│ Installed     │ Cloud Bigtable Emulator                       │ bigtable                 │   3.8 MiB │
│ Installed     │ Cloud Datalab Command Line Tool               │ datalab                  │   < 1 MiB │
│ Installed     │ Cloud Datastore Emulator                      │ cloud-datastore-emulator │  17.8 MiB │
│ Installed     │ Cloud Datastore Emulator (Legacy)             │ gcd-emulator             │  38.1 MiB │
│ Installed     │ Cloud Pub/Sub Emulator                        │ pubsub-emulator          │  33.2 MiB │
│ Installed     │ Emulator Reverse Proxy                        │ emulator-reverse-proxy   │  14.5 MiB │
│ Installed     │ Google Cloud Build Local Builder              │ cloud-build-local        │   4.4 MiB │
│ Installed     │ gcloud app Java Extensions                    │ app-engine-java          │ 118.9 MiB │
│ Installed     │ gcloud app PHP Extensions                     │ app-engine-php           │  21.9 MiB │
│ Installed     │ gcloud app Python Extensions (Extra Libraries)│ app-engine-python-extras │  27.8 MiB │
│ Installed     │ kubectl                                       │ kubectl                  │  12.2 MiB │
│ Installed     │ BigQuery Command Line Tool                    │ bq                       │   < 1 MiB │
│ Installed     │ Cloud SDK Core Libraries                      │ core                     │   7.2 MiB │
│ Installed     │ Cloud Storage Command Line Tool               │ gsutil                   │   3.3 MiB │
│ Installed     │ gcloud Alpha Commands                         │ alpha                    │   < 1 MiB │
│ Installed     │ gcloud Beta Commands                          │ beta                     │   < 1 MiB │
│ Installed     │ gcloud app Python Extensions                  │ app-engine-python        │   6.1 MiB │
└───────────────┴───────────────────────────────────────────────┴──────────────────────────┴───────────┘

上の出力は完全なリストではなく、使用可能なコンポーネントがすべて含まれているわけではありません。最新のコンポーネントを確認するには、インストールされている Cloud SDK を更新し、gcloud components list を実行します。

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

現在インストールされている Cloud SDK のバージョンのコンポーネントをインストールするには、gcloud components install を実行します。

gcloud components install [COMPONENT-ID]

gcloud CLI により、指定したコンポーネントがインストールされます。

たとえば、kubectl コマンドをインストールするには次のように指定します。

gcloud components install kubectl

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

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

gcloud components update

旧バージョンの Cloud SDK がインストールされている場合、インストールされているすべてのコンポーネントが、gcloud CLI によって更新されます。

SDK を直接インストールしており(パッケージ マネージャーを使用せずに、インタラクティブ インストーラ、静的バージョン、Windows インストーラ、Homebrew などを使用)、以前に正しく動作していたバージョンに戻す必要がある場合は、gcloud components update を使用して、指定したバージョンに戻すことができます。

gcloud components update --version VERSION

パッケージ マネージャーを介してインストールされた Cloud SDK のバージョンをダウングレードする場合は、apt-get または yum を使ってダウンロードするときにバージョンを指定する方法をご確認ください。

コンポーネントを削除する

コンポーネントを削除するには、ID を指定して gcloud components remove コマンドを実行します。

gcloud components remove [COMPONENT-ID]

コンポーネントは、いつでも gcloud components install コマンドを使用して再インストールできます。

追加コンポーネント

さまざまな gcloud CLI コマンドの依存関係を含む追加コンポーネントも SDK で利用できますが、デフォルトではインストールされません。コンポーネントの全リストを表示するには、$ gcloud components list を実行します。インストール可能な追加コンポーネントはステータスが Not Installed と表示されます。

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

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

Cloud SDK コンポーネント APT パッケージ YUM パッケージ
app-engine-go google-cloud-sdk-app-engine-go google-cloud-sdk-app-engine-go
app-engine-java google-cloud-sdk-app-engine-java google-cloud-sdk-app-engine-java
app-engine-python google-cloud-sdk-app-engine-python google-cloud-sdk-app-engine-python
bigtable google-cloud-sdk-bigtable-emulator google-cloud-sdk-bigtable-emulator
cbt google-cloud-sdk-cbt google-cloud-sdk-cbt
cloud-build-local google-cloud-sdk-cloud-build-local google-cloud-sdk-cloud-build-local
datalab google-cloud-sdk-datalab google-cloud-sdk-datalab
docker-credential-gcr まだ提供されていません。 まだ提供されていません。
gcd-emulator google-cloud-sdk-datastore-emulator google-cloud-sdk-datastore-emulator
kubectl kubectl kubectl
pubsub-emulator google-cloud-sdk-pubsub-emulator google-cloud-sdk-pubsub-emulator