a6-recipe-canary

Automate canary releases for Apache APISIX with the a6 CLI.

1|2|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/moonming/a6 --skill a6-recipe-canary
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: a6-recipe-canary
Source: https://github.com/moonming/a6/tree/main/skills/a6-recipe-canary
Command: npx skills add https://github.com/moonming/a6 --skill a6-recipe-canary

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of gradually rolling out new application versions to production, minimizing the risk of widespread outages and allowing for real-time monitoring and rollback.

Core Features & Use Cases

  • Phased Rollouts: Implement canary releases by incrementally shifting traffic to a new version.
  • Traffic Splitting: Dynamically adjust traffic percentages between stable and canary versions using the traffic-split plugin.
  • Monitoring & Rollback: Define checkpoints for monitoring and enable quick rollback if issues arise.
  • Use Case: Deploy a new feature to 5% of users, monitor performance, then gradually increase to 25%, 50%, and finally 100% if all checks pass.

Quick Start

Use the a6-recipe-canary skill to start a canary release by creating stable and canary upstreams and a route with 5% traffic to the canary.

Frequently Asked Questions about a6-recipe-canary

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

FAQPage Schema
How do I configure a canary release in Apache APISIX?

You can automate canary releases in Apache APISIX using the a6 CLI to create stable and canary upstreams, then apply the traffic-split plugin to a route for weighted traffic distribution.

What is the best way to gradually shift traffic to a new deployment?

The best way to gradually shift traffic is through phased rollouts, starting with 5% to the canary version, monitoring performance, and incrementally adjusting weights to 25%, 50%, and 100%.

Does APISIX support header or cookie based routing for canary deployments?

Yes, APISIX supports header and cookie based routing for canary deployments, allowing you to direct specific user segments to the new upstream version via traffic-split plugin configuration.

How do I rollback traffic if a canary release fails?

To rollback a failed canary release, utilize the a6 CLI rollback workflows to quickly adjust traffic weights back to the stable upstream and restore the previous application version.

Can I dynamically adjust traffic percentages between stable and canary upstreams?

Yes, you can dynamically adjust traffic percentages between stable and canary upstreams by modifying the weighted upstream distribution settings configured via the APISIX traffic-split plugin.