tf-starter 1.0.0

package/tf_starter/templates/gcp/root/main.tf.j2

@@ -0,0 +1,210 @@
+# ---------------------------------------------------------------------------------------------------------------------
+# ROOT MAIN CONFIGURATION
+# Project: {{ project_name }}
+# Provider: GCP
+# Generated by tf-starter
+# ---------------------------------------------------------------------------------------------------------------------
+
+locals {
+  project_name = "{{ project_name }}"
+  region       = var.region
+  environment  = var.environment
+
+  common_labels = {
+    project     = local.project_name
+    environment = local.environment
+    managed-by  = "terraform"
+    generator   = "tf-starter"
+  }
+}
+
+# ---------------------------------------------------------------------------------------------------------------------
+# NETWORK MODULE (always included)
+# ---------------------------------------------------------------------------------------------------------------------
+
+module "network" {
+  source = "./modules/network"
+
+  project_name = local.project_name
+  environment  = local.environment
+  region       = local.region
+  project_id   = var.project_id
+
+  labels = local.common_labels
+}
+
+{% if "compute" in services %}
+# ---------------------------------------------------------------------------------------------------------------------
+# COMPUTE MODULE
+# ---------------------------------------------------------------------------------------------------------------------
+
+module "compute" {
+  source = "./modules/compute"
+
+  project_name = local.project_name
+  environment  = local.environment
+  project_id   = var.project_id
+  region       = local.region
+
+  network_self_link = module.network.network_self_link
+  subnet_self_link  = module.network.private_subnet_self_link
+
+  machine_type     = var.machine_type
+  min_replicas     = var.mig_min_replicas
+  max_replicas     = var.mig_max_replicas
+  target_size      = var.mig_target_size
+
+  labels = local.common_labels
+}
+{% endif %}
+
+{% if "lambda" in services %}
+# ---------------------------------------------------------------------------------------------------------------------
+# LAMBDA MODULE (Cloud Functions)
+# ---------------------------------------------------------------------------------------------------------------------
+
+module "lambda" {
+  source = "./modules/lambda"
+
+  project_name = local.project_name
+  environment  = local.environment
+  project_id   = var.project_id
+  region       = local.region
+
+  function_name         = var.function_name
+  runtime               = var.function_runtime
+  entry_point           = var.function_entry_point
+  timeout               = var.function_timeout
+  memory                = var.function_memory
+  max_instances         = var.function_max_instances
+  environment_variables = var.function_environment_variables
+
+  labels = local.common_labels
+}
+{% endif %}
+
+{% if "apigateway" in services %}
+# ---------------------------------------------------------------------------------------------------------------------
+# API GATEWAY MODULE
+# ---------------------------------------------------------------------------------------------------------------------
+
+module "apigateway" {
+  source = "./modules/apigateway"
+
+  project_name = local.project_name
+  environment  = local.environment
+  project_id   = var.project_id
+  region       = local.region
+
+  function_uri = module.lambda.function_uri
+
+  labels = local.common_labels
+}
+{% endif %}
+
+{% if "database" in services %}
+# ---------------------------------------------------------------------------------------------------------------------
+# DATABASE MODULE
+# ---------------------------------------------------------------------------------------------------------------------
+
+module "database" {
+  source = "./modules/database"
+
+  project_name = local.project_name
+  environment  = local.environment
+  project_id   = var.project_id
+  region       = local.region
+
+  network_self_link      = module.network.network_self_link
+  private_ip_range_name  = module.network.private_ip_range_name
+
+  db_tier      = var.db_tier
+  db_name      = var.db_name
+  db_user      = var.db_user
+  db_ha        = var.environment == "prod" ? true : false
+
+  labels = local.common_labels
+}
+{% endif %}
+
+{% if "kubernetes" in services %}
+# ---------------------------------------------------------------------------------------------------------------------
+# KUBERNETES MODULE (GKE)
+# ---------------------------------------------------------------------------------------------------------------------
+
+module "kubernetes" {
+  source = "./modules/kubernetes"
+
+  project_name = local.project_name
+  environment  = local.environment
+  project_id   = var.project_id
+  region       = local.region
+
+  network_self_link = module.network.network_self_link
+  subnet_self_link  = module.network.private_subnet_self_link
+
+  cluster_version    = var.gke_cluster_version
+  node_machine_type  = var.gke_node_machine_type
+  node_count         = var.gke_node_count
+  node_min_count     = var.gke_node_min_count
+  node_max_count     = var.gke_node_max_count
+
+  labels = local.common_labels
+}
+{% endif %}
+
+{% if "monitoring" in services %}
+# ---------------------------------------------------------------------------------------------------------------------
+# MONITORING MODULE
+# ---------------------------------------------------------------------------------------------------------------------
+
+module "monitoring" {
+  source = "./modules/monitoring"
+
+  project_name = local.project_name
+  environment  = local.environment
+  project_id   = var.project_id
+
+  notification_email = var.notification_email
+
+  labels = local.common_labels
+}
+{% endif %}
+
+{% if "messaging" in services %}
+# ---------------------------------------------------------------------------------------------------------------------
+# MESSAGING MODULE (Pub/Sub)
+# ---------------------------------------------------------------------------------------------------------------------
+
+module "messaging" {
+  source = "./modules/messaging"
+
+  project_name = local.project_name
+  environment  = local.environment
+  project_id   = var.project_id
+
+  message_retention_duration = var.pubsub_message_retention
+  ack_deadline_seconds       = var.pubsub_ack_deadline
+
+  labels = local.common_labels
+}
+{% endif %}
+
+{% if "storage" in services %}
+# ---------------------------------------------------------------------------------------------------------------------
+# STORAGE MODULE (GCS)
+# ---------------------------------------------------------------------------------------------------------------------
+
+module "storage" {
+  source = "./modules/storage"
+
+  project_name = local.project_name
+  environment  = local.environment
+  project_id   = var.project_id
+  region       = local.region
+
+  enable_versioning = var.gcs_enable_versioning
+
+  labels = local.common_labels
+}
+{% endif %}

