recovery-controller-setup

Configures AWS Application Recovery Controller routing controls, safety rules, and zonal shift for failover.

2.5k|282|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/aws/agent-toolkit-for-aws --skill recovery-controller-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: recovery-controller-setup
Source: https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/resilience-skills/recovery-controller-setup
Command: npx skills add https://github.com/aws/agent-toolkit-for-aws --skill recovery-controller-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Setting up cross-Region failover and Availability Zone recovery with AWS Application Recovery Controller (ARC) involves multiple APIs, safety mechanisms, and Regional endpoint nuances that are easy to misconfigure, risking scenarios like accidentally turning off all traffic.

Core Features & Use Cases

  • Routing Controls with Safety Rules: Creates per-Region routing controls plus assertion and gating safety rules that prevent unsafe states such as disabling all Regions at once.
  • Zonal Shift and Zonal Autoshift: Configures manual zonal shifts for AZ impairment and enables autoshift with practice-run configurations, outcome alarms, and blocked windows.
  • Use Case: After a resilience review finds no recovery mechanism for a checkout service, use this Skill to create routing controls in us-east-1 and us-west-2, add an at-least-one-active safety rule, test an atomic failover, and enable zonal autoshift on the ALB.

Quick Start

Set up ARC routing controls with safety rules for my checkout service across us-east-1 and us-west-2, then enable zonal autoshift on my load balancer.

Frequently Asked Questions about recovery-controller-setup

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

FAQPage Schema
How do I set up cross-Region failover with AWS Application Recovery Controller?

Create one routing control per Region using route53-recovery-control-config create-routing-control against an existing cluster and control panel, then add an assertion safety rule requiring at least one active control. Wire the routing controls to Route53 health checks and failover DNS records so state changes actually affect traffic.

How do I enable zonal autoshift on an AWS load balancer?

Enabling zonal autoshift is a two-step flow: first create a practice-run configuration with arc-zonal-shift create-practice-run-configuration including outcome alarms and blocked windows, then run update-zonal-autoshift-configuration with status ENABLED. Verify the application can handle losing one AZ of capacity first.

Does this skill set up ARC readiness checks or recovery groups?

No. Readiness checks, recovery groups, cells, and resource sets are explicitly out of scope. The skill only covers routing controls with safety rules and zonal shift or zonal autoshift, and redirects readiness questions to ARC Region switch.

Why is my routing control state change blocked by a safety rule?

A safety rule prevents turning off the last active routing control. Turn on another routing control first, then turn off the one you want. List existing rules with route53-recovery-control-config list-safety-rules to see which rule is blocking the update.

Why does my routing control state change not affect traffic?

Routing controls only affect traffic when wired to Route53 health checks and failover DNS records. Verify each routing control has an associated health check and that the hosted zone has failover records pointing to those health checks.

Can I use the AWS CLI instead of the AWS MCP server for ARC setup?

Yes. All operations work with the AWS CLI directly; the AWS MCP server's call_aws tool is recommended but optional. Short-lived IAM role credentials such as an instance profile or assumed role are recommended over long-lived access keys.