gcloud CLI をインストールする

このページでは、Google Cloud CLI のインストールの選択と維持のための手順について説明します。Google Cloud CLI には gcloud、gsutil、bq コマンドライン ツールが含まれています。gcloud CLI の機能のリストについては、すべての機能をご覧ください。

サポートされているプログラミング言語を使用して Google Cloud APIs にアクセスするには、Cloud クライアント ライブラリをダウンロードします。

インストール手順

ここでは、Google Cloud CLI をインストールする方法について説明します。リリースレベルがアルファ版またはベータ版の gcloud CLI コマンドなど、追加のコンポーネントをインストールする方法については、gcloud CLI コンポーネントの管理をご覧ください。

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

    (x86_64)

    		 google-cloud-cli-447.0.0-linux-x86_64.tar.gz 188.0 MB 8b52fe759d24cc8b553091a412c8900a9dd3341ef9c505dbdaa395e70ae92f38
    Linux 64 ビット

    (ARM)

    		 google-cloud-cli-447.0.0-linux-arm.tar.gz 116.5 MB c192b30b3ed80a58a69c604ca6b7d04a64a6c8989c2961354205fe96bd2ec6a0
    Linux 32 ビット

    (x86)

    		 google-cloud-cli-447.0.0-linux-x86.tar.gz 114.5 MB 0bc5406c6df96b71dca30c26d42ab405f161a2bde3509c0135adfae801c4c26d

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

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

    64 ビット ARM アーカイブ ファイルの場合は、次のコマンドを実行します。

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

    32 ビット アーカイブ ファイルの場合は、次のコマンドを実行します。

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-447.0.0-linux-x86.tar.gz
  3. ファイル システム上の任意の場所にファイルの内容を展開します（ホーム ディレクトリを使用することをおすすめします）。既存のインストールを置き換えるには、既存の google-cloud-sdk ディレクトリを削除し、同じ場所にアーカイブを展開します。次のサンプルは、32 ビット Linux 用のコマンドを示しています。別のプラットフォームを使用している場合は、それに応じてコマンドを調整します。
    tar -xf google-cloud-cli-447.0.0-linux-x86.tar.gz
  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 を実行します。
    7. ./google-cloud-sdk/bin/gcloud init
  7. 省略可。コンポーネント マネージャーを使用して、追加コンポーネントをインストールします。
Debian/Ubuntu

パッケージの内容

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 sudo
インストール
  1. gcloud CLI の配布 URI をパッケージ ソースとして追加します。
    • 使用しているディストリビューションで signed-by オプションがサポートされている場合は、次のコマンドを実行します。 
      echo "deb [signed-by=/usr/share/keyrings/cloud.google.asc] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

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

      echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
  2. Google Cloud の公開鍵をインポートします。
    • 使用しているディストリビューションの apt-key コマンドが --keyring 引数をサポートしている場合は、次のコマンドを実行します。
      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 -

    • 使用しているディストリビューション（Debian 11 以降または Ubuntu 21.10 以降）が apt-key をサポートしていない場合は、次のコマンドを実行します。

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

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

  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] 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-cli -y
    apt-key コマンドがサポートされていない場合:
    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.asc] 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 | tee /usr/share/keyrings/cloud.google.asc && apt-get update -y && apt-get install google-cloud-sdk -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/Fedora/CentOS

パッケージの内容

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

インストール
  1. gcloud CLI リポジトリ情報で DNF を更新します。次のサンプル コマンドは、Red Hat Enterprise Linux 8 互換のインストール用です。Red Hat Enterprise Linux 7 互換のインストールの場合は、baseUrl の値で el8 を el7 に置き換えてください。
    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-el8-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 です。

macOS
  1. サポートされているバージョンの Python を使用していることを確認します。
    • 現在の Python バージョンを確認するには、 python3 -V または python -V を実行します。サポートされているバージョンは Python 3（3.8～3.9）です。
    • Google Cloud CLI リリース バージョン 352.0.0 以降の場合、メインのインストール スクリプトでは、Intel ベースの Mac に CPython の Python 3.7 をインストールできます。
    • Python インタープリタの選択方法と構成方法については、gcloud topic startup をご覧ください。
  2. 次のいずれかをダウンロードします。

    3. プラットフォーム パッケージ サイズ SHA256 チェックサム
    macOS 64 ビット

    (x86_64)

    		 google-cloud-cli-447.0.0-darwin-x86_64.tar.gz 122.2 MB 073ece484561b42162e2ca18078d892bac9a82917b318b32e36f68bdd13f5a1b
    macOS 64 ビット

    (ARM64, Apple M1 silicon)

    		 google-cloud-cli-447.0.0-darwin-arm.tar.gz 119.3 MB 3b5940d6953a8bbb6d60ba20014962ecdb4608f6f04c0708eefc232ea8a25b69
    macOS 32 ビット

    (x86)

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

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

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

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

      ./google-cloud-sdk/install.sh
      これは、インタラクティブではない方法（スクリプトを使用する場合など）や、フラグとして設定を渡す方法で行うこともできます。使用可能なフラグの説明を確認するには、次のコマンドを実行します。
      ./google-cloud-sdk/install.sh --help
      スクリーン リーダー モードを有効にしてインストール スクリプトを実行するには:
      ./google-cloud-sdk/install.sh --screen-reader=true
      変更が反映されるように新しいターミナル ウィンドウを開きます。
    3. gcloud CLI を初期化するには、gcloud init を実行します。
      4. ./google-cloud-sdk/bin/gcloud init
    4. 省略可。コンポーネント マネージャーを使用して、追加コンポーネントをインストールします。
Windows
    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（3.8 ～ 3.9）です。デフォルトでは、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 を再度インストールする前にシステムを再起動する必要があります。
  • 解凍できない場合は、管理者としてインストーラを実行します。

その他のインストール オプション

開発のニーズに応じて、推奨インストール方法ではなく、別の方法で gcloud CLI をインストールすることもできます。

  • スクリプトまたは継続的インテグレーション/デプロイで gcloud CLI を使用する場合。バージョニングされたアーカイブをダウンロードして、gcloud CLI の特定バージョンを非対話形式でインストールします。
  • gcloud CLI を Docker イメージとして実行する必要がある場合。gcloud CLI の最新リリース（または特定のバージョン）用の gcloud CLI Docker イメージを使用します。
  • Ubuntu を実行し、自動更新を選択したい場合。snap パッケージを使用して gcloud CLI をインストールします。
  • 上記のいずれにも該当しない場合は、対話型インストーラを実行して gcloud CLI の最新リリースをインストールします。

インストールの管理

gcloud CLI をインストールした後は、gcloud components コマンド グループのコマンドを使用して、インストールを管理できます。インストールされているコンポーネントの確認、コンポーネントの追加と削除、新しいバージョンの gcloud へのアップグレード、特定のバージョンの gcloud CLI へのダウングレードなどを行うことができます。

以前のバージョンの gcloud CLI

別のバージョンの gcloud CLI が必要な場合は、このページで説明した手順で現在のバージョンをインストールし、ログインしてください。ログイン後、以前のリリースをダウンロードできます。日付で並べ替えられたバージョンを表示するには、[並べ替えとフィルタ] を有効にして [作成] 列をクリックします。

サポート対象の Python バージョン

Google Cloud CLI には Python 3（3.8～3.9）が必要です。Python インタープリタの選択方法と構成方法については、gcloud topic startup をご覧ください。

使ってみる

Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

無料で開始