gcloud CLI をインストールする

1. サポートされているバージョンの Python を使用していることを確認します。Google Cloud CLI には Python 3.8 ～ 3.13 が必要です。x86_64 Linux パッケージには、デフォルトで優先される Python インタープリタがバンドルされています。Python インタープリタの選択方法と構成方法については、gcloud topic startup をご覧ください。
2. 次のいずれかをダウンロードします。

   プラットフォーム	パッケージ名	サイズ	SHA256 チェックサム
   Linux 64 ビット (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	131.6 MB	beb7c8ef61c46ede9295bf68bfb331fbd158575cc3343db585d37b891c890336
   Linux 64 ビット (Arm)	google-cloud-cli-linux-arm.tar.gz	53.9 MB	44eb95fd169f92c197f88df527c3aa27d5db9aa977c2fa2d28fa1cf506b00c9f
   Linux 32 ビット (x86)	google-cloud-cli-linux-x86.tar.gz	53.9 MB	10303f55226fac633761ae52e1dbcbcaf7c59fe11232f8196e6e361fc38e2e77

   Linux アーカイブ ファイルをダウンロードするには、次のコマンドを実行します。

   curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-linux-x86_64.tar.gz

   上記の表を参照し、google-cloud-cli-linux-x86_64.tar.gz を構成に適用される *.tar.gz パッケージ名に置き換えてください。

3. ファイルのコンテンツをファイル システム（できればホーム ディレクトリ）に抽出するには、次のコマンドを実行します。

   tar -xf google-cloud-cli-linux-x86_64.tar.gz

   省略可: 既存のインストールを置き換えるには、既存の google-cloud-sdk ディレクトリを削除し、同じ場所にアーカイブを展開します。
4. gcloud CLI をパスに追加します。次のコマンドを使用して、解凍したフォルダのルートからインストール スクリプトを実行します。

   ./google-cloud-sdk/install.sh

   これは、インタラクティブではない方法（スクリプトを使用する場合など）や、フラグとして設定を渡す方法で行うこともできます。使用可能なフラグを表示するには、次のコマンドを実行します。

   ./google-cloud-sdk/install.sh --help

   省略可。
   • gcloud CLI の改善のために匿名の使用統計情報を送信する場合、プロンプトが表示されたら「Y」と応答します。
   • gcloud CLI を PATH に追加してコマンドの補完を有効にする場合は、プロンプトが表示されたら「Y」と応答します。
5. 変更が反映されるように新しいターミナル ウィンドウを開きます。
6. gcloud CLI を初期化するには、gcloud init を実行します。

./google-cloud-sdk/bin/gcloud init

7. 省略可：コンポーネント マネージャーを使用して追加コンポーネントをインストールします。

Debian システムと Ubuntu システムにインストールする場合、gcloud CLI はパッケージ形式で利用できます。このパッケージに含まれているのは、gcloud、gcloud alpha、gcloud beta、gsutil、bq の各コマンドのみです。kubectl は含まれていません。また、gcloud コマンドでアプリケーションをデプロイするために必要な App Engine 拡張機能も含まれていません。これらのコンポーネントが必要な場合は、個別にインストールする必要があります。

gcloud CLI をインストールする前に、ご使用のオペレーティング システムが次の要件を満たしていることを確認してください。

• サポート終了になっていない Ubuntu リリース、またはサポート終了になっていない Debian 安定版リリース
• 最近、このパッケージが更新された

  sudo apt-get update

• apt-transport-https と curl がインストールされた

  sudo apt-get install apt-transport-https ca-certificates gnupg curl

1. Google Cloud の公開鍵をインポートします。

   • 新しいディストリビューション（Debian 9 以降または Ubuntu 18.04 以降）の場合は、次のコマンドを実行します。

     curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg

   • 古いディストリビューションの場合は、次のコマンドを実行します。

     curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

   • 使用しているディストリビューションの apt-key コマンドで --keyring 引数がサポートされていない場合は、次のコマンドを実行します。

     curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

   • 鍵が期限切れで最新バージョンを取得できない場合は、最新の apt-get.gpg 鍵ファイルを取得します。

2. gcloud CLI の配布 URI をパッケージ ソースとして追加します。
   • 新しいディストリビューション（Debian 9 以降または Ubuntu 18.04 以降）の場合は、次のコマンドを実行します。

     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

   • sign-by オプションをサポートしていない古いディストリビューションの場合は、次のコマンドを実行します。

     echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

3. gcloud CLI を更新してインストールします。

   sudo apt-get update && sudo apt-get install google-cloud-cli

   プロンプトの無効化やドライランなどの、追加の apt-get オプションについては、apt-get のマニュアル ページをご覧ください。

   Docker のヒント: Docker イメージ内に gcloud CLI をインストールする場合は、代わりに 1 回の実行ステップを使用します。

   RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://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 | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -y
       

   gpg --dearmor コマンドをサポートしていない古いベースイメージの場合:

   RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://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-cli -y
         

4. （省略可）次の追加コンポーネントをインストールします。
   • google-cloud-cli
   • google-cloud-cli-anthos-auth
   • google-cloud-cli-app-engine-go
   • google-cloud-cli-app-engine-grpc
   • google-cloud-cli-app-engine-java
   • google-cloud-cli-app-engine-python
   • google-cloud-cli-app-engine-python-extras
   • google-cloud-cli-bigtable-emulator
   • google-cloud-cli-cbt
   • google-cloud-cli-cloud-build-local
   • google-cloud-cli-cloud-run-proxy
   • google-cloud-cli-config-connector
   • google-cloud-cli-datastore-emulator
   • google-cloud-cli-firestore-emulator
   • google-cloud-cli-gke-gcloud-auth-plugin
   • google-cloud-cli-kpt
   • google-cloud-cli-kubectl-oidc
   • google-cloud-cli-local-extract
   • google-cloud-cli-minikube
   • google-cloud-cli-nomos
   • google-cloud-cli-pubsub-emulator
   • google-cloud-cli-skaffold
   • google-cloud-cli-spanner-emulator
   • google-cloud-cli-terraform-validator
   • google-cloud-cli-tests
   • kubectl

   たとえば、google-cloud-cli-app-engine-java コンポーネントは次のようにインストールできます。

   sudo apt-get install google-cloud-cli-app-engine-java

5. gcloud init を実行して開始します。

   gcloud init

gcloud CLI バージョンのダウングレード

gcloud CLI を特定のバージョンに戻すには（VERSION は 123.0.0 の形式）、次のコマンドを実行します。

sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0

リポジトリでは、常に最新の 10 リリースが利用可能です。

注: 371.0.0 より前のリリースの場合、パッケージ名は google-cloud-sdk です。

Red Hat Enterprise Linux 7、8、9、Fedora 33 と 34、CentOS 7 と 8 の各システムにインストールする場合、gcloud CLI はパッケージ形式で利用できます。 このパッケージに含まれているのは、gcloud、gcloud alpha、gcloud beta、gsutil、bq の各コマンドのみです。kubectl は含まれていません。また、gcloud コマンドを使用してアプリケーションをデプロイするために必要な App Engine 拡張機能も含まれていません。このセクションの後半で説明するように、これらは個別にインストールできます。

1. gcloud CLI リポジトリ情報で DNF を更新します。次のサンプル コマンドは Red Hat Enterprise Linux 9 互換のインストール用ですが、実際の構成に合わせて設定を更新してください。

   sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
   [google-cloud-cli]
   name=Google Cloud CLI
   baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-x86_64
   enabled=1
   gpgcheck=1
   repo_gpgcheck=0
   gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
   EOM

2. Fedora 34 または 35 にインストールする場合は、libxcrypt-compat.x86_64 をインストールします。

   sudo dnf install libxcrypt-compat.x86_64

3. gcloud CLI をインストールします。

   sudo dnf install google-cloud-cli

4. （省略可）次の追加コンポーネントをインストールします。
   • google-cloud-cli
   • google-cloud-cli-anthos-auth
   • google-cloud-cli-app-engine-go
   • google-cloud-cli-app-engine-grpc
   • google-cloud-cli-app-engine-java
   • google-cloud-cli-app-engine-python
   • google-cloud-cli-app-engine-python-extras
   • google-cloud-cli-bigtable-emulator
   • google-cloud-cli-cbt
   • google-cloud-cli-cloud-build-local
   • google-cloud-cli-cloud-run-proxy
   • google-cloud-cli-config-connector
   • google-cloud-cli-datastore-emulator
   • google-cloud-cli-firestore-emulator
   • google-cloud-cli-gke-gcloud-auth-plugin
   • google-cloud-cli-kpt
   • google-cloud-cli-kubectl-oidc
   • google-cloud-cli-local-extract
   • google-cloud-cli-minikube
   • google-cloud-cli-nomos
   • google-cloud-cli-pubsub-emulator
   • google-cloud-cli-skaffold
   • google-cloud-cli-spanner-emulator
   • google-cloud-cli-terraform-validator
   • google-cloud-cli-tests
   • kubectl

   たとえば、google-cloud-cli-app-engine-java コンポーネントは次のようにインストールできます。

   sudo dnf install google-cloud-cli-app-engine-java

5. gcloud init を実行して開始します。

   gcloud init

gcloud CLI バージョンのダウングレード

gcloud CLI を特定のバージョン（VERSION は 123.0.0 の形式）に戻す場合は、sudo dnf downgrade google-cloud-cli-VERSION を実行します。リポジトリでは、常に最新の 10 個のリリースが利用可能です。注: 371.0.0 より前のリリースの場合、パッケージ名は google-cloud-sdk です。

1. サポートされているバージョンの Python を使用していることを確認します。
   • 現在の Python バージョンを確認するには、 python3 -V または python -V を実行します。サポートされているバージョンは Python 3.8 ～ 3.13 です。
   • メインのインストール スクリプトでは、CPython の Python 3.11 をインストールできます。
   • そうでない場合は、サポートされている Python バージョンをインストールするには、Python.org の macOS 用 Python リリースにアクセスしてください。
   • マシンに複数の Python インタープリタがインストールされている場合は、シェル内で CLOUDSDK_PYTHON 環境変数を設定して、目的のインタープリタのパスを指定します。
   • Python インタープリタの選択方法と構成方法については、gcloud topic startup をご覧ください。
2. 次のいずれかをダウンロードします。

プラットフォーム	パッケージ	サイズ	SHA256 チェックサム
macOS 64 ビット (x86_64)	google-cloud-cli-darwin-x86_64.tar.gz	53.9 MB	9d1af0d2b5e7c8a30145831b99ce46272fc0aba754d7d23dcd3ede414b9ff75a
macOS 64 ビット (ARM64, Apple M1 silicon)	google-cloud-cli-darwin-arm.tar.gz	53.9 MB	d986d0c6531be038b71218f8e7e666c5b4d18ef580d6a063550406ed07e460f9
macOS 32 ビット (x86)	google-cloud-cli-darwin-x86.tar.gz	52.6 MB	e98b4bf6449b9207ff5c4bd3df12a1b38ffa0f498274b26f2d80cfe7fb124f81

1. アーカイブをファイル システム上の任意の場所に展開します。ホーム ディレクトリを使用することをおすすめします。macOS では、ダウンロードした .tar.gz アーカイブ ファイルを任意の場所で開くことでこれを実現できます。

   既存のインストールを置き換えるには、既存の google-cloud-sdk ディレクトリを削除し、同じ場所にアーカイブを展開します。

2. （省略可）インストール スクリプトを使用して、gcloud CLI ツールを PATH に追加します。また、シェル、使用統計情報の収集、Python 3.11 のインストールでコマンドの補完を利用できます。

   次のコマンドを使用して（前の手順で展開したフォルダのルートから）スクリプトを実行します。

   ./google-cloud-sdk/install.sh

   これは、インタラクティブではない方法（スクリプトを使用する場合など）や、フラグとして設定を渡す方法で行うこともできます。使用可能なフラグの説明を確認するには、次のコマンドを実行します。

   ./google-cloud-sdk/install.sh --help

   スクリーン リーダー モードを有効にしてインストール スクリプトを実行するには:

   ./google-cloud-sdk/install.sh --screen-reader=true

   変更が反映されるように新しいターミナル ウィンドウを開きます。
3. gcloud CLI を初期化するには、gcloud init を実行します。

./google-cloud-sdk/bin/gcloud init

4. 省略可。コンポーネント マネージャーを使用して、追加コンポーネントをインストールします。

Google Cloud CLI は Windows 8.1 以降と Windows Server 2012 以降で動作します。

1. Google Cloud CLI インストーラをダウンロードします。

   または、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
       

2. インストーラを起動して、画面の指示に沿って操作します。インストーラには Google LLC による署名が付いています。

   スクリーン リーダーを使用している場合は、[スクリーン リーダー モードをオンにする] チェックボックスをオンにします。このオプションで gcloud を設定すると、Unicode スピナーの代わりにステータス トラッカーが使用され、進行状況が割合で表示されます。また、テーブルがフラット化されます。詳しくは、ユーザー補助機能のガイドをご覧ください。

3. Google Cloud CLI には Python が必要です。サポートされているバージョンは Python 3.8 ～ 3.13 です。デフォルトでは、Google Cloud CLI の Windows バージョンには Python 3 がバンドルされています。Google Cloud CLI を使用するには、オペレーティング システムでサポートされているバージョンの Python を実行する必要があります。

   インストーラにより、必要な Python バージョンを含むすべての必要な依存関係がインストールされます。Google Cloud CLI はデフォルトで Python 3 をインストールして管理しますが、必要であれば、バンドル版 Python をインストールするオプションのチェックボックスをオフにすることで、既存の Python のインストールを使用できます。既存の Python インストール環境の使用方法については、gcloud topic startup をご覧ください。

4. インストールが完了すると、スタート メニューとデスクトップ ショートカットの作成、Google Cloud CLI シェルの起動、gcloud CLI の構成を行うオプションが表示されます。シェルを開始するオプションをそのまま使用して、選択したインストール環境を構成します。これにより、ターミナル ウィンドウが開いて gcloud init コマンドが実行されます。

5. デフォルトのインストールには、gcloud コマンドでアプリケーションをデプロイするのに必要な App Engine 拡張機能は含まれていません。これらのコンポーネントは、gcloud CLI コンポーネント マネージャーを使用してインストールできます。

• find コマンドが認識されないことが原因でインストールが失敗する場合は、find が格納されているフォルダが PATH 環境変数に含まれていることを確認してください。通常、これは C:\WINDOWS\system32; です。
• gcloud CLI をアンインストールした場合は、gcloud CLI を再度インストールする前にシステムを再起動する必要があります。
• 解凍できない場合は、管理者としてインストーラを実行します。