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

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

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

使ってみる

Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオで Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる $300 相当の無料クレジットを差し上げます。

無料で開始

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

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

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

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

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

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

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

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

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

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

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

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

gcloud components list

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


┌────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                                  Components                                         │
├───────────────┬─────────────────────────────────────────────────┬──────────────────────────┬───────────┤
│     Status   │                         Name                   │            ID           │    Size   │
├───────────────┼─────────────────────────────────────────────────┼──────────────────────────┼───────────┤
│ Installed     │ App Engine Go Extensions                      │ app-engine-go            │  97.7 MiB │
│ Not Installed │ AppCtl                                        │ appctl                   │  21.0 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 │
| Not Installed | Cloud Datastore Emulator                      | cloud-firestore-emulator | 60.4 MiB  |
│ Installed     │ Cloud Pub/Sub Emulator                        │ pubsub-emulator          │  33.2 MiB │
│ Installed     │ Cloud SQL Proxy                               │ cloud-sql-proxy          │   7.6 MiB │
│ Installed     │ Cloud Spanner Emulator                        │ cloud-spanner-emulator   │  21.8 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     │ Cloud 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 install を実行します。

gcloud components install [COMPONENT-ID]

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

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

gcloud components install kubectl

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

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

gcloud components update

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

Cloud 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 コマンドを使用して再インストールできます。

追加コンポーネント

Cloud SDK では、gcloud ツールコマンドの依存関係を含む追加コンポーネントも利用できますが、デフォルトではインストールされません。コンポーネントすべてのリストについては、$ 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