このページでは、Cloud SDK のインストールの選択と管理のための手順について説明します。
インストール手順
Cloud SDK には Python が必要です。サポートされているバージョンは Python 3(3.5~3.8 を推奨)と Python 2(2.7.9 以降)です。
python --version
Python インタープリタの選択方法と構成方法については、gcloud topic startup
をご覧ください。- 次のいずれかをダウンロードします。
-
コマンドラインから Linux 64 ビット アーカイブ ファイルをダウンロードするには、次のコマンドを実行します。
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-327.0.0-linux-x86_64.tar.gz
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-327.0.0-linux-x86.tar.gz
- ファイル システム上の任意の場所にファイルの内容を抽出します(ホーム ディレクトリを使用することをおすすめします)。既存のインストールを置き換える場合は、既存の
google-cloud-sdk
ディレクトリを削除し、同じ場所にアーカイブを展開します。 - 省略可。インストール スクリプトを実行して、Cloud SDK ツールをパスに追加します
PATH
。また、シェルと使用統計情報の収集では、コマンドの補完を利用できます。次のコマンドを使用して(前の手順で抽出したフォルダのルートから)スクリプトを実行します。
./google-cloud-sdk/install.sh
これは、インタラクティブではない方法(スクリプトを使用する場合など)や、フラグとして設定を渡す方法で行うこともできます。次のコマンドを実行すると、説明が表示されます。./google-cloud-sdk/install.sh --help
変更が反映されるように新しいターミナル ウィンドウを開きます。 - gcloud init を実行して SDK を初期化します。
- 省略可。コンポーネント マネージャを使用して追加コンポーネントをインストールします。
プラットフォーム | パッケージ | サイズ | SHA256 チェックサム |
---|---|---|---|
Linux 64 ビット (x86_64) |
google-cloud-sdk-327.0.0-linux-x86_64.tar.gz | 111.6 MB | 1e67bc3cb2273a89437611a7df3dcc90cca00c5e21745ead03122feca7b98cc4 |
Linux 32 ビット (x86) |
google-cloud-sdk-327.0.0-linux-x86.tar.gz | 86.4 MB | 823e588cf8d5c2a14792d0f1b63ce61ea27bf2c9c68c025d2381274a39d64e6f |
./google-cloud-sdk/bin/gcloud init
パッケージの内容
Debian システムと Ubuntu システムにインストールする場合、Cloud SDK はパッケージ形式で利用できます。このパッケージに含まれているのは、gcloud
、gcloud alpha
、gcloud beta
、gsutil
、bq
の各コマンドのみです。kubectl
や、gcloud
コマンドでアプリケーションをデプロイするために必要な App Engine 拡張機能は含まれていません。これらのコンポーネントが必要な場合は、個別にインストールする必要があります。詳細については、このセクションの後の部分をご覧ください。
Cloud SDK をインストールする前に、お使いのオペレーティング システムが次のいずれかに該当することをご確認ください。
インストール- Cloud SDK の配布 URI をパッケージ ソースとして追加します。
echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
注: apt-transport-https がインストールされていることを確認してください。sudo apt-get install apt-transport-https ca-certificates gnupg
- Google Cloud の公開鍵をインポートします。
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -
- Cloud SDK を更新してインストールします。
sudo apt-get update && sudo apt-get install google-cloud-sdk
プロンプトの無効化やドライランなどの、追加のapt-get
オプションについては、apt-get
マニュアル ページをご覧ください。Docker のヒント: Docker イメージ内に Cloud SDK をインストールする場合は、1 回の RUN ステップを使用します。
RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] http://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg add - && apt-get update -y && apt-get install google-cloud-sdk -y
- 必要に応じて、次の追加コンポーネントをインストールします。
google-cloud-sdk-app-engine-python
google-cloud-sdk-app-engine-python-extras
google-cloud-sdk-app-engine-java
google-cloud-sdk-app-engine-go
google-cloud-sdk-bigtable-emulator
google-cloud-sdk-cbt
google-cloud-sdk-cloud-build-local
google-cloud-sdk-datalab
google-cloud-sdk-datastore-emulator
google-cloud-sdk-firestore-emulator
google-cloud-sdk-pubsub-emulator
kubectl
たとえば、
google-cloud-sdk-app-engine-java
コンポーネントは次のようにインストールできます。sudo apt-get install google-cloud-sdk-app-engine-java
gcloud init
を実行して開始します。gcloud init
Cloud SDK のバージョンのダウングレード
特定のバージョンの Cloud SDK に戻す場合(ここでは VERSION
は「123.0.0
」とします)、次のコマンドを実行します。
sudo apt-get update && sudo apt-get install google-cloud-sdk=123.0.0-0
常に最新の 10 個のリリースをリポジトリで使用できます。
パッケージの内容
Red Hat Enterprise Linux 7、Red Hat Enterprise Linux 8、Fedora 32、CentOS 7 の各システムにインストールする場合、Cloud SDK はパッケージ形式で利用できます。このパッケージに含まれているのは、gcloud
、gcloud alpha
、gcloud beta
、gsutil
、bq
の各コマンドのみです。kubectl
は含まれていません。また、gcloud
コマンドを使用してアプリケーションをデプロイするために必要な App Engine 拡張機能も含まれていません。このセクションの後半で説明するように、これらは個別にインストールできます。
- Cloud SDK リポジトリ情報で DNF を更新します。
sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM [google-cloud-sdk] name=Google Cloud SDK baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el7-x86_64 enabled=1 gpgcheck=1 repo_gpgcheck=1 gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg EOM
- Cloud SDK をインストールします。
sudo dnf install google-cloud-sdk
- 必要に応じて、次の追加コンポーネントをインストールします。
google-cloud-sdk-app-engine-python
google-cloud-sdk-app-engine-python-extras
google-cloud-sdk-app-engine-java
google-cloud-sdk-app-engine-go
google-cloud-sdk-bigtable-emulator
google-cloud-sdk-cbt
google-cloud-sdk-cloud-build-local
google-cloud-sdk-datalab
google-cloud-sdk-datastore-emulator
google-cloud-sdk-firestore-emulator
google-cloud-sdk-pubsub-emulator
kubectl
たとえば、
google-cloud-sdk-app-engine-java
コンポーネントは次のようにインストールできます。sudo dnf install google-cloud-sdk-app-engine-java
gcloud init
を実行して開始します。gcloud init
Cloud SDK のバージョンのダウングレード
特定のバージョンの Cloud SDK に戻す場合(ここでは VERSION
は「123.0.0
」とします)、次のコマンドを実行します。
sudo dnf downgrade google-cloud-sdk-VERSION
常に最新の 10 個のリリースをリポジトリで使用できます。
- Cloud SDK には Python が必要です。サポートされているバージョンは Python 3(3.5~3.8 を推奨)と Python 2(2.7.9 以降)です。最近のバージョンの macOS には、Cloud SDK に必要な Python の適切なバージョンが含まれています。
python -V
Python インタープリタの選択方法と構成方法については、gcloud topic startup
をご覧ください。 - 次のいずれかをダウンロードします。
- アーカイブをファイル システム上の任意の場所に展開します。ホーム ディレクトリを使用することをおすすめします。macOS では、ダウンロードした
.tar.gz
アーカイブ ファイルを任意の場所で開くことでこれを実現できます。既存のインストールを置き換える場合は、既存の
google-cloud-sdk
ディレクトリを削除し、同じ場所にアーカイブを展開します。 - 省略可。インストール スクリプトを実行して、Cloud SDK ツールをパスに追加します
PATH
。また、シェルと使用統計情報の収集では、コマンドの補完を利用できます。次のコマンドを使用して(前の手順で抽出したフォルダのルートから)スクリプトを実行します。
./google-cloud-sdk/install.sh
これは、インタラクティブではない方法(スクリプトを使用する場合など)や、フラグとして設定を渡す方法で行うこともできます。次のコマンドを実行すると、説明が表示されます。./google-cloud-sdk/install.sh --help
スクリーン リーダー モードを有効にしてインストール スクリプトを実行する場合:./google-cloud-sdk/install.sh --screen-reader=true
変更が反映されるように新しいターミナル ウィンドウを開きます。 - gcloud init を実行して SDK を初期化します。
- 省略可。コンポーネント マネージャを使用して追加コンポーネントをインストールします。
プラットフォーム | パッケージ | サイズ | SHA256 チェックサム |
---|---|---|---|
macOS 64 ビット (x86_64) |
google-cloud-sdk-327.0.0-darwin-x86_64.tar.gz | 109.6 MB | f2246a789f279504cc6b0b5432fef60a97ba7c25b5ca4e672da6106cbe5abd8c |
macOS 32 ビット (x86) |
google-cloud-sdk-327.0.0-darwin-x86.tar.gz | 87.5 MB | 280944a3129673dee6943920831b83d088ffe905bb98edb9d957770dc896ac9b |
./google-cloud-sdk/bin/gcloud init
-
Cloud SDK のインストーラをダウンロードします。
または、PowerShell ターミナルを開き、以下の PowerShell コマンドを実行します。
(New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe") & $env:Temp\GoogleCloudSDKInstaller.exe
-
インストーラを起動して、画面の指示に沿って操作します。インストーラには Google LLC による署名が付いています。
スクリーン リーダー モードを有効にする場合、[Turn on screen reader mode] オプションを選択すると、スクリーン リーダーの利便性が向上します。Cloud SDK のスクリーン リーダーの利用については、ユーザー補助機能のガイドをご覧ください。
-
Cloud SDK には Python が必要です。サポートされているバージョンは Python 3(3.5~3.8 を推奨)と Python 2(2.7.9 以降)です。
インストーラにより、必要な Python バージョンを含むすべての必須依存関係がインストールされます。Cloud SDK では現時点で Python 3 をデフォルトで使用していますが、必要に応じて既存の Python インストール環境を使用する場合は、バンドル版 Python をインストールするためのオプションをオフにすることができます。
インストールが完了すると、いくつかのオプションが表示されます。
次のオプションが選択されていることを確認してください。
- Start Google Cloud SDK Shell
- Run
gcloud init
これにより、ターミナル ウィンドウが開いて
gcloud init
コマンドが実行されます。- デフォルトのインストールには、
gcloud
コマンドでアプリケーションをデプロイするために必要な App Engine 拡張機能は含まれていません。これらのコンポーネントは、Cloud SDK コンポーネント マネージャーを使用してインストールできます。
- バージョン 274.0.0 のインストール後に Cloud SDK を実行できない場合は、こちらの追跡バグで最新の回避策をご覧ください。
find
コマンドが認識されないことが原因でインストールが失敗する場合は、find
が格納されているフォルダがPATH
環境変数に含まれていることを確認してください。通常、これはC:\WINDOWS\system32;
です。- Cloud SDK をアンインストールしたばかりの場合は、Cloud SDK を再度インストールする前にシステムを再起動する必要があります。
最新の Google Cloud クライアント ライブラリをインストールする(省略可)
サポートされている言語の Cloud クライアント ライブラリをダウンロードできます。
その他のインストール オプション
開発のニーズに応じて、推奨インストール方法ではなく、別のやり方で Cloud SDK をインストールすることもできます。
- スクリプトまたは継続的インテグレーション / デプロイで Cloud SDK を使用する場合。 バージョニングされたアーカイブをダウンロードして、Cloud SDK の特定バージョンを非対話形式でインストールします。
- Cloud SDK を Docker イメージとして実行する必要がある場合。Cloud SDK の最新リリース(または特定のバージョン)用の Cloud SDK Docker イメージを使用します。
- Ubuntu を実行し、自動更新を選択したい場合。snap パッケージを使用して Cloud SDK をインストールします。
- 上記のいずれにも該当しない場合、対話型インストーラを実行して Cloud SDK の最新リリースをインストールします。
インストールされるコンポーネント
上記のすべてのインストール方法では、デフォルトの Cloud SDK コンポーネントがインストールされます。これには、gcloud
、gsutil
、bq
コマンドライン ツールが含まれます。
追加のコンポーネントをインストールするには、gcloud components install
コマンドを使用するか、適切な deb パッケージまたは RPM パッケージをインストールします。
インストールの管理
Cloud SDK のインストール後は、gcloud components
コマンド グループのコマンドを使用して、インストールを管理できます。インストールされているコンポーネントの確認、コンポーネントの追加と削除、新しいバージョンの Cloud SDK へのアップグレード(または特定のバージョンへのダウングレード)などを行うことができます。
旧バージョンの Cloud SDK
旧バージョンの Cloud SDK に戻す必要がある場合は、このアーカイブからダウンロード可能な以前のすべてのリリースを見つけることができます。