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

このクイックスタートでは、Google Cloud CLI をインストールして初期化する推奨の方法について説明します。初期化後、いくつかのコア gcloud CLI コマンドを実行して、インストールに関する情報を表示し、インストールが成功したことを確認します。

このタスクを Google Cloud コンソールで直接行う際の順を追ったガイダンスについては、「ガイドを表示」をクリックしてください。

ガイドを表示

始める前に

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

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

gcloud CLI バージョン 562.0.0 をインストールする

Linux
  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 204.3 MB 38bd4f203392354fa7cc5514ee38ea02bb808aa5f1f7e00257806abf782dde38
    Linux 64 ビット

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 59.1 MB 4fde7da4176fdc8e88f33a2293a050afada0d72d77686cdcdedeee9e807d69b6
    Linux 32 ビット

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 59.2 MB 189dffeda176a149f16810a3c80a18dd8c9e0dfa2ae302600ac0c4907f571ec8

    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

パッケージの内容

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-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

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

インストール

  1. gcloud CLI リポジトリ情報で DNF を更新します。

    • 次のサンプル コマンドは Red Hat Enterprise Linux 7、8、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

    • RHEL 10 互換のインストールでは、gpgkey が更新された次のコマンドを使用します。

      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-el10-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key-v10.gpg
EOM
  2. libxcrypt-compat.x86_64 をインストールします。
    sudo dnf install libxcrypt-compat.x86_64
  3. gcloud CLI をインストールします。
    sudo dnf install google-cloud-cli
  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-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

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

gcloud CLI を特定のバージョンに戻すには、次のコマンドを実行します。123.0.0 は、インストールするバージョンに置き換えます。

sudo dnf downgrade google-cloud-cli-123.0.0

リポジトリでは、最新の 10 個のリリースが利用可能です。371.0.0 より前のリリースの場合、パッケージ名として google-cloud-sdk を使用します。

macOS
  1. サポートされているバージョンの Python を使用していることを確認します。Google Cloud CLI には Python 3.10 ～ 3.14 が必要です。

    現在の Python バージョンを確認するには、python3 -V または python -V を実行します。

    gcloud インストーラは、デフォルトで Python v3.13 と必要な拡張モジュールをインストールします。

    Python インタープリタの構成の詳細については、gcloud topic startup のドキュメントをご覧ください。

  2. 次のいずれかをダウンロードします。
    プラットフォーム パッケージ サイズ SHA256 チェックサム
    macOS 64 ビット

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz 59.3 MB 9044aee682dcec5551fc58c127d717a6428b4c56f264f3a1c0f2a055c70f44fa
    macOS 64 ビット

    (ARM64, Apple silicon)

    		 google-cloud-cli-darwin-arm.tar.gz 59.2 MB 9c02c838d31c2c1d0cad449f179874a7033c771c436ce69742e4b2019aff23af
    macOS 32 ビット

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 57.6 MB 8cb17e640b83492cb9aa99d210ab060a0eb473811a81f6430f64243598b41402

    または、コマンドラインからアーカイブをダウンロードすることもできます。FILE_NAME は、上記の表のプラットフォームのパッケージ名に置き換えます。

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/FILE_NAME
  3. ファイル システム上の任意の場所にファイルの内容を抽出します。一般的には、ホーム ディレクトリに抽出します。

    macOS では、ダウンロードした .tar.gz ファイルを任意の場所で開くことでこれを実現できます。または、コマンドラインから次のコマンドを実行します。

    tar -xf FILE_NAME

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

  4. 抽出したフォルダのルートからインストール スクリプトを実行します。
    ./google-cloud-sdk/install.sh
     スクリプトによって、次の設定アクションを実行するよう求められます。同意するには、プロンプトが表示されたら Y と答えます。
    • 必要に応じて、Python 3.13 と推奨モジュールをインストールします。
    • gcloud CLI を PATH に追加してコマンドの補完を有効にします。
    • gcloud CLI の改善に役立てるため、匿名の使用統計情報を送信するよう設定します。
    フラグを指定して、インタラクティブではない方法でインストールすることもできます。使用可能なフラグを表示するには、次のコマンドを実行します。
    ./google-cloud-sdk/install.sh --help
     スクリーン リーダーモードを有効にしてインストール スクリプトを実行するには: 
    ./google-cloud-sdk/install.sh --screen-reader=true
  5. 省略可: 前の手順で PATH を更新した場合は、変更が反映されるように新しいターミナルを開きます。
Windows

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 スピナーの代わりにステータス トラッカーが使用され、進行状況がパーセンテージで表示されます。また、テーブルがフラット化されます。詳しくは、ユーザー補助機能のガイドをご覧ください。
    • Google Cloud CLI には Python が必要です。サポートされているバージョンは Python 3.10 ～ 3.14 です。デフォルトでは、Google Cloud CLI の Windows バージョンには Python 3 がバンドルされています。Google Cloud CLI を使用するには、オペレーティング システムでサポートされているバージョンの Python を実行できる必要があります。
    • インストーラにより、必要な Python バージョンを含むすべての必要な依存関係がインストールされます。 Google Cloud CLI はデフォルトで Python 3 をインストールして管理しますが、必要であれば、バンドル版 Python をインストールするオプションのチェックボックスをオフにすることで、既存の Python のインストールを使用できます。既存の Python インストールの使用方法については、gcloud topic startup をご覧ください。

  3. インストールが完了すると、スタート メニューとデスクトップのショートカットの作成、Google Cloud CLI シェルの起動を行うオプションが表示されます。シェルを開始するオプションのチェックを外します。次のステップで、gcloud CLI を実行して構成します。

