infrastructure-standards

Infrastructure Standards

New Project Preferences

When starting new projects, prefer:

• Terraform for Infrastructure as Code
• GCP (Google Cloud Platform) by default, unless otherwise specified
• Serverless architectures that are free when idle (Cloud Run, Cloud Functions)
• Docker Compose for local development

Terraform

Project Structure

infrastructure/
├── main.tf           # Main configuration
├── variables.tf      # Input variables
├── outputs.tf        # Output values
├── providers.tf      # Provider configuration
├── terraform.tfvars  # Variable values (gitignored for secrets)
└── modules/          # Reusable modules
    └── api/
        ├── main.tf
        ├── variables.tf
        └── outputs.tf

Best Practices

• Use remote state (GCS bucket for GCP)
• Lock state files to prevent concurrent modifications
• Use workspaces or separate state files for environments
• Tag all resources consistently
• Use modules for reusable infrastructure

GCP Provider Setup

terraform {
  required_version = ">= 1.0"

  required_providers {
    google = {
      source  = "hashicorp/google"
      version = "~> 5.0"
    }
  }

  backend "gcs" {
    bucket = "project-terraform-state"
    prefix = "terraform/state"
  }
}

provider "google" {
  project = var.project_id
  region  = var.region
}

GCP Services

Preferred Services (Free When Idle)

Use Case	Service	Notes
APIs/Backend	Cloud Run	Scale to zero, pay per request
Background Jobs	Cloud Functions	Event-driven, scale to zero
Scheduled Tasks	Cloud Scheduler + Cloud Functions	Cron-like scheduling
Database	Cloud SQL (small) or Firestore	Firestore has free tier
Storage	Cloud Storage	Pay per use
Auth	Firebase Auth	Free tier generous

Cloud Run Example

resource "google_cloud_run_service" "api" {
  name     = "api"
  location = var.region

  template {
    spec {
      containers {
        image = "gcr.io/${var.project_id}/api:latest"

        resources {
          limits = {
            memory = "512Mi"
            cpu    = "1"
          }
        }
      }
    }

    metadata {
      annotations = {
        "autoscaling.knative.dev/minScale" = "0"  # Scale to zero
        "autoscaling.knative.dev/maxScale" = "10"
      }
    }
  }
}