クイックリファレンス

gcloud CLI のセットアップ

# インストール（公式ドキュメント参照: cloud.google.com/sdk）
# macOS
brew install --cask google-cloud-sdk

# 初期化（ブラウザ認証 + プロジェクト選択）
gcloud init

# 現在の設定確認
gcloud config list

# プロジェクト変更
gcloud config set project YOUR_PROJECT_ID

# 利用可能なリージョン一覧
gcloud compute regions list

Compute Engine

# VMインスタンス作成（無料枠: e2-micro, us-west1/us-central1/us-east1）
gcloud compute instances create my-vm \
  --machine-type=e2-micro \
  --zone=us-central1-a \
  --image-family=debian-12 \
  --image-project=debian-cloud

# SSH接続
gcloud compute ssh my-vm --zone=us-central1-a

# インスタンス一覧
gcloud compute instances list

# インスタンス停止・削除
gcloud compute instances stop my-vm --zone=us-central1-a
gcloud compute instances delete my-vm --zone=us-central1-a

Cloud Storage

# バケット作成
gsutil mb -l asia-northeast1 gs://my-unique-bucket-name

# ファイルアップロード
gsutil cp localfile.txt gs://my-unique-bucket-name/

# ディレクトリを再帰的にアップロード
gsutil -m cp -r ./dist gs://my-unique-bucket-name/

# 公開アクセス設定（静的サイトホスティング用）
gsutil iam ch allUsers:objectViewer gs://my-unique-bucket-name

Cloud Run

# コンテナイメージをArtifact Registryにプッシュ
gcloud builds submit --tag gcr.io/PROJECT_ID/my-app

# Cloud Runにデプロイ
gcloud run deploy my-app \
  --image gcr.io/PROJECT_ID/my-app \
  --platform managed \
  --region asia-northeast1 \
  --allow-unauthenticated

# デプロイ済みサービス一覧
gcloud run services list

---

よくある詰まりポイント

Q. gcloud コマンドで Permission denied エラーが出る

A. APIが有効化されていない場合があります。gcloud services enable compute.googleapis.com のようにAPIを有効化してください。GCPコンソールの「APIとサービス」画面からも有効化できます。初回プロジェクトでは多くのAPIがデフォルト無効なので注意が必要です。

Q. Cloud Runのデプロイが成功しているのにアプリが動かない

A. コンテナが PORT 環境変数で指定されたポートをリッスンしているか確認してください。Cloud Runはデフォルトで $PORT（通常8080）を使います。Dockerfileに ENV PORT 8080 を追加するか、アプリ側で process.env.PORT を読むようにしてください。ログは gcloud run logs read --service=my-app で確認できます。

Q. 無料枠を超えて課金されないか心配

A. GCPコンソールの「お支払い」→「予算とアラート」で上限アラートを設定しておくと安心です。学習中は使い終わったリソースを都度削除する習慣をつけましょう。gcloud compute instances list や gcloud run services list で起動中リソースを定期確認するのがおすすめです。