azure-cloud-migrate
OfficialAbout azure-cloud-migrate
Azure Cloud Migrate is a skill for assessing and migrating existing cloud workloads to Azure. It runs phases in sequence and writes all output to a separate directory, leaving the source directory unmodified.
Key features
- 01Analyzes source code and maps services in phases
- 02Generates a migration assessment report
- 03Converts code and configuration for Azure targets
- 04Tracks migration progress in migration-status.md
Use cases
- 01Migrating AWS Lambda functions to Azure Functions
- 02Moving Heroku apps to Azure App Service
- 03Moving Kubernetes workloads to Azure Container Apps
MCP support
The skill directs use of Azure MCP tools such as mcp_azure_mcp_get_azure_bestpractices and mcp_azure_mcp_documentation for best practices and documentation.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ microsoft/ azure-skills --skill azure-cloud-migrateAfter installing, type/azure-cloud-migratein Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/workflow-details.mdreferences/services/app-service/app-engine-to-app-service.mdassessment.mdbeanstalk-to-app-service.mdcode-migration.mdglobal-rules.mdheroku-to-app-service.mdreferences/services/container-apps/assessment-guide.mdcloudrun-assessment-guide.mdcloudrun-deployment-guide.mdcloudrun-to-container-apps.mddeployment-guide.mdfargate-assessment-guide.mdfargate-deployment-guide.mdfargate-to-container-apps.mdk8s-to-container-apps.mdspring-apps-to-aca.mdspring-assessment-guide.mdspring-dependency-patterns.mdspring-deployment-guide.mdreferences/services/functions/assessment.mdcode-migration.mdglobal-rules.mdlambda-to-functions.mdreferences/services/functions/runtimes/csharp.mdjava.mdjavascript.mdpowershell.mdpython.mdtypescript.mdDetails
From the project READMEAzure Cloud Migrate
This skill handles assessment and code migration of existing cloud workloads to Azure.
Rules
- Follow phases sequentially — do not skip
- Generate assessment before any code migration
- Load the scenario reference and follow its rules
- Use
mcp_azure_mcp_get_azure_bestpracticesandmcp_azure_mcp_documentationMCP tools - Use the latest supported runtime for the target service
- Destructive actions require
ask_user— functions global-rules | app-service global-rules - Report progress to user — During long-running operations (deployments, image pushes), provide resource-level status updates so the user is never left waiting without feedback — see workflow-details.md
- Audit service discovery in app code — Kubernetes DNS names (e.g.,
http://order-service:3001) do not resolve in Container Apps. During assessment, scan source code for hardcoded hostnames/ports in HTTP clients and flag them for env-var-driven URL injection
Migration Scenarios
| Source | Target | Reference |
|---|---|---|
| AWS Lambda | Azure Functions | lambda-to-functions.md (assessment, code-migration) |
| AWS Elastic Beanstalk | Azure App Service | beanstalk-to-app-service.md |
| Heroku | Azure App Service | heroku-to-app-service.md |
| Google App Engine | Azure App Service | app-engine-to-app-service.md |
| AWS Fargate (ECS) | Azure Container Apps | fargate-to-container-apps.md (assessment, deployment) |
| Kubernetes (GKE/EKS/Self-hosted) | Azure Container Apps | k8s-to-container-apps.md |
| GCP Cloud Run | Azure Container Apps | cloudrun-to-container-apps.md |
| Spring Boot (Azure Spring Apps/VMs) | Azure Container Apps | spring-apps-to-aca.md |
No matching scenario? Use
mcp_azure_mcp_documentationandmcp_azure_mcp_get_azure_bestpracticestools.
Output Directory
All output goes to <workspace-root-basename>-azure/ at workspace root, where <workspace-root-basename> is the name of the top-level workspace directory itself (NOT a subdirectory within it). Never modify the source directory.
Steps
- Create
<workspace-root-basename>-azure/at workspace root - Assess — Analyze source, map services, generate report using the scenario-specific assessment guide → functions assessment | app-service assessment
- Migrate — Convert code/config using the scenario-specific migration guide → functions code-migration | app-service code-migration
- Ask User — "Migration complete. Test locally or deploy to Azure?"
- Hand off to azure-prepare for infrastructure, testing, and deployment
Track progress in migration-status.md — see workflow-details.md.