1# Azure Cache for Redis → Azure Managed Redis (AMR) Migration
2 
3> **Target for both paths**: Azure Managed Redis (AMR) — M, B, X (Flash), A series
4> **Source determines which dedicated skill to install** — see decision table below.
5 
6There are **two distinct migration paths** to AMR, depending on the source SKU. Each path is owned by a dedicated, versioned skill maintained by the Azure Managed Redis team. The `azure-upgrade` skill does **not** ship the SKU specs, pricing scripts, ARM automation, or template-transformation logic needed for either migration — it routes the user to the correct dedicated skill.
7 
8## Decision Table — Which Skill?
9 
10| Source SKU | ARM Resource Type | CLI / PowerShell | Dedicated Skill | Repo |
11|---|---|---|---|---|
12| **ACR / OSS Redis** — Basic, Standard, Premium (C0–C6, P1–P5) | `Microsoft.Cache/redis` | `az redis`, `*-AzRedisCache` | `amr-migration-skill` | https://github.com/AzureManagedRedis/amr-migration-skill |
13| **ACRE** — Enterprise (`Enterprise_E*`), Enterprise Flash (`EnterpriseFlash_F*`) | `Microsoft.Cache/redisEnterprise` | `az redisenterprise`, `*-AzRedisEnterprise*` | `acre-to-amr-migration-skill` | https://github.com/AzureManagedRedis/acre-to-amr-migration-skill |
14 
15> ACR and ACRE are **fundamentally different products** with different ARM resource types, different APIs, and different migration mechanics. Picking the wrong skill will give the user wrong guidance. Always disambiguate before pointing.
16 
17## Disambiguation — How to Tell ACR from ACRE
18 
19Ask the user, or inspect the resource. Any **one** of these signals identifies the source:
20 
21**ACR (OSS) indicators** → use `amr-migration-skill`:
22- Resource type `Microsoft.Cache/redis` (no "Enterprise" suffix)
23- SKU names `Basic`, `Standard`, `Premium`, or sizes `C0`–`C6`, `P1`–`P5`
24- CLI: `az redis ...` commands
25- PowerShell: `New-AzRedisCache`, `Get-AzRedisCache`, etc.
26- DNS suffix `.redis.cache.windows.net`
27- Default TLS port `6380`
28 
29**ACRE indicators** → use `acre-to-amr-migration-skill`:
30- Resource type `Microsoft.Cache/redisEnterprise`
31- SKU names starting with `Enterprise_` (e.g. `Enterprise_E10`, `Enterprise_E20`) or `EnterpriseFlash_` (e.g. `EnterpriseFlash_F300`)
32- CLI: `az redisenterprise ...` commands
33- PowerShell: `New-AzRedisEnterpriseCache`, `Get-AzRedisEnterpriseCache`, etc.
34- Default TLS port `10000`
35- May reference geo-replication groups (`databases create-replica-link`), Private Endpoints, or Private Link DNS zones
36 
37If the user has a **mix of ACR and ACRE** resources, both skills should be installed and run separately on the relevant resources. Most users (~97% of the Azure Cache for Redis fleet) are on ACR; ACRE is the smaller (~3%) but functionally distinct case.
38 
39## What Each Skill Provides
40 
41### `amr-migration-skill` (ACR/OSS → AMR)
42 
43- SKU mapping ACR Basic/Standard/Premium → AMR M/B/X/A with validated SKU specs
44- Real-time pricing scripts (PowerShell + bash) with HA, clustering, and MRPP logic
45- Cache metrics assessment (default 7-day window) for sizing
46- Automated migration via ARM REST APIs with **DNS switching** (old hostname keeps working; port still changes)
47- Validate-before-migrate workflow with explicit confirmation on destructive actions
48- IaC template migration for ARM, Bicep, and Terraform with worked before/after examples
49- Feature comparison and retirement FAQ
50- **Retirement deadlines this skill addresses**: ACR Basic/Standard/Premium tiers are being retired — for the current retirement and creation-block dates, see the [official ACR retirement announcement](https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-retired-tiers).
51 
52### `acre-to-amr-migration-skill` (ACRE → AMR)
53 
54- Three modes: automation-script update (ARM/Bicep/CLI/PowerShell/Terraform checklist), interactive cache migration with confirmation gates, generic step-by-step guide
55- ACRE → AMR SKU resolution via `listSkusForScaling` with fallback mapping table
56- In-place migration for standalone caches; create-new-and-swap for geo-replicated caches
57- Geo-replication database config parity (eviction policy, modules, etc.)
58- Private Endpoint / Private Link migration and DNS zone updates
59- Breaking-changes reference (property changes, DNS, API versions)
60- Reusable polling scripts (`Poll-MigrationStatus.ps1`, `poll-migration-status.sh`)
61- Post-migration ACRE resource cleanup
62- **Retirement deadline this skill addresses**: ACRE / Enterprise Flash are being retired — for the current retirement date, see the [official ACR retirement announcement](https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-retired-tiers).
63 
64## Agent Behavior
65 
66When a user asks about migrating any flavor of Azure Cache for Redis to Azure Managed Redis:
67 
681. **Do not attempt the migration from this skill.** Neither SKU specs nor migration automation are inlined here.
692. **Determine the source** using the disambiguation signals above. If unclear, ask the user (or inspect the script/resource).
703. **Point the user to the correct dedicated skill** with its repo URL. The repo READMEs include install instructions for GitHub Copilot, Claude Code, and other compatible hosts.
714. After installation, the user's agent will match the dedicated skill on its trigger phrases (e.g. *"migrate my P2 cache to AMR"*, *"convert my Bicep Redis template"*, *"migrate my Enterprise_E10 cache"*, *"update my ACRE ARM template for AMR"*).
725. If the user has **both** ACR and ACRE resources, recommend installing **both** skills and running them on the relevant resources separately.
73 
74## Key Migration Facts (so the agent can set expectations)
75 
76These are summarized for awareness. For anything operational, defer to the dedicated skills.
77 
78### ACR → AMR
79- **Port**: 6380 → **10000**. Non-TLS 6379 not supported on AMR.
80- **DNS suffix**: `.redis.cache.windows.net` → `<region>.redis.azure.net`
81- **Redis version**: 6 → **7.4**
82- **No "shards"** in AMR-facing terminology — sharding is internal. Use performance tier (Balanced, Memory Optimized) and size (e.g. B10, M20).
83- **Auth**: Recommend adopting **Microsoft Entra ID** post-migration. Entra config is **not** auto-migrated.
84- **DNS-switch automated migration** keeps old hostname working, but the port change still applies — apps must be updated.
85 
86### ACRE → AMR
87- **ARM resource type is unchanged** between the ACRE source and AMR target — both use `Microsoft.Cache/redisEnterprise`. Property values do change (API version, SKU naming, etc.); see the breaking-changes reference in the dedicated skill.
88- **Geo-replicated caches** require create-new-and-swap, not in-place migration.
89- **Private Endpoints / Private Link** DNS zones must be updated.
90- **Database config parity** (eviction policy, modules) must match across replicas before migration.
91 
92## Why this is not implemented inline
93 
94Both migrations require maintained SKU tables, live pricing or capability lookups, and ARM-level orchestration that is updated independently of the `azure-skills` release cycle. Keeping that logic in two places would drift. The dedicated skill repos are the single source of truth and are versioned independently.
95 
96## References
97 
98- AMR Migration Skill (ACR → AMR): https://github.com/AzureManagedRedis/amr-migration-skill
99- ACRE → AMR Migration Skill: https://github.com/AzureManagedRedis/acre-to-amr-migration-skill
100- Azure Managed Redis docs: https://learn.microsoft.com/en-us/azure/redis/managed-redis/
101- ACR retirement announcement: https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-retired-tiers
102- Entra ID auth for AMR: https://learn.microsoft.com/en-us/azure/redis/managed-redis/managed-redis-entra-for-access-control-configuration
103