Skip to content

README_GCP.md

Latest commit

 

History

History
44 lines (33 loc) · 1.58 KB

README_GCP.md

File metadata and controls

44 lines (33 loc) · 1.58 KB
Raw

Deploying Werewolf to Google Cloud Platform

This project uses Terraform to manage infrastructure as code. It deploys:

  1. Compute Engine (main): An e2-micro instance (Free Tier) running Redis and serving as a general utility server.
  2. Cloud Run: Two services (werewolf-backend and werewolf-frontend) connected to the VM via Direct VPC Egress.

Prerequisites

  1. Google Cloud SDK: Installed and authenticated (gcloud auth login).
  2. Terraform: Installed (brew install terraform).
  3. Project: A GCP project (e.g., tbd-project-82910).

Deployment Guide

1. Build and Push Images

Ensure your latest code is built and pushed to GitHub Container Registry (GHCR). Usually done via GitHub Actions, but you can trigger it by tagging a release.

2. Deploy Infrastructure

Run the helper script:

./scripts/deploy_infra.sh 0.1.1

This script will:

  • Initialize Terraform.
  • Plan the deployment using images from ghcr.io/WeixuanZ/....
  • Ask for confirmation before applying.

3. Verification

After deployment, the script outputs the Frontend URL. Visit it to play the game.

Infrastructure Details

Networking

  • VPC: werewolf-vpc
  • Subnet: werewolf-subnet (Required for Direct VPC Egress)
  • Firewall:
    • Internal: Allows Cloud Run to talk to Redis (port 6379).
    • SSH (IAP): Allows you to SSH into main safely using gcloud compute ssh.

Free Tier Strategy

  • VM: Uses e2-micro in us-central1. (Limit: 1 per billing account).
  • Disk: 30GB Standard PD.
  • Cloud Run: Scales to zero when not in use.