The reference agent's subject, cloud solution architecture, as an agent in the operating model agent's pattern: the Execution engine (from orchestration_engine) and one Workflow in app/solution_architecture, built for the settings and provider bundle by assembly.workflow_for. Copied from gcp_solution_architecture_agent at 8b397cd without its own engine: its role files, Skills, provider bundle, ADRs, vocabulary, scripts and evaluation datasets. The image takes the engine from a named build context and installs Terraform. It is called through the Orchestration engine, and its files are what the operating model agent digests. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
103 lines
3.2 KiB
Markdown
103 lines
3.2 KiB
Markdown
# Cloud SQL for PostgreSQL on a private address
|
|
|
|
A PostgreSQL instance reachable only inside a VPC, with the private services access it needs. Replaces a reserved range, a service networking connection, the instance, its database and its user.
|
|
|
|
- The instance must wait for the peering: pass `module.private_access.peering_completed` in `module_depends_on`.
|
|
- `ip_configuration.ipv4_enabled = false` is what removes the public address. `private_network` is the network's self link.
|
|
- `availability_type = "REGIONAL"` gives a standby in a second zone.
|
|
- `deletion_protection` is the Terraform guard; `deletion_protection_enabled` is the guard in the API. Set both from a variable.
|
|
- With `enable_default_user = true` the module generates a password and exposes it as an output. Prefer IAM database authentication: set `enable_default_user = false`, add the `cloudsql.iam_authentication` flag and list `iam_users`.
|
|
- `random_instance_name = true` adds a suffix, which lets an instance be recreated: a deleted instance's name is reserved for a week.
|
|
|
|
```hcl
|
|
variable "project_id" {
|
|
type = string
|
|
description = "Project to deploy into."
|
|
}
|
|
|
|
variable "region" {
|
|
type = string
|
|
description = "Region for regional resources."
|
|
}
|
|
|
|
variable "network_name" {
|
|
type = string
|
|
description = "Name of the VPC the database is reached from."
|
|
}
|
|
|
|
variable "network_self_link" {
|
|
type = string
|
|
description = "Self link of that VPC."
|
|
}
|
|
|
|
variable "app_service_account_email" {
|
|
type = string
|
|
description = "Service account that connects to the database."
|
|
}
|
|
|
|
variable "deletion_protection" {
|
|
type = bool
|
|
description = "Whether the instance is protected from deletion."
|
|
default = true
|
|
}
|
|
|
|
module "private_access" {
|
|
source = "terraform-google-modules/sql-db/google//modules/private_service_access"
|
|
version = "28.3.0"
|
|
|
|
project_id = var.project_id
|
|
vpc_network = var.network_name
|
|
prefix_length = 20
|
|
}
|
|
|
|
module "database" {
|
|
source = "terraform-google-modules/sql-db/google//modules/postgresql"
|
|
version = "28.3.0"
|
|
|
|
project_id = var.project_id
|
|
region = var.region
|
|
name = "workload"
|
|
random_instance_name = true
|
|
database_version = "POSTGRES_16"
|
|
edition = "ENTERPRISE"
|
|
tier = "db-custom-2-7680"
|
|
availability_type = "REGIONAL"
|
|
disk_autoresize = true
|
|
|
|
deletion_protection = var.deletion_protection
|
|
deletion_protection_enabled = var.deletion_protection
|
|
|
|
ip_configuration = {
|
|
ipv4_enabled = false
|
|
private_network = var.network_self_link
|
|
ssl_mode = "ENCRYPTED_ONLY"
|
|
}
|
|
|
|
backup_configuration = {
|
|
enabled = true
|
|
start_time = "02:00"
|
|
point_in_time_recovery_enabled = true
|
|
retained_backups = 14
|
|
retention_unit = "COUNT"
|
|
}
|
|
|
|
database_flags = [
|
|
{
|
|
name = "cloudsql.iam_authentication"
|
|
value = "on"
|
|
}
|
|
]
|
|
|
|
db_name = "app"
|
|
enable_default_user = false
|
|
iam_users = [
|
|
{
|
|
id = "app"
|
|
email = var.app_service_account_email
|
|
}
|
|
]
|
|
|
|
module_depends_on = [module.private_access.peering_completed]
|
|
}
|
|
```
|