canary

Automate canary deployments for Cloud Run with traffic management and rollback.

4|Updated Jul 20, 2026
One-click install
npx skills add https://github.com/highflame-ai/ai-factory --skill canary-highflame-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: canary
Source: https://github.com/highflame-ai/ai-factory/tree/main/skills/canary
Command: npx skills add https://github.com/highflame-ai/ai-factory --skill canary-highflame-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gcloud, docker, curl.

What problem does it solve?

This skill mitigates the risk of production outages by automating the deployment of code to a zero-traffic revision, verifying its health, and performing smoke tests before promoting it to live traffic.

Core Features & Use Cases

  • Zero-Traffic Verification: Deploys revisions to Cloud Run with no traffic, allowing for isolated testing.
  • Automated Health & Smoke Testing: Executes configurable health checks and custom smoke tests to ensure service stability.
  • Safe Promotion & Rollback: Automatically promotes the canary to 100% traffic upon success or performs an immediate rollback if any tests fail.

Quick Start

Run the canary skill to deploy the current branch to the production service and verify it with smoke tests.

Frequently Asked Questions about canary

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

FAQPage Schema
How do I automate canary deployments for Cloud Run services?

Automate Cloud Run canary deployments by deploying a zero-traffic revision, executing health checks and smoke tests, and automatically promoting successful revisions to 100% traffic or rolling back upon failure. This requires a valid .aif/config.yml service definition.

What is a zero-traffic revision deployment in Cloud Run?

A zero-traffic revision deployment pushes new code to Cloud Run without routing live traffic to it. This isolation allows automated health checks and smoke tests to verify service stability before promoting the canary.

Do I need gcloud CLI authentication and a config file to run automated smoke tests?

Yes, executing automated smoke tests and canary gates requires gcloud CLI authentication. You also need a valid .aif/config.yml service definition to configure and deploy the Cloud Run revision.

How does automated rollback work when a canary smoke test fails?

Automated rollback triggers immediately when health checks or custom smoke tests fail during the canary phase. The system prevents the faulty revision from receiving live traffic, mitigating the risk of production outages.

Can I use this canary deployment skill with Docker and curl dependencies?

Yes, the canary deployment process leverages Docker for containerized builds and curl for executing smoke tests. These dependencies integrate directly with gcloud to manage Cloud Run revision traffic.

What is the best way to prevent production outages during CI/CD releases?

The best way to prevent production outages during CI/CD releases is using automated canary gates. This approach validates new revisions with isolated health checks and smoke tests before routing any live traffic.