deployment-gcp-canary-setup

Automate progressive canary deployments for Google Cloud Run with Terraform.

Updated Oct 27, 2025
One-click install
npx skills add https://github.com/mariotoffia/gobridge --skill deployment-gcp-canary-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deployment-gcp-canary-setup
Source: https://github.com/mariotoffia/gobridge/tree/main/.cursor/skills/deployment-gcp-canary-setup
Command: npx skills add https://github.com/mariotoffia/gobridge --skill deployment-gcp-canary-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables teams to safely roll out updates to Cloud Run services by employing progressive canary deployments, reducing blast radius and risk to end users.

Core Features & Use Cases

  • Traffic splitting: Gradually route traffic to new revisions to validate changes with real traffic.
  • Automatic rollback: Detects degraded performance or errors and reverts traffic to a stable revision.
  • Terraform-driven deployment: Uses infrastructure-as-code to manage Cloud Run configurations, alerts, and canary targets.
  • Observability setup: Creates Cloud Monitoring alerts for error rate and latency and provides quick rollback paths.

Quick Start

  1. Install and configure gcloud and Terraform, then initialize your project.
  2. Define your service and canary_percent, then run the deployment workflow (e.g., make deploy-canary PERCENT=10 VERSION=your-tag STAGE=prod).
  3. Validate canary health and, if needed, rollback to the previous revision.

Frequently Asked Questions about deployment-gcp-canary-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up progressive canary deployments on Google Cloud Run?

Progressive canary deployments on Cloud Run are automated by gradually routing traffic to new revisions. This minimizes blast radius by validating changes with real traffic before a full rollout.

Can I manage Cloud Run traffic splitting using Terraform?

Yes, Terraform manages Cloud Run traffic splitting configurations as infrastructure-as-code. It defines service configurations and canary targets to automatically route a specified percentage of traffic to new revisions.

How do I configure automated rollback for a Cloud Run canary release?

Automated rollback for a Cloud Run canary release reverts traffic to a stable revision when degraded performance or errors are detected. Makefile targets provide quick rollback paths to restore service availability.

How do I create Cloud Monitoring alerts for error rate and latency during a canary deployment?

Cloud Monitoring alerts for error rate and latency are created using Terraform during the canary deployment setup. These alerts detect degraded performance automatically, triggering an automated rollback to protect end users.

Does this canary deployment approach work for both staging and production environments?

Yes, this canary deployment approach covers both staging and production environments. It applies infrastructure-as-code requirements consistently across stages to manage traffic splitting and automated rollback safely.

What's the best way to minimize blast radius when rolling out updates to Cloud Run services?

To minimize blast radius when rolling out updates to Cloud Run services, use progressive canary deployments. This technique gradually routes traffic to new revisions, automatically reverting if Cloud Monitoring detects errors.