package/tf_starter/templates/gcp/root/outputs.tf.j2

@@ -0,0 +1,61 @@
+# ---------------------------------------------------------------------------------------------------------------------
+# ROOT OUTPUTS — GCP
+# Generated by tf-starter
+# ---------------------------------------------------------------------------------------------------------------------
+
+output "network_self_link" {
+  description = "Self-link of the VPC network"
+  value       = module.network.network_self_link
+}
+
+{% if "compute" in services %}
+output "load_balancer_ip" {
+  description = "External IP of the load balancer"
+  value       = module.compute.load_balancer_ip
+}
+{% endif %}
+
+{% if "database" in services %}
+output "db_connection_name" {
+  description = "Cloud SQL connection name"
+  value       = module.database.connection_name
+}
+
+output "db_ip_address" {
+  description = "Cloud SQL private IP"
+  value       = module.database.private_ip
+}
+{% endif %}
+
+{% if "kubernetes" in services %}
+output "gke_cluster_endpoint" {
+  description = "GKE cluster endpoint"
+  value       = module.kubernetes.cluster_endpoint
+}
+
+output "gke_cluster_name" {
+  description = "GKE cluster name"
+  value       = module.kubernetes.cluster_name
+}
+{% endif %}
+
+{% if "monitoring" in services %}
+output "notification_channel_id" {
+  description = "Monitoring notification channel ID"
+  value       = module.monitoring.notification_channel_id
+}
+{% endif %}
+
+{% if "messaging" in services %}
+output "pubsub_topic_id" {
+  description = "Pub/Sub topic ID"
+  value       = module.messaging.topic_id
+}
+{% endif %}
+
+{% if "storage" in services %}
+output "gcs_bucket_name" {
+  description = "GCS bucket name"
+  value       = module.storage.bucket_name
+}
+{% endif %}

package/tf_starter/templates/gcp/root/providers.tf.j2

@@ -0,0 +1,18 @@
+# ---------------------------------------------------------------------------------------------------------------------
+# PROVIDER CONFIGURATION — GCP
+# Project: {{ project_name }}
+# Generated by tf-starter
+# ---------------------------------------------------------------------------------------------------------------------
+
+provider "google" {
+  project = var.project_id
+  region  = var.region
+
+  ### MUST EDIT THIS ###
+  # credentials = file("path/to/service-account-key.json")
+}
+
+provider "google-beta" {
+  project = var.project_id
+  region  = var.region
+}

