About azure-cyclecloud
azure-cyclecloud is a guidance skill for planning, deploying, and operating Azure CycleCloud HPC clusters. It serves agents and practitioners with references spanning troubleshooting, security, architecture, configuration, integrations, and lifecycle operations.
Key features
- 01Cluster sizing and architecture guidance
- 02Troubleshooting and diagnostics
- 03Security and identity configuration
- 04Cluster, scheduler, and storage setup
- 05CLI, API, and Python SDK automation
- 06Deployment, migration, and upgrades
Use cases
- 01Planning a multi-region HPC cluster
- 02Diagnosing cluster and node startup issues
- 03Securing CycleCloud access and networking
- 04Automating cluster setup and operations
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-cyclecloudAfter installing, type/azure-cyclecloudin Claude Code to confirm it loaded.
Details
From the project READMEAzure CycleCloud Skill
This skill provides expert guidance for Azure CycleCloud. Covers troubleshooting, best practices, decision making, architecture & design patterns, 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), 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 | L36-L45 | Diagnosing and fixing CycleCloud setup, cluster/node startup, VM health, Slurm 4 issues, and locating/logging detailed diagnostics for common errors. |
| Best Practices | L46-L51 | Security hardening guidance for CycleCloud (identity, networking, data) and performance tuning of HB/HC-series HPC clusters (sizing, configs, optimization). |
| Decision Making | L52-L62 | Guidance on planning/sizing CycleCloud HPC clusters, Slurm workspace and migration, Spot VM usage, licensing terms, and servicing/support policies. |
| Architecture & Design Patterns | L63-L69 | Designing secure, enterprise-grade Azure CycleCloud architectures: multi-region HPC clusters, VM placement strategies, and hub-spoke network/security patterns. |
| Security | L70-L85 | Securing CycleCloud: auth (Entra, service principals, managed identities), SSL, SSH/Bastion access, network lockdown/SELinux, and telemetry/data usage policies. |
| Configuration | L86-L134 | Designing and configuring CycleCloud clusters: templates, nodearrays, networking, storage, autoscaling, Slurm/Open OnDemand, deployment, CLI, proxies, monitoring, and customization. |
| Integrations & Coding Patterns | L135-L155 | APIs, CLI, and Python SDK for automating CycleCloud, plus patterns to integrate schedulers, monitoring, storage, events, and remote desktop tools with CycleCloud clusters. |
| Deployment | L156-L165 | Deploying and operating CycleCloud: installing via ARM/CLI/ACI, planning production setups, importing templates, moving cluster resources, and safely upgrading or migrating installations. |
Troubleshooting
| Topic | URL |
|---|---|
| Resolve common Azure CycleCloud error messages | https://learn.microsoft.com/en-us/azure/cyclecloud/error-messages?view=cyclecloud-8 |
| Use CycleCloud HealthCheck services to manage unhealthy VMs | https://learn.microsoft.com/en-us/azure/cyclecloud/how-to/healthcheck?view=cyclecloud-8 |
| Diagnose and report Azure CycleCloud cluster and node startup issues | https://learn.microsoft.com/en-us/azure/cyclecloud/how-to/report-issues?view=cyclecloud-8 |
| Troubleshoot first-time Azure CycleCloud setup issues | https://learn.microsoft.com/en-us/azure/cyclecloud/how-to/troubleshoot-first-time-setup?view=cyclecloud-8 |
| Locate Azure CycleCloud diagnostic log files | https://learn.microsoft.com/en-us/azure/cyclecloud/log-locations?view=cyclecloud-8 |
| Operate and troubleshoot Azure CycleCloud Slurm 4 clusters | https://learn.microsoft.com/en-us/azure/cyclecloud/slurm-4-operations?view=cyclecloud-8 |
Best Practices
| Topic | URL |
|---|---|
| Apply security best practices for Azure CycleCloud | https://learn.microsoft.com/en-us/azure/cyclecloud/concepts/security-best-practices?view=cyclecloud-8 |
| Optimize CycleCloud clusters on HB/HC series VMs | https://learn.microsoft.com/en-us/azure/cyclecloud/how-to/hb-hc-best-practices?view=cyclecloud-8 |
Decision Making
Architecture & Design Patterns
| Topic | URL |
|---|---|
| Design and operate multi‑region Azure CycleCloud HPC clusters | https://learn.microsoft.com/en-us/azure/cyclecloud/concepts/multi-region-cluster-deployment?view=cyclecloud-8 |
| Choose VM placement models for CycleCloud clusters | https://learn.microsoft.com/en-us/azure/cyclecloud/how-to/availability-sets?view=cyclecloud-8 |
| Plan enterprise-secured Azure CycleCloud hub-spoke architecture | https://learn.microsoft.com/en-us/azure/cyclecloud/how-to/plan-enterprise-secured-deployment?view=cyclecloud-8 |