About azure-cache-redis
A guidance skill for developers and agents managing Azure Cache for Redis. It pairs local references with remote documentation on troubleshooting, reliability, security, configuration, and deployment.
Key features
- 01Troubleshooting Redis issues
- 02Client reliability and performance practices
- 03Tier, capacity, and cost planning
- 04Security and network configuration
- 05Cache deployment and migration
Use cases
- 01Diagnosing connectivity or latency problems
- 02Planning cache tiers and capacity
- 03Configuring authentication and private networking
- 04Scaling or migrating Redis caches
MCP support
The skill can fetch documentation through the mcp_microsoftdocs microsoft_docs_fetch tool, with webpage fetching as a fallback.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-cache-redisAfter installing, type/azure-cache-redisin Claude Code to confirm it loaded.
Details
From the project READMEAzure Cache for Redis Skill
This skill provides expert guidance for Azure Cache for Redis. Covers troubleshooting, best practices, decision making, architecture & design patterns, security, configuration, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.
How to Use This Skill
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,
L35-L120), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools are not available, suggest the user install it: Installation Guide
This skill requires network access to fetch documentation content:
- Preferred: Use
mcp_microsoftdocs:microsoft_docs_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L35-L43 | Diagnosing and fixing Azure Cache for Redis issues: client/server errors, connectivity, data loss, latency, and timeouts, plus targeted troubleshooting steps. |
| Best Practices | L44-L58 | Best practices for client usage, reliability, scaling, memory, performance testing, monitoring, failover behavior, and Kubernetes/Enterprise tier usage in Azure Cache for Redis |
| Decision Making | L59-L68 | Guidance on sizing and tier selection, cost reservations, network isolation options, and planning/migrating Redis caches, including retirement and Private Link migrations. |
| Architecture & Design Patterns | L69-L73 | Strategies for architecting highly available Redis caches on Azure, including redundancy, failover, disaster recovery, and SLA-focused design patterns. |
| Security | L74-L86 | Securing Azure Cache for Redis: Entra auth/RBAC, TLS config, disk encryption, private endpoints/VNet, managed identities, and Azure Policy compliance settings. |
| Configuration | L87-L106 | Configuring and operating Azure Cache for Redis: server settings, geo-replication, persistence, zone redundancy, monitoring/logging, CLI/PowerShell management, and data import/export. |
| Deployment | L107-L114 | Scaling, upgrading, and region-moving Redis caches, plus deploying them via ARM/Bicep templates and managing tier/version/region changes. |
Troubleshooting
| Topic | URL |
|---|---|
| Access client-specific troubleshooting for Azure Cache | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-troubleshoot-client |
| Troubleshoot connectivity issues with Azure Cache for Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-troubleshoot-connectivity |
| Diagnose and fix data loss in Azure Cache for Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-troubleshoot-data-loss |
| Access server-side troubleshooting for Azure Cache | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-troubleshoot-server |
| Resolve latency and timeout problems in Azure Cache | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-troubleshoot-timeouts |
Best Practices
Decision Making
| Topic | URL |
|---|---|
| Plan and execute migrations to Azure Cache for Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-migration-guide |
| Choose Azure Redis network isolation options | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-network-isolation |
| Plan Azure Cache for Redis capacity and tiers | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-planning-faq |
| Choose and manage Azure Redis reservations for cost | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-reserved-pricing |
| Migrate Azure Redis VNet caches to Private Link | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-vnet-migration |
| Plan migration for Azure Cache for Redis retirement | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/retirement-faq |
Architecture & Design Patterns
| Topic | URL |
|---|---|
| Design high availability strategies for Azure Cache for Redis | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-high-availability |
Security
Configuration
Deployment
| Topic | URL |
|---|---|
| Scale Azure Cache for Redis instances across tiers | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-how-to-scale |
| Upgrade Azure Cache for Redis server versions | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-how-to-upgrade |
| Move Azure Cache for Redis across Azure regions | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/cache-moving-resources |
| Deploy Azure Cache for Redis with ARM templates | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/redis-cache-arm-provision |
| Deploy Azure Cache for Redis using Bicep templates | https://learn.microsoft.com/en-us/azure/azure-cache-for-redis/redis-cache-bicep-provision |