目的別の gcloud コマンド リファレンス
認証と設定
gcloud CLI の初期設定、アカウント認証、プロジェクトやリージョン/ゾーンの設定を行います。
| 目的 | コマンド例 | 説明 |
|---|---|---|
| 初期化 | | 対話形式で初期設定(アカウント認証、プロジェクト選択、デフォルトリージョン/ゾーン設定)を行います。 |
| アカウント認証 | | ブラウザを開き、Googleアカウントで認証します。 |
| サービスアカウント認証 | | サービスアカウントキーファイルを使用して認証します。CI/CD環境でよく利用されます。 |
| 認証済みアカウント一覧 | | 現在認証済みのアカウントを表示します。アクティブなアカウントには * が付きます。 |
| アカウント切り替え | | 指定したメールアドレスのアカウントに切り替えます。(事前に `gcloud auth login` で認証が必要) |
| 認証情報取り消し | | 指定したアカウントの認証情報(クレデンシャル)をローカルから削除します。 |
| 設定一覧表示 | | 現在の gcloud 設定(プロジェクト、アカウント、リージョン、ゾーンなど)を表示します。 |
| プロジェクト設定 | | デフォルトのプロジェクトIDを設定します。 |
| リージョン設定 | | デフォルトのリージョンを設定します。(例: asia-northeast1) |
| ゾーン設定 | | デフォルトのゾーンを設定します。(例: asia-northeast1-a) |
| 特定の設定値表示 | | 指定した設定キー(ここでは project)の値を取得します。 |
| 設定解除 | | 指定した設定(ここでは compute/zone)を解除します。 |
プロジェクト管理
Google Cloud プロジェクトの情報を一覧表示したり、詳細を確認します。
| 目的 | コマンド例 | 説明 |
|---|---|---|
| プロジェクト一覧表示 | | アクセス可能なプロジェクトの一覧(プロジェクトID、プロジェクト番号、名前)を表示します。 |
| プロジェクト詳細表示 | | 指定したプロジェクトIDの詳細情報を表示します。 |
Compute Engine (VMインスタンス)
仮想マシンインスタンスの作成、管理、接続などを行います。
| 目的 | コマンド例 | 説明 |
|---|---|---|
| インスタンス作成 (最小構成) | | 指定した名前で、デフォルト設定(マシンタイプ、イメージ、ゾーンなど)のVMインスタンスを作成します。 |
| インスタンス作成 (オプション指定) | | マシンタイプ、イメージ、ディスクサイズ、ゾーン、タグ、起動スクリプトなどを指定してインスタンスを作成します。 |
| インスタンス一覧表示 | | 現在のプロジェクト、デフォルトゾーン(または全ゾーン)のインスタンス一覧を表示します。 |
| インスタンス一覧表示 (全ゾーン) | | 全ゾーンのインスタンス一覧を表示します。 |
| インスタンス詳細表示 | | 指定したインスタンスの詳細情報(IPアドレス、マシンタイプ、ディスクなど)を表示します。 |
| インスタンス停止 | | 指定したインスタンスを停止します。停止中は課金が一部発生します(ディスクなど)。 |
| インスタンス起動 | | 停止中のインスタンスを起動します。 |
| インスタンスリセット | | インスタンスを強制的にリセット(再起動)します。 |
| インスタンス削除 | | 指定したインスタンスを削除します。--quietで確認プロンプトをスキップします。 |
| インスタンスへSSH接続 | | 指定したインスタンスにSSH接続します。必要に応じてSSHキーを自動生成・登録します。 |
| インスタンスへSSHコマンド実行 | | 指定したインスタンスで特定のコマンドを実行します。 |
| ファイルコピー (ローカルからVM) | | ローカルファイルを指定したインスタンスのディレクトリにコピーします。 |
| ファイルコピー (VMからローカル) | | インスタンス上のファイルをローカルディレクトリにコピーします。 |
| インスタンスグループ作成 (Managed) | | マネージドインスタンスグループ(MIG)を作成します。オートスケーリングや自動修復に利用します。 |
| インスタンステンプレート作成 | | インスタンスグループの元となるインスタンステンプレートを作成します。 |
Compute Engine (ディスク・スナップショット)
永続ディスクの管理や、バックアップのためのスナップショット操作を行います。
| 目的 | コマンド例 | 説明 |
|---|---|---|
| ディスク作成 | | 指定したサイズ、タイプの永続ディスクをゾーンに作成します。 |
| ディスク一覧表示 | | 現在のプロジェクト、デフォルトゾーン(または全ゾーン)のディスク一覧を表示します。 |
| ディスク詳細表示 | | 指定したディスクの詳細情報を表示します。 |
| ディスク削除 | | 指定したディスクを削除します。VMにアタッチされている場合は削除できません。 |
| ディスクをVMにアタッチ | | 既存のディスクをVMインスタンスに追加でアタッチします。 |
| ディスクをVMからデタッチ | | VMインスタンスからディスクをデタッチします。 |
| ディスクスナップショット作成 | | 指定したディスクのスナップショット(バックアップ)を作成します。 |
| スナップショット一覧表示 | | プロジェクト内のスナップショット一覧を表示します。 |
| スナップショット詳細表示 | | 指定したスナップショットの詳細情報を表示します。 |
| スナップショットからディスク作成 | | スナップショットを元に新しい永続ディスクを作成します。 |
| スナップショット削除 | | 指定したスナップショットを削除します。 |
Compute Engine (ネットワーク・ファイアウォール)
VPCネットワークやファイアウォールルールの管理を行います。
| 目的 | コマンド例 | 説明 |
|---|---|---|
| ネットワーク一覧表示 | | プロジェクト内のVPCネットワーク一覧を表示します。 |
| ネットワーク作成 (Auto Mode) | | 各リージョンに自動でサブネットが作成される Auto Mode の VPC ネットワークを作成します。 |
| ネットワーク作成 (Custom Mode) | | サブネットを手動で作成する必要がある Custom Mode の VPC ネットワークを作成します。 |
| サブネット作成 | | Custom Mode ネットワーク内にサブネットを作成します。 |
| ネットワーク削除 | | 指定したVPCネットワークを削除します。関連リソース(サブネット、VMなど)がないことが条件です。 |
| ファイアウォールルール一覧表示 | | プロジェクト内のファイアウォールルール一覧を表示します。 |
| ファイアウォールルール作成 (HTTP許可) | | 特定のタグが付いたインスタンスへのHTTP (TCPポート80) トラフィックを許可するルールを作成します。 |
| ファイアウォールルール作成 (内部SSH許可) | | 指定したネットワーク内の特定IP範囲からのSSH (TCPポート22) を許可します。 |
| ファイアウォールルール削除 | | 指定したファイアウォールルールを削除します。 |
Cloud Storage
オブジェクトストレージである Cloud Storage のバケットやオブジェクトを操作します。
| 目的 | コマンド例 | 説明 |
|---|---|---|
| バケット作成 | | 指定した名前、ロケーションで Cloud Storage バケットを作成します。均一なバケットレベルアクセスを有効にするのが推奨です。 |
| バケット一覧表示 | | プロジェクト内のバケット一覧を表示します。 |
| バケット削除 | | 指定したバケットを削除します。バケット内が空である必要があります。 |
| オブジェクト一覧表示 | | 指定したバケット内のオブジェクト(ファイルやフォルダ)一覧を表示します。 |
| オブジェクトコピー (ローカル→GCS) | | ローカルファイルを Cloud Storage バケットにコピーします。 |
| オブジェクトコピー (GCS→ローカル) | | Cloud Storage バケットのオブジェクトをローカルにコピーします。 |
| オブジェクトコピー (GCS→GCS) | | バケット間でオブジェクトをコピーします。 |
| ディレクトリ同期 (ローカル→GCS) | | ローカルディレクトリの内容を GCS と同期します。--delete-unmatched-destination-objects で GCS 側の余分なファイルを削除します。 |
| ディレクトリ同期 (GCS→ローカル) | | GCS ディレクトリの内容をローカルと同期します。 |
| オブジェクト移動/リネーム (GCS内) | | バケット内でオブジェクトを移動またはリネームします。 |
| オブジェクト削除 | | 指定したオブジェクトを削除します。 |
| フォルダ(プレフィックス)削除 | | 指定したフォルダ(実際はプレフィックス)内の全オブジェクトを再帰的に削除します。 |
| 署名付きURL生成 | | 期間限定でオブジェクトへのアクセスを許可する署名付きURLを生成します。サービスアカウントキーが必要です。 |
Google Kubernetes Engine (GKE)
コンテナオーケストレーションサービス GKE のクラスタやノードプールを管理します。
| 目的 | コマンド例 | 説明 |
|---|---|---|
| GKEクラスタ作成 (Standard) | | 指定したゾーンに Standard モードの GKE クラスタを作成します。ノード数を指定できます。 |
| GKEクラスタ作成 (Autopilot) | | 指定したリージョンに Autopilot モードの GKE クラスタを作成します。ノード管理が自動化されます。 |
| クラスタ一覧表示 | | プロジェクト内の GKE クラスタ一覧を表示します。 |
| クラスタ詳細表示 | | 指定したクラスタの詳細情報を表示します。(Standardはゾーン、Autopilotはリージョン指定) |
| kubectl 認証情報取得 | | 指定したクラスタに kubectl でアクセスするための認証情報を取得し、kubeconfig ファイルを更新します。 |
| クラスタリサイズ (Standard) | | Standard クラスタの指定したノードプールのノード数を変更します。 |
| クラスタ削除 | | 指定した GKE クラスタを削除します。 |
| ノードプール一覧表示 (Standard) | | Standard クラスタ内のノードプール一覧を表示します。 |
| ノードプール作成 (Standard) | | Standard クラスタに新しいノードプールを追加します。 |
| ノードプール削除 (Standard) | | 指定したノードプールを削除します。 |
GKE クラスタ操作後、kubectl コマンドを使用して Kubernetes リソース(Pod, Service, Deployment など)を管理します。
# kubectl コマンド例 (認証情報取得後)
kubectl get nodes
kubectl get pods -n NAMESPACE
kubectl apply -f manifest.yamlCloud SQL
フルマネージドなリレーショナルデータベースサービス Cloud SQL のインスタンスを管理します。
| 目的 | コマンド例 | 説明 |
|---|---|---|
| インスタンス一覧表示 | | プロジェクト内の Cloud SQL インスタンス一覧を表示します。 |
| インスタンス作成 (PostgreSQL) | | PostgreSQL の Cloud SQL インスタンスを作成します。バージョン、マシンタイプ(ティア)、リージョン、ルートパスワードを指定します。 |
| インスタンス作成 (MySQL) | | MySQL の Cloud SQL インスタンスを作成します。作成後にルートパスワードを設定する必要があります。 |
| インスタンス詳細表示 | | 指定したインスタンスの詳細情報(IPアドレス、接続名、設定など)を表示します。 |
| インスタンス削除 | | 指定した Cloud SQL インスタンスを削除します。 |
| インスタンスへ接続 (Cloud Shell) | | Cloud Shell や gcloud がインストールされた環境から、指定したユーザーで Cloud SQL インスタンスに接続します。 |
| ユーザー作成 | | Cloud SQL インスタンスに新しいユーザーを作成します。 |
| データベース作成 | | Cloud SQL インスタンス内に新しいデータベースを作成します。 |
Cloud Functions
サーバーレスのイベント駆動型コンピューティングサービス Cloud Functions の関数をデプロイ、管理します。
| 目的 | コマンド例 | 説明 |
|---|---|---|
| 関数デプロイ (HTTPトリガー) | | HTTPリクエストによってトリガーされる関数をデプロイします。ランタイム、トリガー、認証、ソースコードの場所、エントリポイントを指定します。 |
| 関数デプロイ (Pub/Subトリガー) | | Pub/Sub トピックへのメッセージ発行によってトリガーされる関数をデプロイします。 |
| 関数デプロイ (Cloud Storage トリガー) | | Cloud Storage バケットへのオブジェクト作成 (finalize) によってトリガーされる関数をデプロイします。 |
| 関数一覧表示 | | 指定したリージョンの Cloud Functions 関数一覧を表示します。 |
| 関数詳細表示 | | 指定した関数の詳細情報(トリガーURL、ランタイム、メモリなど)を表示します。 |
| 関数削除 | | 指定した関数を削除します。 |
| 関数呼び出し (HTTP) | | HTTPトリガーの関数を呼び出し、データを渡します。 |
| 関数ログ表示 | | 指定した関数のログを表示します。件数を指定できます。 |
App Engine
フルマネージドなアプリケーションプラットフォーム App Engine にアプリケーションをデプロイ、管理します。
| 目的 | コマンド例 | 説明 |
|---|---|---|
| アプリ作成 (リージョン選択) | | プロジェクトで初めて App Engine を使用する際に、アプリケーションのリージョンを選択します。一度選択すると変更できません。 |
| アプリケーションデプロイ | | `app.yaml` 設定ファイルに基づいてアプリケーションをデプロイします。カレントディレクトリのソースコードがアップロードされます。 |
| 特定サービスのデプロイ | | `app.yaml` 以外(例: `service.yaml`)で定義された特定のサービスをデプロイします。 |
| デプロイ (バージョン指定、トラフィック移行なし) | | 新しいバージョンとしてデプロイしますが、すぐにトラフィックを移行しません。手動での切り替えやカナリアリリースに利用します。 |
| サービス一覧表示 | | App Engine アプリケーション内のサービス一覧を表示します。 |
| バージョン一覧表示 | | 指定したサービスのバージョン一覧を表示します。トラフィックの割り当ても確認できます。 |
| トラフィック分割設定 | | 指定したサービスで、バージョン間のトラフィック割り当て比率を設定します。 |
| デプロイされたアプリ表示 | | デフォルトサービスのデフォルトバージョンの URL をブラウザで開きます。 |
| アプリケーションログ表示 | | 指定したサービス、バージョンのアプリケーションログを表示します。 |
| ログストリーミング | | デフォルトサービスのログをリアルタイムで表示(ストリーミング)します。 |
IAM (Identity and Access Management)
Google Cloud リソースへのアクセス権限(誰が、何に、何ができるか)を管理します。
| 目的 | コマンド例 | 説明 |
|---|---|---|
| プロジェクトのIAMポリシー取得 | | 指定したプロジェクトの現在の IAM ポリシー(ロールとメンバーのバインディング)を表示します。 |
| ロールをメンバーに追加 | | 指定したプロジェクトで、特定のメンバー(ユーザー、サービスアカウント、グループ)に IAM ロールを付与します。 |
| ロールをメンバーに追加 (サービスアカウント) | | サービスアカウントにロールを付与します。 |
| メンバーからロールを削除 | | 指定したプロジェクトで、特定のメンバーから IAM ロールを削除します。 |
| 特定リソースのIAMポリシー取得 (例: バケット) | | プロジェクトレベルだけでなく、個別のリソース(バケット、インスタンスなど)の IAM ポリシーも取得できます。 |
| 特定リソースにロールをメンバーに追加 (例: バケット) | | 特定の Google グループにバケット内のオブジェクト閲覧権限を付与します。 |
| サービスアカウント一覧表示 | | プロジェクト内のサービスアカウント一覧を表示します。 |
| サービスアカウント作成 | | 新しいサービスアカウントを作成します。`SA_NAME` はアカウントIDの一部になります。 |
| サービスアカウントキー作成 | | 指定したサービスアカウントの秘密鍵ファイル (`key.json`) を作成しダウンロードします。取り扱いに注意が必要です。 |
| サービスアカウント削除 | | 指定したサービスアカウントを削除します。 |
Cloud Logging
Google Cloud サービスやアプリケーションのログを収集、表示、分析します。
| 目的 | コマンド例 | 説明 |
|---|---|---|
| ログエントリ読み取り (簡易) | | 指定したリソースタイプの最新ログエントリを読み取ります。フィルタ構文を使用します。 |
| ログエントリ読み取り (詳細フィルタ) | | リソースタイプ、インスタンスID、重要度、タイムスタンプなどでフィルタリングし、特定のフォーマットで表示します。 |
| ログエントリ書き込み | | 指定したログ名にカスタムログエントリを書き込みます。JSONペイロードを指定できます。 |
| 利用可能なログ一覧表示 | | プロジェクトで現在利用可能なログ(ログ名)の一覧を表示します。 |
| ログシンク作成 | | 特定のフィルタに一致するログエントリを指定した宛先(Cloud Storage バケット、Pub/Sub トピック、BigQuery データセット)にエクスポートするシンクを作成します。 |
| ログシンク一覧表示 | | プロジェクト内のログシンク一覧を表示します。 |
| ログシンク削除 | | 指定したログシンクを削除します。 |
API とサービス管理
プロジェクトで使用する Google Cloud API やサービスを有効化、管理します。
| 目的 | コマンド例 | 説明 |
|---|---|---|
| 利用可能なサービス一覧表示 | | プロジェクトで利用可能な(有効化できる)全ての Google Cloud API/サービスを表示します。 |
| 有効なサービス一覧表示 | | プロジェクトで現在有効になっている API/サービスを表示します。 |
| サービス有効化 | | 指定した API/サービス(例: Compute Engine API)をプロジェクトで有効にします。 |
| サービス無効化 | | 指定した API/サービスを無効にします。依存関係がある場合は注意が必要です。--force で確認をスキップします。 |
その他便利なコマンド
その他の役立つ gcloud コマンドです。
| 目的 | コマンド例 | 説明 |
|---|---|---|
| gcloud コンポーネント更新 | | gcloud CLI 本体とインストールされているコンポーネント(alpha, beta コマンドなど)を最新バージョンに更新します。 |
| gcloud バージョン確認 | | インストールされている gcloud CLI のバージョンと、各コンポーネントのバージョンを表示します。 |
| コマンドヘルプ表示 | | 特定の gcloud コマンド(例: `gcloud compute instances create`)の詳細なヘルプ、オプション、使用例を表示します。 |
| インタラクティブシェル | | オートコンプリートやコマンド提案機能を持つインタラクティブなシェルを起動します。(Alpha 機能) |