package/tf_starter/templates/gcp/root/variables.tf.j2

@@ -0,0 +1,140 @@
+# ---------------------------------------------------------------------------------------------------------------------
+# ROOT VARIABLES — GCP
+# Project: {{ project_name }}
+# Generated by tf-starter
+# ---------------------------------------------------------------------------------------------------------------------
+
+variable "project_id" {
+  description = "GCP project ID"
+  type        = string
+
+  ### MUST EDIT THIS ###
+}
+
+variable "region" {
+  description = "GCP region"
+  type        = string
+  default     = "{{ region }}"
+}
+
+variable "environment" {
+  description = "Deployment environment"
+  type        = string
+  default     = "dev"
+
+  validation {
+    condition     = contains({{ environments | tf_list }}, var.environment)
+    error_message = "Environment must be one of: {{ environments | join(', ') }}."
+  }
+}
+
+{% if "compute" in services %}
+variable "machine_type" {
+  description = "Machine type for compute instances"
+  type        = string
+  default     = "e2-medium"
+}
+
+variable "mig_min_replicas" {
+  description = "Minimum replicas in MIG"
+  type        = number
+  default     = 1
+}
+
+variable "mig_max_replicas" {
+  description = "Maximum replicas in MIG"
+  type        = number
+  default     = 4
+}
+
+variable "mig_target_size" {
+  description = "Target size of MIG"
+  type        = number
+  default     = 2
+}
+{% endif %}
+
+{% if "database" in services %}
+variable "db_tier" {
+  description = "Cloud SQL instance tier"
+  type        = string
+  default     = "db-custom-2-7680"
+}
+
+variable "db_name" {
+  description = "Database name"
+  type        = string
+  default     = "{{ project_name | replace('-', '_') }}_db"
+}
+
+variable "db_user" {
+  description = "Database user"
+  type        = string
+  default     = "dbadmin"
+  sensitive   = true
+}
+{% endif %}
+
+{% if "kubernetes" in services %}
+variable "gke_cluster_version" {
+  description = "GKE cluster version"
+  type        = string
+  default     = "latest"
+}
+
+variable "gke_node_machine_type" {
+  description = "Machine type for GKE nodes"
+  type        = string
+  default     = "e2-standard-4"
+}
+
+variable "gke_node_count" {
+  description = "Initial node count"
+  type        = number
+  default     = 2
+}
+
+variable "gke_node_min_count" {
+  description = "Minimum node count"
+  type        = number
+  default     = 1
+}
+
+variable "gke_node_max_count" {
+  description = "Maximum node count"
+  type        = number
+  default     = 5
+}
+{% endif %}
+
+{% if "monitoring" in services %}
+variable "notification_email" {
+  description = "Email for monitoring notifications"
+  type        = string
+  default     = ""
+
+  ### MUST EDIT THIS ###
+}
+{% endif %}
+
+{% if "messaging" in services %}
+variable "pubsub_message_retention" {
+  description = "Pub/Sub message retention duration"
+  type        = string
+  default     = "604800s"
+}
+
+variable "pubsub_ack_deadline" {
+  description = "Pub/Sub acknowledgement deadline in seconds"
+  type        = number
+  default     = 20
+}
+{% endif %}
+
+{% if "storage" in services %}
+variable "gcs_enable_versioning" {
+  description = "Enable GCS bucket versioning"
+  type        = bool
+  default     = true
+}
+{% endif %}

package/tf_starter/templates/gcp/root/versions.tf.j2

@@ -0,0 +1,23 @@
+# ---------------------------------------------------------------------------------------------------------------------
+# TERRAFORM AND PROVIDER VERSIONS — GCP
+# Generated by tf-starter
+# ---------------------------------------------------------------------------------------------------------------------
+
+terraform {
+  required_version = ">= 1.6.0"
+
+  required_providers {
+    google = {
+      source  = "hashicorp/google"
+      version = "~> 5.20"
+    }
+    google-beta = {
+      source  = "hashicorp/google-beta"
+      version = "~> 5.20"
+    }
+    random = {
+      source  = "hashicorp/random"
+      version = "~> 3.6"
+    }
+  }
+}