mcpField
A
azure-cloud-migrate

azure-cloud-migrate

Official
github.com/microsoftCloud & DevOps1.6k517.7k installsUpdated today
Repository

About 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

  1. 01Analyzes source code and maps services in phases
  2. 02Generates a migration assessment report
  3. 03Converts code and configuration for Azure targets
  4. 04Tracks migration progress in migration-status.md

Use cases

  1. 01Migrating AWS Lambda functions to Azure Functions
  2. 02Moving Heroku apps to Azure App Service
  3. 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-migrate

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

Bundled files

References and scripts installed along with SKILL.md.

references/
workflow-details.md
references/services/app-service/
app-engine-to-app-service.md
assessment.md
beanstalk-to-app-service.md
code-migration.md
global-rules.md
heroku-to-app-service.md
references/services/container-apps/
assessment-guide.md
cloudrun-assessment-guide.md
cloudrun-deployment-guide.md
cloudrun-to-container-apps.md
deployment-guide.md
fargate-assessment-guide.md
fargate-deployment-guide.md
fargate-to-container-apps.md
k8s-to-container-apps.md
spring-apps-to-aca.md
spring-assessment-guide.md
spring-dependency-patterns.md
spring-deployment-guide.md
references/services/functions/
assessment.md
code-migration.md
global-rules.md
lambda-to-functions.md
references/services/functions/runtimes/
csharp.md
java.md
javascript.md
powershell.md
python.md
typescript.md

Details

From the project README

Azure Cloud Migrate

This skill handles assessment and code migration of existing cloud workloads to Azure.

Rules

  1. Follow phases sequentially — do not skip
  2. Generate assessment before any code migration
  3. Load the scenario reference and follow its rules
  4. Use mcp_azure_mcp_get_azure_bestpractices and mcp_azure_mcp_documentation MCP tools
  5. Use the latest supported runtime for the target service
  6. Destructive actions require ask_user — functions global-rules | app-service global-rules
  7. 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
  8. 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

SourceTargetReference
AWS LambdaAzure Functionslambda-to-functions.md (assessment, code-migration)
AWS Elastic BeanstalkAzure App Servicebeanstalk-to-app-service.md
HerokuAzure App Serviceheroku-to-app-service.md
Google App EngineAzure App Serviceapp-engine-to-app-service.md
AWS Fargate (ECS)Azure Container Appsfargate-to-container-apps.md (assessment, deployment)
Kubernetes (GKE/EKS/Self-hosted)Azure Container Appsk8s-to-container-apps.md
GCP Cloud RunAzure Container Appscloudrun-to-container-apps.md
Spring Boot (Azure Spring Apps/VMs)Azure Container Appsspring-apps-to-aca.md

No matching scenario? Use mcp_azure_mcp_documentation and mcp_azure_mcp_get_azure_bestpractices tools.

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

  1. Create <workspace-root-basename>-azure/ at workspace root
  2. Assess — Analyze source, map services, generate report using the scenario-specific assessment guide → functions assessment | app-service assessment
  3. Migrate — Convert code/config using the scenario-specific migration guide → functions code-migration | app-service code-migration
  4. Ask User — "Migration complete. Test locally or deploy to Azure?"
  5. Hand off to azure-prepare for infrastructure, testing, and deployment

Track progress in migration-status.md — see workflow-details.md.

Comments

Markdown supported