トラブルシューティングのヒント

  • find コマンドが認識されないことが原因でインストールが失敗する場合は、find が格納されているフォルダが PATH 環境変数に含まれていることを確認してください。通常、これは C:\WINDOWS\system32; です。
  • gcloud CLI をアンインストールした場合は、gcloud CLI を再度インストールする前にシステムを再起動する必要があります。
  • 解凍できない場合は、管理者としてインストーラを実行します。
Chromebook
  1. Chromebook で Linux 開発環境をセットアップします。
  2. gcloud CLI の配布 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
  3. Google Cloud 公開鍵をインポートします。
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -
  4. gcloud CLI を更新してインストールします。
    sudo apt-get update && sudo apt-get install google-cloud-cli
  5. 省略可: 次の追加コンポーネントをインストールします。
    • 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

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

gcloud CLI を特定のバージョンに戻すには、次のコマンドを実行します。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 を使用します。

gcloud CLI を初期化して承認する

プロキシまたはファイアウォールの背後にある場合は、プロキシ構成を参照して、gcloud CLI のネットワーク アクセスを有効にしてください。

gcloud CLI をインストールしたら、初期化して Google Cloud へのアクセスを承認し、デフォルトの構成を設定します。詳細については、gcloud init をご覧ください。

  1. gcloud init を実行して gcloud CLI を初期化します。

    gcloud init

    デフォルトでは、このコマンドを実行するとウェブブラウザが開き、アクセスが承認されます。代わりにコマンドラインから承認するには、--console-only フラグを追加します。非対話型承認の場合は、Google Cloud コンソールで適切なスコープのサービス アカウントを作成し、その JSON キーファイルで gcloud auth activate-service-account を使用します。

  2. プロンプトに従って、次の操作を承認して構成します。

    • ログインを求めるメッセージが表示されたら、同意してブラウザで Google アカウントにログインします。[許可] をクリックして、リソースへのアクセス権を付与します。

    • オーナー、編集者、閲覧者のいずれかの権限が付与されているプロジェクトのリストから、プロジェクトを選択します。プロジェクトが 1 つしかない場合は、そのプロジェクトが gcloud init によって自動的に選択されます。

      200 を超えるプロジェクトがある場合は、プロジェクト ID の入力、プロジェクトの作成、プロジェクトの一覧表示を求めるプロンプトが表示されます。プロジェクトの作成を選択した場合は、課金を有効にする必要があります。

    • Compute Engine API を有効にしている場合は、デフォルトの Compute Engine ゾーンを選択します。

  3. 省略可: スクリーン リーダーの利便性を向上させるため、次のコマンドで accessibility/screen_reader プロパティを有効にします。

    gcloud config set accessibility/screen_reader true

    詳しくは、ユーザー補助機能の有効化ガイドをご覧ください。

コアコマンドを実行する

主要なコマンドを実行して、gcloud CLI のインストールに関する情報を表示します。

  1. 認証情報がローカル システムに保存されているアカウントのリストを表示します。

    gcloud auth list

    gcloud CLI は、認証されたアカウントのリストを表示します。

    Credentialed Accounts
ACTIVE             ACCOUNT
*                  example-user-1@example.com
                   example-user-2@example.com

  2. アクティブな gcloud CLI 構成のプロパティを一覧表示します。

    gcloud config list

    gcloud CLI はプロパティのリストを表示します。

    [core]
account = example-user-1@example.com
disable_usage_reporting = False
project = example-project

  3. gcloud コマンドやその他のトピックに関する情報を表示します。

    gcloud help

    たとえば gcloud compute instances create のヘルプを表示するには、次のようにします。

    gcloud help compute instances create

    gcloud CLI によって、コマンドの説明、コマンドフラグと引数のリスト、コマンドの使用方法の例などを含むヘルプトピックが表示されます。

省略可: 追加コンポーネントをインストールする

App Engine エミュレータ、kubectl、アルファ版またはベータ版のリリースレベルの gcloud CLI コマンドなどの追加コンポーネントをインストールするには、gcloud CLI コンポーネントの管理をご覧ください。

次のステップ

  • gcloud CLI ガイドで、gcloud CLI の概要を確認する。このガイドには、主なコンセプト、コマンドの使い方、便利なヒントなどが簡潔にまとめられています。
  • gcloud CLI リファレンス ガイドを読む。 Google Cloudでさまざまなタスクを実行するために使用できる各 gcloud CLI コマンドの詳細ページ（説明、フラグ、例を含む）が記載されています。
  • よく使用されるコマンドと主要なコンセプトの一覧については、gcloud CLI クイック リファレンスをご覧ください。