Files
solution_architecture_agent/skills/google-cloud-iac-patterns/references/pubsub.md
Jonathan Boniface c84dbdea20 feat: the solution architecture agent on the shared Execution engine
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>
2026-10-21 19:49:28 +01:00

3.2 KiB

Pub/Sub

A topic, a push subscription that calls a private Cloud Run service, and a dead-letter topic.

  • A push subscription authenticates with push_config.oidc_token; its service account needs roles/run.invoker on the service it calls.
  • Dead-lettering needs two grants to the Pub/Sub service agent: roles/pubsub.publisher on the dead-letter topic and roles/pubsub.subscriber on the source subscription. Without them messages are never moved.
  • Give the dead-letter topic a subscription of its own, or the messages moved there are lost.
  • max_delivery_attempts is 5 to 100. ack_deadline_seconds is 10 to 600.
  • message_retention_duration is a duration in seconds, such as "604800s".
  • Customer-managed encryption is kms_key_name on the topic; the Pub/Sub service agent needs roles/cloudkms.cryptoKeyEncrypterDecrypter on the key first.
variable "project_id" {
  type        = string
  description = "Project to deploy into."
}

variable "region" {
  type        = string
  description = "Region for regional resources."
}

variable "worker_url" {
  type        = string
  description = "HTTPS URL of the service the subscription pushes to."
}

data "google_project" "this" {
  project_id = var.project_id
}

locals {
  pubsub_agent = "serviceAccount:service-${data.google_project.this.number}@gcp-sa-pubsub.iam.gserviceaccount.com"
}

resource "google_service_account" "push" {
  project      = var.project_id
  account_id   = "events-push"
  display_name = "Identity Pub/Sub pushes with"
}

resource "google_pubsub_topic" "events" {
  project                    = var.project_id
  name                       = "events"
  message_retention_duration = "604800s"

  message_storage_policy {
    allowed_persistence_regions = [var.region]
  }
}

resource "google_pubsub_topic" "dead_letter" {
  project = var.project_id
  name    = "events-dead-letter"
}

resource "google_pubsub_subscription" "dead_letter" {
  project                    = var.project_id
  name                       = "events-dead-letter"
  topic                      = google_pubsub_topic.dead_letter.id
  message_retention_duration = "1209600s"

  expiration_policy {
    ttl = ""
  }
}

resource "google_pubsub_subscription" "worker" {
  project              = var.project_id
  name                 = "events-worker"
  topic                = google_pubsub_topic.events.id
  ack_deadline_seconds = 60

  push_config {
    push_endpoint = var.worker_url

    oidc_token {
      service_account_email = google_service_account.push.email
      audience              = var.worker_url
    }
  }

  retry_policy {
    minimum_backoff = "10s"
    maximum_backoff = "600s"
  }

  dead_letter_policy {
    dead_letter_topic     = google_pubsub_topic.dead_letter.id
    max_delivery_attempts = 5
  }

  expiration_policy {
    ttl = ""
  }
}

resource "google_pubsub_topic_iam_member" "agent_publishes_dead_letters" {
  project = var.project_id
  topic   = google_pubsub_topic.dead_letter.name
  role    = "roles/pubsub.publisher"
  member  = local.pubsub_agent
}

resource "google_pubsub_subscription_iam_member" "agent_forwards_from_worker" {
  project      = var.project_id
  subscription = google_pubsub_subscription.worker.name
  role         = "roles/pubsub.subscriber"
  member       = local.pubsub_agent
}