Google Cloud CLI をインストールする
このクイックスタートでは、Google Cloud CLI をインストールして初期化する推奨の方法について説明します。初期化後、いくつかのコア gcloud CLI コマンドを実行して、インストールに関する情報を表示し、インストールが成功したことを確認します。
このタスクを Google Cloud コンソールで直接行う際の順を追ったガイダンスについては、「ガイドを表示」をクリックしてください。
始める前に
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
- サポートされているバージョンの Python を使用していることを確認します。Google Cloud CLI には Python 3.9~3.14 が必要です。x86_64 Linux パッケージには、デフォルトで優先される Python インタープリタがバンドルされています。Python インタープリタの選択方法と構成方法については、
gcloud topic startupドキュメントをご覧ください。 - 次のいずれかをダウンロードします。
プラットフォーム パッケージ名 サイズ SHA256 チェックサム Linux 64 ビット (x86_64)
google-cloud-cli-linux-x86_64.tar.gz 202.9 MB 71a81b5391dbc0418ac767a8522d8eab92780d708cb1c2740160d137fbeb760a Linux 64 ビット (Arm)
google-cloud-cli-linux-arm.tar.gz 57.7 MB 001c4adc88fe796a0c0a0db9771949947528c5066bc5c9f6b7240b5ef59ee0f3 Linux 32 ビット (x86)
google-cloud-cli-linux-x86.tar.gz 57.8 MB 921b840acfbbb9cace1d696175aded8a891149ccfbab48e5aea11613bc4a31fc 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パッケージ名に置き換えてください。 - ファイルのコンテンツをファイル システムに抽出するには、次のコマンドを実行します。
既存のインストールを置き換えるには、既存のtar -xf google-cloud-cli-linux-x86_64.tar.gz
google-cloud-sdkディレクトリを削除し、同じ場所にアーカイブを展開します。 - 解凍したフォルダのルートからインストール スクリプトを実行します。
スクリプトによって、次の設定アクションを実行するよう求められます。同意するには、プロンプトが表示されたら./google-cloud-sdk/install.sh
Yと答えます。- gcloud CLI を
PATHに追加します。 - コマンド補完を有効にします。
- gcloud CLI の改善に役立てるため、匿名の使用統計情報を送信するよう設定します。
./google-cloud-sdk/install.sh --help - gcloud CLI を
- 省略可: 前の手順で
PATHを更新した場合は、変更が反映されるように新しいターミナルを開きます。 - サポート終了になっていない Ubuntu リリース、またはサポート終了になっていない Debian 安定版リリースである。
- 最近、このパッケージが更新された。今すぐこれを行うには、次のコマンドを実行します。
sudo apt-get update
apt-transport-https、ca-certificates、gnupg、curlがインストールされている。これらのパッケージをインストールするには、次のコマンドを実行します。sudo apt-get install apt-transport-https ca-certificates gnupg curl
- 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 鍵ファイルを取得します。
- 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
- 新しいディストリビューション(Debian 9 以降または Ubuntu 18.04 以降)の場合は、次のコマンドを実行します。
- 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
- 省略可: 次の
追加コンポーネントをインストールします。
google-cloud-cli-anthos-authgoogle-cloud-cli-app-engine-gogoogle-cloud-cli-app-engine-grpcgoogle-cloud-cli-app-engine-javagoogle-cloud-cli-app-engine-pythongoogle-cloud-cli-app-engine-python-extrasgoogle-cloud-cli-bigtable-emulatorgoogle-cloud-cli-cbtgoogle-cloud-cli-cloud-build-localgoogle-cloud-cli-cloud-run-proxygoogle-cloud-cli-config-connectorgoogle-cloud-cli-datastore-emulatorgoogle-cloud-cli-firestore-emulatorgoogle-cloud-cli-gke-gcloud-auth-plugingoogle-cloud-cli-kptgoogle-cloud-cli-kubectl-oidcgoogle-cloud-cli-local-extractgoogle-cloud-cli-minikubegoogle-cloud-cli-nomosgoogle-cloud-cli-pubsub-emulatorgoogle-cloud-cli-skaffoldgoogle-cloud-cli-spanner-emulatorgoogle-cloud-cli-terraform-validatorgoogle-cloud-cli-testskubectl
たとえば、
google-cloud-cli-app-engine-javaコンポーネントは次のようにインストールできます。sudo apt-get install google-cloud-cli-app-engine-java
- 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
-
-
libxcrypt-compat.x86_64をインストールします。sudo dnf install libxcrypt-compat.x86_64
- gcloud CLI をインストールします。
sudo dnf install google-cloud-cli
- 省略可: 次の追加コンポーネントをインストールします。
google-cloud-cli-anthos-authgoogle-cloud-cli-app-engine-gogoogle-cloud-cli-app-engine-grpcgoogle-cloud-cli-app-engine-javagoogle-cloud-cli-app-engine-pythongoogle-cloud-cli-app-engine-python-extrasgoogle-cloud-cli-bigtable-emulatorgoogle-cloud-cli-cbtgoogle-cloud-cli-cloud-build-localgoogle-cloud-cli-cloud-run-proxygoogle-cloud-cli-config-connectorgoogle-cloud-cli-datastore-emulatorgoogle-cloud-cli-firestore-emulatorgoogle-cloud-cli-gke-gcloud-auth-plugingoogle-cloud-cli-kptgoogle-cloud-cli-kubectl-oidcgoogle-cloud-cli-local-extractgoogle-cloud-cli-minikubegoogle-cloud-cli-nomosgoogle-cloud-cli-pubsub-emulatorgoogle-cloud-cli-skaffoldgoogle-cloud-cli-spanner-emulatorgoogle-cloud-cli-terraform-validatorgoogle-cloud-cli-testskubectl
たとえば、
google-cloud-cli-app-engine-javaコンポーネントをインストールするには、次のコマンドを実行します。sudo dnf install google-cloud-cli-app-engine-java
- サポートされているバージョンの Python を使用していることを確認します。Google Cloud CLI には Python 3.9 ~ 3.14 が必要です。
Python のバージョンを確認するには、
python3 -Vまたはpython -Vを実行します。必要に応じて、インストール スクリプトで Python をインストールできます。これには Xcode コマンドライン ツールが必要です。インストールするには、
sudo xcode-select --installを実行します。または、python.org からサポートされている Python バージョンをインストールすることもできます。Python インタープリタの構成の詳細については、特に複数のバージョンがインストールされている場合は、
gcloud topic startupのドキュメントをご覧ください。 -
次のいずれかをダウンロードします。
プラットフォーム パッケージ サイズ SHA256 チェックサム macOS 64 ビット (x86_64)
google-cloud-cli-darwin-x86_64.tar.gz 57.9 MB 6a838eacf37a2505c4d90fb74bd97abdb488b0a85321c3d886e4bd9851a78fd8 macOS 64 ビット (ARM64, Apple silicon)
google-cloud-cli-darwin-arm.tar.gz 57.8 MB 36e2838b7b3ec0659df7a142bb870f8612576ca6883240d657363e3391964339 macOS 32 ビット (x86)
google-cloud-cli-darwin-x86.tar.gz 56.3 MB eaeef651be72fb86379e1fd6c208d625c5ebaf3f87d9deb540594e456fc4ed56 または、コマンドラインからアーカイブをダウンロードすることもできます。
FILE_NAMEは、上記の表のプラットフォームのパッケージ名に置き換えます。curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/FILE_NAME
- ファイル システム上の任意の場所にファイルの内容を抽出します。一般的には、ホーム ディレクトリに抽出します。
macOS では、ダウンロードした
.tar.gzファイルを任意の場所で開くことでこれを実現できます。または、コマンドラインから次のコマンドを実行します。tar -xf FILE_NAME
既存のインストールを置き換えるには、既存の
google-cloud-sdkディレクトリを削除し、同じ場所にアーカイブを展開します。 - 解凍したフォルダのルートからインストール スクリプトを実行します。
スクリプトによって、次の設定アクションを実行するよう求められます。同意するには、プロンプトが表示されたら./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
- 省略可: 前の手順で
PATHを更新した場合は、変更が反映されるように新しいターミナルを開きます。 -
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
-
インストーラを起動して、画面の指示に沿って操作します。インストーラには Google LLC による署名が付いています。
- スクリーン リーダーを使用している場合は、[スクリーン リーダーモードをオンにする] チェックボックスをオンにします。このオプションで
gcloudを構成すると、Unicode スピナーの代わりにステータス トラッカーが使用され、進行状況が割合で表示されます。また、テーブルがフラット化されます。詳しくは、ユーザー補助機能のガイドをご覧ください。 - Google Cloud CLI には Python が必要です。サポートされているバージョンは Python 3.9~3.14 です。デフォルトでは、Google Cloud CLI の Windows バージョンには Python 3 がバンドルされています。Google Cloud CLI を使用するには、オペレーティング システムでサポートされているバージョンの Python を実行する必要があります。
- インストーラにより、必要な Python バージョンを含むすべての必要な依存関係がインストールされます。Google Cloud CLI はデフォルトで Python 3 をインストールして管理しますが、必要であれば、バンドル版 Python をインストールするオプションのチェックボックスをオフにすることで、既存の Python のインストールを使用できます。既存の Python インストール環境の使用方法については、
gcloud topic startupをご覧ください。
- スクリーン リーダーを使用している場合は、[スクリーン リーダーモードをオンにする] チェックボックスをオンにします。このオプションで
インストールが完了すると、スタート メニューとデスクトップのショートカットの作成、Google Cloud CLI シェルの起動を行うオプションが表示されます。シェルを開始するオプションのチェックを外します。次の手順で、gcloud CLI を実行して構成します。
findコマンドが認識されないことが原因でインストールが失敗する場合は、findが格納されているフォルダがPATH環境変数に含まれていることを確認してください。通常、これはC:\WINDOWS\system32;です。- gcloud CLI をアンインストールした場合は、gcloud CLI を再度インストールする前にシステムを再起動する必要があります。
- 解凍できない場合は、管理者としてインストーラを実行します。
- Chromebook で Linux 開発環境をセットアップします。
- 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
- Google Cloud 公開鍵をインポートします。
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -
- gcloud CLI を更新してインストールします。
sudo apt-get update && sudo apt-get install google-cloud-cli
- 省略可: 次の
追加コンポーネントをインストールします。
google-cloud-cli-anthos-authgoogle-cloud-cli-app-engine-gogoogle-cloud-cli-app-engine-grpcgoogle-cloud-cli-app-engine-javagoogle-cloud-cli-app-engine-pythongoogle-cloud-cli-app-engine-python-extrasgoogle-cloud-cli-bigtable-emulatorgoogle-cloud-cli-cbtgoogle-cloud-cli-cloud-build-localgoogle-cloud-cli-cloud-run-proxygoogle-cloud-cli-config-connectorgoogle-cloud-cli-datastore-emulatorgoogle-cloud-cli-firestore-emulatorgoogle-cloud-cli-gke-gcloud-auth-plugingoogle-cloud-cli-kptgoogle-cloud-cli-kubectl-oidcgoogle-cloud-cli-local-extractgoogle-cloud-cli-minikubegoogle-cloud-cli-nomosgoogle-cloud-cli-pubsub-emulatorgoogle-cloud-cli-skaffoldgoogle-cloud-cli-spanner-emulatorgoogle-cloud-cli-terraform-validatorgoogle-cloud-cli-testskubectl
たとえば、
google-cloud-cli-app-engine-javaコンポーネントをインストールするには、次のコマンドを実行します。sudo apt-get install google-cloud-cli-app-engine-java
gcloud initを実行して gcloud CLI を初期化します。gcloud initデフォルトでは、このコマンドを実行するとウェブブラウザが開き、アクセスが承認されます。代わりにコマンドラインから承認するには、
--console-onlyフラグを追加します。非対話型承認の場合は、Google Cloud コンソールで適切なスコープのサービス アカウントを作成し、その JSON キーファイルでgcloud auth activate-service-accountを使用します。プロンプトに沿って、次の項目を承認して構成します。
ログインを求めるメッセージが表示されたら、同意してブラウザで Google アカウントにログインします。[許可] をクリックして、リソースへのアクセス権を付与します。
オーナー、編集者、閲覧者のいずれかの権限が付与されているプロジェクトのリストから、プロジェクトを選択します。プロジェクトが 1 つしかない場合は、そのプロジェクトが
gcloud initによって自動的に選択されます。200 を超えるプロジェクトがある場合は、プロジェクト ID の入力、プロジェクトの作成、プロジェクトの一覧表示を求めるプロンプトが表示されます。プロジェクトの作成を選択した場合は、課金を有効にする必要があります。
Compute Engine API を有効にしている場合は、デフォルトの Compute Engine ゾーンを選択します。
省略可: スクリーン リーダーの利便性を向上させるため、次のコマンドで
accessibility/screen_readerプロパティを有効にします。gcloud config set accessibility/screen_reader true詳しくは、ユーザー補助機能の有効化ガイドをご覧ください。
認証情報がローカル システムに保存されているアカウントのリストを表示します。
gcloud auth listgcloud CLI は、認証されたアカウントのリストを表示します。
Credentialed Accounts ACTIVE ACCOUNT * example-user-1@example.com example-user-2@example.comアクティブな gcloud CLI 構成のプロパティを一覧表示します。
gcloud config listgcloud CLI はプロパティのリストを表示します。
[core] account = example-user-1@example.com disable_usage_reporting = False project = example-project
gcloudコマンドやその他のトピックに関する情報を表示します。gcloud helpたとえば
gcloud compute instances createのヘルプを表示するには、次のようにします。gcloud help compute instances creategcloud CLI によって、コマンドの説明、コマンドフラグと引数のリスト、コマンドの使用方法の例などを含むヘルプトピックが表示されます。
- gcloud CLI ガイドで、gcloud CLI の概要を確認する。このガイドには、主なコンセプト、コマンドの使い方、便利なヒントなどが簡潔にまとめられています。
- gcloud CLI リファレンス ガイドを読む。 Google Cloudでさまざまなタスクを実行するために使用できる各 gcloud CLI コマンドの詳細ページ(説明、フラグ、例を含む)が記載されています。
- よく使用されるコマンドと主要なコンセプトの一覧については、gcloud CLI クイック リファレンスをご覧ください。
このドキュメントに記載されているタスクの完了後、作成したリソースを削除すると、それ以上の請求は発生しません。詳細については、クリーンアップをご覧ください。
gcloud CLI バージョン 548.0.0 をインストールする
パッケージの内容
Debian システムと Ubuntu システムにインストールする場合、gcloud CLI はパッケージ形式で利用できます。このパッケージに含まれているのは、gcloud、gcloud alpha、gcloud beta、gsutil、bq の各コマンドライン ツールのみです。kubectl は含まれていません。また、gcloud コマンドでアプリケーションをデプロイするために必要な App Engine 拡張機能も含まれていません。これらのコンポーネントが必要な場合は、個別にインストールする必要があります。
始める前に
gcloud CLI をインストールする前に、オペレーティング システムが次の要件を満たしていることを確認してください。
インストール
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、10、Fedora 41 と 42、CentOS 7 と 8 の各システムにインストールする場合、gcloud CLI はパッケージ形式で利用できます。このパッケージに含まれているのは、gcloud、gcloud alpha、gcloud beta、gsutil、bq の各コマンドのみです。kubectl は含まれていません。また、gcloud コマンドを使用してアプリケーションをデプロイするために必要な App Engine 拡張機能も含まれていません。このセクションの後半で説明するように、これらは個別にインストールできます。
インストール
gcloud CLI バージョンをダウングレードする
gcloud CLI を特定のバージョンに戻すには、次のコマンドを実行します。123.0.0 は、インストールするバージョンに置き換えます。
sudo dnf downgrade google-cloud-cli-123.0.0
リポジトリでは、常に最新の 10 個のリリースが利用可能です。371.0.0 より前のリリースの場合、パッケージ名として google-cloud-sdk を使用します。
Windows で Google Cloud CLI を使用するには、Windows 8.1 以降または Windows Server 2012 以降が必要です。
トラブルシューティングのヒント
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 をご覧ください。
コアコマンドを実行する
主要なコマンドを実行して、gcloud CLI のインストールに関する情報を表示します。
省略可: 追加のコンポーネントをインストールする
App Engine エミュレータ、kubectl、アルファ版またはベータ版のリリースレベルの gcloud CLI コマンドなどの追加コンポーネントをインストールするには、gcloud CLI コンポーネントの管理をご覧ください。
クリーンアップ
このページで使用したリソースについて、 Google Cloud アカウントに課金されないようにするには、次の手順で操作します。