a6-recipe-blue-green

Manage blue-green traffic switching for Apache APISIX routes via a6 CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables zero-downtime deployments and instant rollbacks for applications managed by Apache APISIX, minimizing operational risk and ensuring continuous availability.

Core Features & Use Cases

  • Blue-Green Deployment: Implement strategies for seamlessly switching traffic between production environments.
  • Traffic Management: Control traffic flow using APISIX routes and plugins like traffic-split.
  • Declarative Configuration: Manage deployments using a6 config sync for auditable and repeatable processes.
  • Use Case: Safely deploy a new version of your API by first directing a small percentage of traffic to it, then gradually increasing the percentage until all traffic is on the new version, with the ability to revert instantly if issues arise.

Quick Start

Use the a6-recipe-blue-green skill to switch traffic from the 'blue' upstream to the 'green' upstream for the 'api' route.

Frequently Asked Questions about a6-recipe-blue-green

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

FAQPage Schema
How do I perform a zero downtime deployment in Apache APISIX?

Zero downtime deployment in Apache APISIX is achieved by implementing a blue-green deployment strategy to seamlessly switch traffic between distinct upstream environments via route updates or the traffic-split plugin.

How do I roll back traffic instantly if a new API version fails?

To roll back traffic instantly, you can use the a6 CLI to revert traffic switching between your blue and green upstream environments. This procedure immediately redirects traffic back to the stable version if issues arise.

Can I gradually shift traffic to a new upstream using APISIX?

Yes, you can gradually shift traffic to a new upstream using the APISIX traffic-split plugin. This allows you to direct a small percentage of traffic to the new version and increase it incrementally until all traffic is switched.

Does Apache APISIX support declarative configuration management for deployments?

Yes, Apache APISIX supports declarative configuration management for deployments using the a6 config sync command. This provides auditable and repeatable processes for managing your traffic switching and upstream environments.

What is the best way to manage traffic switching between two production environments?

The best way to manage traffic switching between two production environments is a blue-green deployment strategy. Using the a6 CLI, you can control traffic flow via APISIX routes and the traffic-split plugin for safe transitions.