Google Cloud CLI をインストールする

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

   プラットフォーム	パッケージ名	サイズ	SHA256 チェックサム
   Linux 64 ビット (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	88.0 MB	c1cd1823624a33f2341d0d384aafe2d7b24c1b77c9b131087d772ee0791ff2be
   Linux 64 ビット (Arm)	google-cloud-cli-linux-arm.tar.gz	53.3 MB	67573751523f808db2a7dc9137d8df0faf91f78303e2c346f62ac2db4ae66f9f
   Linux 32 ビット (x86)	google-cloud-cli-linux-x86.tar.gz	53.3 MB	76ae821a3a11b1b69a394c71c2ffe4d820a109f6acaec95a3f46b767a8a63bcc

   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. 抽出したフォルダのルートからインストール スクリプトを実行します。

   ./google-cloud-sdk/install.sh

   スクリプトによって、次の設定アクションを実行するよう求められます。同意するには、プロンプトが表示されたら Y と答えます。
   • gcloud CLI を PATH に追加します。
   • コマンド補完を有効にします。
   • gcloud CLI の改善に役立てるため、匿名の使用統計情報を送信するよう設定します。
   フラグを指定して、インタラクティブではない方法でインストールすることもできます。使用可能なフラグを表示するには、次のコマンドを実行します。

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

5. 省略可: 前の手順で PATH を更新した場合は、変更が反映されるように新しいターミナルを開きます。

パッケージの内容

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

始める前に

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

• サポート終了になっていない Ubuntu リリース、またはサポート終了になっていない Debian 安定版リリースである。
• 最近、このパッケージが更新された。これを行うには、次のコマンドを実行します。

  sudo apt-get update

• ca-certificates、gnupg、curl がインストールされている。これらのパッケージをインストールするには、次のコマンドを実行します。

  sudo apt-get install 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 | 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-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-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-tools
   • google-cloud-cli-tests
   • kubectl

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

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

gcloud CLI バージョンをダウングレードする

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

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

過去 365 日以内に公開されたパッケージ バージョンは、リポジトリに保持されます。

パッケージの内容

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