gsutil をインストールする

前提条件: Python バージョン マネージャー（pyenv）をインストールし、適切な Python バージョンをインストールします。

1. グローバル Python バージョンを設定します。
   • Python 3.12.x をグローバル バージョンとして設定するには:

     pyenv global 3.12.x

   • または、特定のプロジェクト フォルダの Python バージョンをローカルに設定します。

     pyenv local 3.12.x

2. 正しい Python バージョンが使用されていることを確認します。

   python --version

   次のように表示されます。

   Python 3.12.x

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 です。