SDK コンポーネントの管理

コンポーネントとは

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

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

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

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

ID 名前 説明
gcloud デフォルトの gcloud CLI コマンド Google Cloud Platform を操作するためのツール。このコンポーネントと一緒にインストールされるのは、リリースレベルが一般提供かプレビューのコマンドだけです。その他のリリースレベルのコマンドを使用するには、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 コマンドを使用して再インストールできます。

追加コンポーネント

SDK には、さまざまな gcloud CLI コマンドの依存関係を含む追加コンポーネントも用意されていますが、デフォルトではインストールされません。以下にコンポーネントの一部を示します(詳細なリストを表示するには、$ gcloud components list を実行します)。

ID 名前 説明
app-engine-python gcloud App Python Extensions Python 用の Google App Engine SDK パッケージ。gcloud app deploy コマンドを使用して Python アプリケーションを App Engine にデプロイするとインストールされます。
app-engine-java gcloud App Java Extensions Java 用の Google App Engine SDK パッケージ。gcloud app deploy コマンドを使用して Java アプリケーションを App Engine にデプロイするとインストールされます。
app-engine-go gcloud App Go Extensions Go 用の Google App Engine SDK パッケージ。gcloud app deploy コマンドを使用して Go アプリケーションを App Engine にデプロイするとインストールされます。
gcd-emulator Cloud Datastore Emulator Google Cloud Datastore 用のエミュレータ。gcloud beta emulators datastore コマンド グループのコマンドを使用するとインストールされます。
pubsub-emulator Cloud Pub/Sub Emulator Google Cloud Pub/Sub 用のエミュレータ。gcloud beta emulators pubsub コマンド グループのコマンドを使用するとインストールされます。
cbt Cloud Bigtable CLI Google Cloud Bigtable コマンドライン ツール
cloud-build-local Cloud Build Local Builder Google Cloud Build のローカル ビルダー
bigtable Cloud Bigtable Emulator Google Cloud Bigtable のエミュレータ。gcloud beta emulators bigtable コマンド グループのコマンドを使用するとインストールされます。
kubectl kubectl Kubernetes のコマンドライン ツール。gcloud container コマンド グループのコマンドを実行すると、このコンポーネントをインストールするように求められます。kubectl は、コンテナ クラスタの作成には必要ありませんが、実行には必要です。
docker-credential-gcr docker-credential-gcr Google Container Registry の Docker 認証ヘルパー。認証ヘルパーを有効にするには、インストール後に docker-credential-gcr configure-docker を実行します。詳細については、GitHub でプロジェクトをご確認ください
datalab datalab Cloud Datalab のコマンドライン ツール。
cloud-build-local Google Cloud Build Local Cloud Build のローカル ビルダー。インストール後、ローカルマシン上でビルドを実行できます。詳しくは、ローカルでのビルドとデバッグをご覧ください。

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

APTdeb 形式)や YUM などの外部パッケージ マネージャーを使用して Cloud SDK をインストールした場合は、次の表を参照して追加のコンポーネントをインストールできます。

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
このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...

Cloud SDK のドキュメント