mcpField
A
azure-cyclecloud

azure-cyclecloud

github.com/microsoftdocsCloud & DevOps796170 installsUpdated 3d ago
Repository

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

  1. 01Cluster sizing and architecture guidance
  2. 02Troubleshooting and diagnostics
  3. 03Security and identity configuration
  4. 04Cluster, scheduler, and storage setup
  5. 05CLI, API, and Python SDK automation
  6. 06Deployment, migration, and upgrades

Use cases

  1. 01Planning a multi-region HPC cluster
  2. 02Diagnosing cluster and node startup issues
  3. 03Securing CycleCloud access and networking
  4. 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-cyclecloud

After installing, type/azure-cyclecloudin Claude Code to confirm it loaded.

Details

From the project README

Azure 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), 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

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

CategoryLinesDescription
TroubleshootingL36-L45Diagnosing and fixing CycleCloud setup, cluster/node startup, VM health, Slurm 4 issues, and locating/logging detailed diagnostics for common errors.
Best PracticesL46-L51Security hardening guidance for CycleCloud (identity, networking, data) and performance tuning of HB/HC-series HPC clusters (sizing, configs, optimization).
Decision MakingL52-L62Guidance on planning/sizing CycleCloud HPC clusters, Slurm workspace and migration, Spot VM usage, licensing terms, and servicing/support policies.
Architecture & Design PatternsL63-L69Designing secure, enterprise-grade Azure CycleCloud architectures: multi-region HPC clusters, VM placement strategies, and hub-spoke network/security patterns.
SecurityL70-L85Securing CycleCloud: auth (Entra, service principals, managed identities), SSL, SSH/Bastion access, network lockdown/SELinux, and telemetry/data usage policies.
ConfigurationL86-L134Designing and configuring CycleCloud clusters: templates, nodearrays, networking, storage, autoscaling, Slurm/Open OnDemand, deployment, CLI, proxies, monitoring, and customization.
Integrations & Coding PatternsL135-L155APIs, CLI, and Python SDK for automating CycleCloud, plus patterns to integrate schedulers, monitoring, storage, events, and remote desktop tools with CycleCloud clusters.
DeploymentL156-L165Deploying and operating CycleCloud: installing via ARM/CLI/ACI, planning production setups, importing templates, moving cluster resources, and safely upgrading or migrating installations.
Troubleshooting
TopicURL
Resolve common Azure CycleCloud error messageshttps://learn.microsoft.com/en-us/azure/cyclecloud/error-messages?view=cyclecloud-8
Use CycleCloud HealthCheck services to manage unhealthy VMshttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/healthcheck?view=cyclecloud-8
Diagnose and report Azure CycleCloud cluster and node startup issueshttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/report-issues?view=cyclecloud-8
Troubleshoot first-time Azure CycleCloud setup issueshttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/troubleshoot-first-time-setup?view=cyclecloud-8
Locate Azure CycleCloud diagnostic log fileshttps://learn.microsoft.com/en-us/azure/cyclecloud/log-locations?view=cyclecloud-8
Operate and troubleshoot Azure CycleCloud Slurm 4 clustershttps://learn.microsoft.com/en-us/azure/cyclecloud/slurm-4-operations?view=cyclecloud-8
Best Practices
TopicURL
Apply security best practices for Azure CycleCloudhttps://learn.microsoft.com/en-us/azure/cyclecloud/concepts/security-best-practices?view=cyclecloud-8
Optimize CycleCloud clusters on HB/HC series VMshttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/hb-hc-best-practices?view=cyclecloud-8
Decision Making
TopicURL
Plan and size Azure CycleCloud HPC clustershttps://learn.microsoft.com/en-us/azure/cyclecloud/concepts/plan-and-size-hpc-clusters?view=cyclecloud-8
Plan CycleCloud Workspace for Slurm deploymenthttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/ccws/plan-your-deployment?view=cyclecloud-8
Plan migration for Azure CycleCloud 7 retirementhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/cyclecloud7-retirement-guide?view=cyclecloud-8
Migrate Azure CycleCloud Slurm clusters to new templateshttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/migrate-slurm-cluster?view=cyclecloud-8
Decide when and how to use Spot VMs in Azure CycleCloudhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/use-spot-instances?view=cyclecloud-8
Apply Azure CycleCloud licensing and usage termshttps://learn.microsoft.com/en-us/azure/cyclecloud/licensing?view=cyclecloud-8
Understand Azure CycleCloud servicing and support policyhttps://learn.microsoft.com/en-us/azure/cyclecloud/service-policy?view=cyclecloud-8
Architecture & Design Patterns
TopicURL
Design and operate multi‑region Azure CycleCloud HPC clustershttps://learn.microsoft.com/en-us/azure/cyclecloud/concepts/multi-region-cluster-deployment?view=cyclecloud-8
Choose VM placement models for CycleCloud clustershttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/availability-sets?view=cyclecloud-8
Plan enterprise-secured Azure CycleCloud hub-spoke architecturehttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/plan-enterprise-secured-deployment?view=cyclecloud-8
Security
TopicURL
Review CycleCloud telemetry and data usage policyhttps://learn.microsoft.com/en-us/azure/cyclecloud/data-policy?view=cyclecloud-8
Securely SSH to CycleCloud login nodes via Bastionhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/ccws/connect-to-login-node-with-bastion?view=cyclecloud-8
Secure CycleCloud portal access through Azure Bastionhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/ccws/connect-to-portal-with-bastion?view=cyclecloud-8
Create Entra app registration for Azure CycleCloudhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/create-app-registration?view=cyclecloud-8
Use managed identities to secure Azure CycleCloud clustershttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/managed-identities?view=cyclecloud-8
Configure network security options for Azure CycleCloud nodeshttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/network-security?view=cyclecloud-8
Run Azure CycleCloud in locked-down networkshttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/running-in-locked-down-network?view=cyclecloud-8
Run Azure CycleCloud nodes with SELinux enforcinghttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/selinux?view=cyclecloud-8
Configure Azure CycleCloud with Microsoft Entra service principalshttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/service-principals?view=cyclecloud-8
Configure SSL certificates for secure Azure CycleCloud accesshttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/ssl-configuration?view=cyclecloud-8
Configure user authentication for Azure CycleCloud clustershttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/user-access?view=cyclecloud-8
Configure user authentication methods for Azure CycleCloudhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/user-authentication?view=cyclecloud-8
Configuration
TopicURL
Configure cluster-init specs and project sources in Azure CycleCloudhttps://learn.microsoft.com/en-us/azure/cyclecloud/cluster-references/cluster-init-reference?view=cyclecloud-8
Configure the cluster section in Azure CycleCloud templateshttps://learn.microsoft.com/en-us/azure/cyclecloud/cluster-references/cluster-reference?view=cyclecloud-8
Understand Azure CycleCloud cluster template structure and hierarchyhttps://learn.microsoft.com/en-us/azure/cyclecloud/cluster-references/cluster-template-reference?view=cyclecloud-8
Configure Azure CycleCloud cluster configuration objectshttps://learn.microsoft.com/en-us/azure/cyclecloud/cluster-references/configuration-reference?view=cyclecloud-8
Define environment objects in CycleCloud cluster templateshttps://learn.microsoft.com/en-us/azure/cyclecloud/cluster-references/environment-reference?view=cyclecloud-8
Configure input endpoints and ports in Azure CycleCloud templateshttps://learn.microsoft.com/en-us/azure/cyclecloud/cluster-references/input-endpoint-reference?view=cyclecloud-8
Configure network-interface objects in Azure CycleCloud templateshttps://learn.microsoft.com/en-us/azure/cyclecloud/cluster-references/network-interface-reference?view=cyclecloud-8
Configure nodes and nodearrays in Azure CycleCloud templateshttps://learn.microsoft.com/en-us/azure/cyclecloud/cluster-references/node-nodearray-reference?view=cyclecloud-8
Use NodeRef objects in CycleCloud cluster templateshttps://learn.microsoft.com/en-us/azure/cyclecloud/cluster-references/noderef-reference?view=cyclecloud-8
Configure parameters in Azure CycleCloud cluster templateshttps://learn.microsoft.com/en-us/azure/cyclecloud/cluster-references/parameter-reference?view=cyclecloud-8
Apply special parameter parsing in Azure CycleCloudhttps://learn.microsoft.com/en-us/azure/cyclecloud/cluster-references/special-parsing?view=cyclecloud-8
Define and configure volume objects in Azure CycleCloud templateshttps://learn.microsoft.com/en-us/azure/cyclecloud/cluster-references/volume-reference?view=cyclecloud-8
Configure Azure CycleCloud service monitoring integrationshttps://learn.microsoft.com/en-us/azure/cyclecloud/concepts/monitoring?view=cyclecloud-8
Configure CycleServer via cycle_server.propertieshttps://learn.microsoft.com/en-us/azure/cyclecloud/cycleserver-configuration-reference?view=cyclecloud-8
Configure CycleCloud node events and Event Gridhttps://learn.microsoft.com/en-us/azure/cyclecloud/events?view=cyclecloud-8
Configure Azure managed disks in CycleCloud nodeshttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/add-disk?view=cyclecloud-8
Configure node arrays for Azure CycleCloud clustershttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/add-node-array?view=cyclecloud-8
Configure backup and restore for Azure CycleCloudhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/backup-and-restore?view=cyclecloud-8
Configure Slurm cloud bursting with Azure CycleCloudhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/bursting/slurm-cloud-bursting-setup?view=cyclecloud-8
Configure Open OnDemand for Azure CycleCloud Slurmhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/ccws/configure-open-ondemand?view=cyclecloud-8
Use cloud-init to customize CycleCloud VMs on boothttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/cloud-init?view=cyclecloud-8
Define and customize Azure CycleCloud cluster templateshttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/cluster-templates?view=cyclecloud-8
Configure Azure resources for CycleCloud deploymenthttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/configuration?view=cyclecloud-8
Configure autoscaling for Azure CycleCloud clustershttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/configure-autoscaling?view=cyclecloud-8
Use custom and marketplace images in CycleCloud clustershttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/create-custom-image?view=cyclecloud-8
Create and export NFS file shares in CycleCloudhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/create-fileserver?view=cyclecloud-8
Configure Azure CycleCloud environment resources via ARMhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/environments?view=cyclecloud-8
Configure Flex VM scale sets in Azure CycleCloudhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/flex-scalesets?view=cyclecloud-8
Install and configure the Azure CycleCloud CLIhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/install-cyclecloud-cli?view=cyclecloud-8
Manually install Jetpack on CycleCloud-managed VMshttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/install-jetpack?view=cyclecloud-8
Manually install and configure Azure CycleCloudhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/install-manual?view=cyclecloud-8
Configure keep-alive settings for Azure CycleCloud nodeshttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/keep-alive?view=cyclecloud-8
Configure alerts and logging for Azure CycleCloud clustershttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/monitor-clusters?view=cyclecloud-8
Configure volume mountpoints in Azure CycleCloud templateshttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/mount-disk?view=cyclecloud-8
Configure NFS mounts and shares in Azure CycleCloudhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/mount-fileserver?view=cyclecloud-8
Configure multiple Azure CycleCloud instances on one hosthttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/multiple-installs?view=cyclecloud-8
Define and use projects and specs in Azure CycleCloudhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/projects?view=cyclecloud-8
Configure Azure CycleCloud return proxy via SSH tunnelhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/return-proxy?view=cyclecloud-8
Configure web proxy settings for Azure CycleCloud traffichttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/running-behind-proxy?view=cyclecloud-8
Configure Azure Scheduled Events handling in CycleCloud nodeshttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/scheduled-events?view=cyclecloud-8
Configure project and user blob storage in Azure CycleCloudhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/storage-blobs?view=cyclecloud-8
Use and understand Azure CycleCloud node tagginghttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/tag-nodes?view=cyclecloud-8
Customize Azure CycleCloud UI theming with CSShttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/theming?view=cyclecloud-8
Configure CycleCloud nodes with Jetpackhttps://learn.microsoft.com/en-us/azure/cyclecloud/jetpack?view=cyclecloud-8
Configure and manage Azure CycleCloud Slurm 4 clustershttps://learn.microsoft.com/en-us/azure/cyclecloud/slurm-4?view=cyclecloud-8
Integrations & Coding Patterns
TopicURL
Use Azure CycleCloud REST API endpointshttps://learn.microsoft.com/en-us/azure/cyclecloud/api?view=cyclecloud-8
Manage Azure CycleCloud with CLI commandshttps://learn.microsoft.com/en-us/azure/cyclecloud/cli?view=cyclecloud-8
Author Chef cookbooks for CycleCloud clustershttps://learn.microsoft.com/en-us/azure/cyclecloud/cookbook-reference?view=cyclecloud-8
Configure Grid Engine clusters in CycleCloudhttps://learn.microsoft.com/en-us/azure/cyclecloud/gridengine?view=cyclecloud-8
Integrate ThinLinc with Open OnDemand in CycleCloud Workspacehttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/ccws/configure-thinlinc?view=cyclecloud-8
Submit and manage Slurm jobs on Azure CycleCloudhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/ccws/submit-job-with-slurm?view=cyclecloud-8
Integrate Azure CycleCloud events with Event Gridhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/event-grid?view=cyclecloud-8
Integrate Prometheus and Azure Managed Grafana with CycleCloud clustershttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/monitor-cyclecloud-cluster-using-prometheus-grafana?view=cyclecloud-8
Mount Azure Blob Storage on CycleCloud nodes with BlobFuse2https://learn.microsoft.com/en-us/azure/cyclecloud/how-to/mount-blob-storage?view=cyclecloud-8
Use the Azure CycleCloud REST API for automated cluster managementhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/use-rest-api?view=cyclecloud-8
Configure Microsoft HPC Pack with CycleCloudhttps://learn.microsoft.com/en-us/azure/cyclecloud/hpcpack?view=cyclecloud-8
Integrate HTCondor scheduler with CycleCloudhttps://learn.microsoft.com/en-us/azure/cyclecloud/htcondor?view=cyclecloud-8
Connect IBM Spectrum LSF to CycleCloudhttps://learn.microsoft.com/en-us/azure/cyclecloud/lsf?view=cyclecloud-8
Integrate OpenPBS scheduler with CycleCloudhttps://learn.microsoft.com/en-us/azure/cyclecloud/openpbs?view=cyclecloud-8
Install and use CycleCloud Python APIhttps://learn.microsoft.com/en-us/azure/cyclecloud/python-api?view=cyclecloud-8
Configure CycleCloud Slurm integration v3.0+https://learn.microsoft.com/en-us/azure/cyclecloud/slurm-3?view=cyclecloud-8
Enable Slurm scheduler on CycleCloud clustershttps://learn.microsoft.com/en-us/azure/cyclecloud/slurm?view=cyclecloud-8
Deployment
TopicURL
Download and import CycleCloud cluster templateshttps://learn.microsoft.com/en-us/azure/cyclecloud/download-cluster-templates?view=cyclecloud-8
Deploy CycleCloud Workspace for Slurm using CLIhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/ccws/deploy-with-cli?view=cyclecloud-8
Deploy Azure CycleCloud using ARM templateshttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/install-arm?view=cyclecloud-8
Move Azure CycleCloud cluster resources between resource groupshttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/move-resource-group?view=cyclecloud-8
Plan a production-grade Azure CycleCloud deploymenthttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/plan-prod-deployment?view=cyclecloud-8
Run Azure CycleCloud in Azure Container Instanceshttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/run-in-container?view=cyclecloud-8
Upgrade or migrate Azure CycleCloud installations safelyhttps://learn.microsoft.com/en-us/azure/cyclecloud/how-to/upgrade-and-migrate?view=cyclecloud-8

Comments

Markdown supported