azure-redhat-openshift — skill for Claude Code: setup, security
A skill for Claude Code, Codex, Cursor and other IDEs providing expert guidance on Azure Red Hat OpenShift. Covers cluster sizing, network topology, identity configuration, and integration with Azure services.
CC-BY-4.0 169 installs ★ 818 updated 2026-11-09
npx skills add MicrosoftDocs/Agent-Skills --skill azure-redhat-openshift -a claude-codeWhat azure-redhat-openshift does
The skill answers questions about cluster sizing, VNet configuration, Entra and OIDC setup, ACR and Key Vault access, SDN migration, and node upgrades.
It includes quick reference on troubleshooting, best practices, architecture decisions, limits and quotas, security, configuration, Azure integrations, and app deployment. It does not cover Azure Kubernetes Service (AKS), Azure Container Apps, or Azure Container Instances — separate skills exist for those.
Requires network access to fetch documentation via mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage. If the MCP tool is unavailable, you'll need to install it separately.
What it helps with
- deploy and scale an Azure Red Hat OpenShift cluster
- configure identity using Microsoft Entra and OIDC
- plan virtual network topology and subnets
- connect applications to Azure Container Registry and Key Vault
- migrate network drivers and upgrade cluster nodes
Example prompts for the agent
- Help me understand ARO cluster size limits and calculate the number of nodes I need
- How do I configure managed identities and roles for ARO HCP?
- What should I consider when planning network topology for a private cluster?
How to install azure-redhat-openshift
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-redhat-openshift -a claude-code2Manually: put the files in place
~/.claude/skills/azure-redhat-openshift/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/azure-redhat-openshift/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-redhat-openshift -a codex2Manually: put the files in place
.agents/skills/azure-redhat-openshift/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-redhat-openshift -a cursor2Manually: put the files in place
.cursor/skills/azure-redhat-openshift/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install MicrosoftDocs/Agent-Skills skills/azure-redhat-openshift2Manually: put the files in place
.github/skills/azure-redhat-openshift/SKILL.md1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-redhat-openshift -a gemini-cli2Platform CLI
gemini skills install https://github.com/MicrosoftDocs/Agent-Skills --path skills/azure-redhat-openshiftManually: put the files in place
.devin/skills/azure-redhat-openshift/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-redhat-openshift -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about azure-redhat-openshift
How do I install azure-redhat-openshift in Claude Code?
Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-redhat-openshift -a claude-code. The skill will be installed to ~/.claude/skills/azure-redhat-openshift/SKILL.md.
What does the azure-redhat-openshift skill do?
It provides expert knowledge for Azure Red Hat OpenShift development, covering cluster deployment and management, troubleshooting, best practices, architecture, security, configuration, and integration with Azure services.
Which platforms support this skill?
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. Each platform has its own installation command.
Source text
SKILL.md · CC-BY-4.0
--- name: azure-redhat-openshift description: Expert knowledge for Azure Red Hat OpenShift development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when sizing ARO clusters, configuring HCP/VNet topology, Entra/OIDC identity, ACR/Key Vault access, or SDN‑OVN/HCP upgrades, and other Azure Red Hat OpenShift related development tasks. Not for Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure Container Apps (use azure-container-apps), Azure Container Instances (use azure-container-instances), Azure Stack Edge (use azure-stack-edge). compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation. metadata: generated_at: "2026-11-08" generator: "docs2skills/1.0.0" --- # Azure Red Hat OpenShift Skill This skill provides expert guidance for Azure Red Hat OpenShift. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, 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`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference file > **IMPORTANT for Agent**: If `metadata.generated_at` is more than 3 months old, suggest the user pull the latest version from the repository. If `mcp_microsoftdocs` tools are not available, suggest the user install it: [Installation Guide](https://github.com/MicrosoftDocs/mcp/blob/main/README.md) This skill requires **network access** to fetch documentation content: - **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown. - **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown. ## Category Index | Category | Lines | Description | |----------|-------|-------------| | Troubleshooting | L37-L43 | Fixing common ARO cluster issues, restoring cluster access, and manually updating or troubleshooting cluster certificates and connectivity via CLI | | Best Practices | L44-L51 | Best practices for sizing and deploying ARO clusters and infra nodes, optimizing OpenShift Virtualization VMs, and staying within supported configurations and policies. | | Decision Making | L52-L58 | Guidance on selecting ARO architectures, choosing immutable HCP cluster settings, and understanding shared responsibilities between Microsoft and customers for ARO operations. | | Architecture & Design Patterns | L59-L63 | Planning network topology for ARO HCP clusters, including VNet design, subnets, private endpoints, connectivity options, and required ports and dependencies. | | Limits & Quotas | L64-L69 | Scaling ARO clusters with multiple load balancer IPs and understanding built‑in service limits, quotas, and standard service definitions for Azure Red Hat OpenShift. | | Security | L70-L89 | Identity, auth, and encryption for ARO: Entra/OIDC setup, managed identities, workload identity, NSGs/egress, KMS key rotation, FIPS, Front Door, and support access control. | | Configuration | L90-L117 | Configuring ARO clusters: networking (DNS, proxy, MTU, spot VMs), storage (Azure Files, Prometheus), registries/pull secrets, autoscaling/node pools, identities, logging, tagging, and capacity. | | Integrations & Coding Patterns | L118-L127 | Patterns for connecting ARO apps to Azure services: workload identity, ACR, Key Vault, NetApp Files, GPU workloads, and exporting Prometheus metrics to Azure Monitor. | | Deployment | L128-L139 | Deploying and upgrading ARO clusters and apps: private/standard clusters, ARM/Bicep, WebSphere, S2I and serverless, Velero backup/restore, SDN-to-OVN migration, and HCP control plane/node pool upgrades. | ### Troubleshooting | Topic | URL | |-------|-----| | Regain ARO cluster access using Admin Kubeconfig | https://learn.microsoft.com/en-us/azure/openshift/howto-kubeconfig | | Manually update ARO cluster certificates via CLI | https://learn.microsoft.com/en-us/azure/openshift/howto-update-certificates | | Troubleshoot common Azure Red Hat OpenShift cluster issues | https://learn.microsoft.com/en-us/azure/openshift/troubleshoot | ### Best Practices | Topic | URL | |-------|-----| | Optimize VM deployments on OpenShift Virtualization in ARO | https://learn.microsoft.com/en-us/azure/openshift/best-practices-openshift-virtualization | | Deploy and size infrastructure nodes in ARO | https://learn.microsoft.com/en-us/azure/openshift/howto-infrastructure-nodes | | Deploy and manage large OpenShift clusters on Azure | https://learn.microsoft.com/en-us/azure/openshift/howto-large-clusters | | Follow support policies for standard OpenShift clusters | https://learn.microsoft.com/en-us/azure/openshift/support-policies-v4 | ### Decision Making | Topic | URL | |-------|-----| | Choose between Azure Red Hat OpenShift architectures | https://learn.microsoft.com/en-us/azure/openshift/concepts-classic-hosted-control-planes-comparison | | Choose immutable settings for ARO HCP clusters | https://learn.microsoft.com/en-us/azure/openshift/howto-choose-cluster-configuration | | Understand responsibility matrix for ARO operations | https://learn.microsoft.com/en-us/azure/openshift/responsibility-matrix | ### Architecture & Design Patterns | Topic | URL | |-------|-----| | Plan networking for Azure Red Hat OpenShift HCP clusters | https://learn.microsoft.com/en-us/azure/openshift/howto-plan-cluster-network | ### Limits & Quotas | Topic | URL | |-------|-----| | Configure multiple load balancer IPs to scale ARO clusters | https://learn.microsoft.com/en-us/azure/openshift/howto-multiple-ips | | Understand Azure Red Hat OpenShift standard service definitions | https://learn.microsoft.com/en-us/azure/openshift/openshift-service-definitions | ### Security | Topic | URL | |-------|-----| | Configure managed identities and roles for ARO HCP | https://learn.microsoft.com/en-us/azure/openshift/concepts-managed-identities | | Configure Microsoft Entra auth for ARO via CLI | https://learn.microsoft.com/en-us/azure/openshift/configure-azure-ad-cli | | Configure Microsoft Entra auth for ARO via portal | https://learn.microsoft.com/en-us/azure/openshift/configure-azure-ad-ui | | Use custom Network Security Groups with Azure Red Hat OpenShift | https://learn.microsoft.com/en-us/azure/openshift/howto-bring-nsg | | Encrypt ARO OS disks with customer-managed keys | https://learn.microsoft.com/en-us/azure/openshift/howto-byok | | Configure external OIDC authentication for Azure Red Hat OpenShift | https://learn.microsoft.com/en-us/azure/openshift/howto-configure-external-authentication | | Create service principal for Azure Red Hat OpenShift deployment | https://learn.microsoft.com/en-us/azure/openshift/howto-create-service-principal | | Configure applications with ARO workload identity | https://learn.microsoft.com/en-us/azure/openshift/howto-deploy-configure-application | | Enable FIPS-compliant cryptography on Azure Red Hat OpenShift | https://learn.microsoft.com/en-us/azure/openshift/howto-enable-fips-openshift | | Reconcile federated identity credentials for ARO clusters | https://learn.microsoft.com/en-us/azure/openshift/howto-reconcile-federated-identity-credentials | | Restrict and allow egress traffic for ARO clusters | https://learn.microsoft.com/en-us/azure/openshift/howto-restrict-egress | | Rotate customer-managed etcd KMS keys in ARO HCP | https://learn.microsoft.com/en-us/azure/openshift/howto-rotate-encryption-key | | Secure Azure Red Hat OpenShift apps with Azure Front Door | https://learn.microsoft.com/en-us/azure/openshift/howto-secure-openshift-with-front-door | | Rotate Microsoft Entra service principal credentials for ARO | https://learn.microsoft.com/en-us/azure/openshift/howto-service-principal-credential-rotation | | Configure and use managed identities in Azure Red Hat OpenShift | https://learn.microsoft.com/en-us/azure/openshift/howto-understand-managed-identities | | Control Microsoft support access to ARO with Azure Lockbox | https://learn.microsoft.com/en-us/azure/openshift/howto-use-lockbox | ### Configuration | Topic | URL | |-------|-----| | Configure built-in container registry for Azure Red Hat OpenShift | https://learn.microsoft.com/en-us/azure/openshift/built-in-container-registry | | Configure cluster-wide HTTP/HTTPS proxy in ARO | https://learn.microsoft.com/en-us/azure/openshift/cluster-wide-proxy-configure | | Set up DNS forwarding for Azure Red Hat OpenShift 4 | https://learn.microsoft.com/en-us/azure/openshift/dns-forwarding | | Add pull secrets for private registries on ARO HCP | https://learn.microsoft.com/en-us/azure/openshift/how-to-add-pull-secrets | | Manage Red Hat pull secrets on ARO clusters | https://learn.microsoft.com/en-us/azure/openshift/howto-add-update-pull-secret | | Configure capacity reservations with ARO machine sets | https://learn.microsoft.com/en-us/azure/openshift/howto-capacity-reservations | | Enable jumbo MTU for ARO cluster networks | https://learn.microsoft.com/en-us/azure/openshift/howto-change-maximum-transmission-unit | | Configure cluster autoscaling for ARO HCP | https://learn.microsoft.com/en-us/azure/openshift/howto-cluster-auto-scaling | | Configure Azure File StorageClass on ARO with managed identity | https://learn.microsoft.com/en-us/azure/openshift/howto-configure-azure-file-storageclass | | Configure Azure Files StorageClass on ARO HCP | https://learn.microsoft.com/en-us/azure/openshift/howto-configure-azure-files-hosted-cluster | | Configure image digest mirrors for immutable images on ARO | https://learn.microsoft.com/en-us/azure/openshift/howto-configure-cluster-immutable-images | | Create Azure Files storage class on ARO 4 | https://learn.microsoft.com/en-us/azure/openshift/howto-create-a-storageclass | | Configure custom Azure Red Hat OpenShift HCP clusters | https://learn.microsoft.com/en-us/azure/openshift/howto-create-custom-hosted-cluster | | Configure node pool properties for Azure Red Hat OpenShift hosted control planes | https://learn.microsoft.com/en-us/azure/openshift/howto-create-hosted-node-pool | | Configure managed identities for standard OpenShift clusters | https://learn.microsoft.com/en-us/azure/openshift/howto-create-openshift-cluster | | Configure custom DNS resolvers for ARO clusters | https://learn.microsoft.com/en-us/azure/openshift/howto-custom-dns | | Enable and route ARO HCP control plane logs | https://learn.microsoft.com/en-us/azure/openshift/howto-enable-control-plane-logs | | Scale and configure ARO HCP node pools | https://learn.microsoft.com/en-us/azure/openshift/howto-manage-hosted-node-pools | | Configure Azure Resource Health alerts for Azure Red Hat OpenShift | https://learn.microsoft.com/en-us/azure/openshift/howto-monitor-alerts | | Configure Prometheus persistent storage on ARO clusters | https://learn.microsoft.com/en-us/azure/openshift/howto-prometheus-persistence | | Update workload and cluster identities in Azure Red Hat OpenShift | https://learn.microsoft.com/en-us/azure/openshift/howto-replace-cluster-identity | | Segregate ARO worker nodes into subnet groups | https://learn.microsoft.com/en-us/azure/openshift/howto-segregate-machinesets | | Configure Azure Spot VMs in ARO clusters | https://learn.microsoft.com/en-us/azure/openshift/howto-spot-nodes | | Tag ARO managed resources using Azure Policy | https://learn.microsoft.com/en-us/azure/openshift/howto-tag-resources | ### Integrations & Coding Patterns | Topic | URL | |-------|-----| | Use Azure Workload Identity in ARO HCP applications | https://learn.microsoft.com/en-us/azure/openshift/howto-deploy-configure-application-with-workload-identity | | Run NVIDIA GPU workloads on Azure Red Hat OpenShift | https://learn.microsoft.com/en-us/azure/openshift/howto-gpu-workloads | | Configure Azure NetApp Files storage for ARO | https://learn.microsoft.com/en-us/azure/openshift/howto-netapp-files | | Send ARO Prometheus metrics to Azure Monitor via remote write | https://learn.microsoft.com/en-us/azure/openshift/howto-remotewrite-prometheus | | Integrate Azure Container Registry with Azure Red Hat OpenShift | https://learn.microsoft.com/en-us/azure/openshift/howto-use-acr-with-aro | | Integrate Azure Key Vault secrets with Azure Red Hat OpenShift | https://learn.microsoft.com/en-us/azure/openshift/howto-use-key-vault-secrets | ### Deployment | Topic | URL | |-------|-----| | Back up Azure Red Hat OpenShift apps with Velero | https://learn.microsoft.com/en-us/azure/openshift/howto-create-a-backup | | Restore Azure Red Hat OpenShift apps with Velero | https://learn.microsoft.com/en-us/azure/openshift/howto-create-a-restore | | Deploy private Azure Red Hat OpenShift standard clusters | https://learn.microsoft.com/en-us/azure/openshift/howto-create-private-cluster-4x | | Deploy WebSphere Liberty on Azure Red Hat OpenShift | https://learn.microsoft.com/en-us/azure/openshift/howto-deploy-java-liberty-app | | Deploy applications from source to ARO using S2I | https://learn.microsoft.com/en-us/azure/openshift/howto-deploy-with-s2i | | Deploy serverless applications on Azure Red Hat OpenShift | https://learn.microsoft.com/en-us/azure/openshift/howto-deploy-with-serverless | | Migrate ARO networking from OpenShift SDN to OVN-Kubernetes | https://learn.microsoft.com/en-us/azure/openshift/howto-sdn-to-ovn | | Upgrade control plane and node pools in ARO HCP | https://learn.microsoft.com/en-us/azure/openshift/howto-upgrade-cluster | | Deploy standard OpenShift clusters with ARM or Bicep | https://learn.microsoft.com/en-us/azure/openshift/quickstart-openshift-arm-bicep-template |
© MicrosoftDocs · CC-BY-4.0 · MicrosoftDocs/Agent-Skills