microsoft/Container-Migration-Solution-Accelerator

microsoft/Container-Migration-Solution-Accelerator

Description: This accelerator is a multi-service application that provides a multi-agent, AI-driven migration solution for users moving container service configurations from a cloud platform to Azure Kubernetes Service.

Language: Python

License: MIT

Stars: 17

Forks: 21

Open issues: 33

Created: 2025-09-09T16:44:24Z

Pushed: 2026-06-10T15:05:48Z

Default branch: main

Fork: no

Archived: no

README:

Container Migration Solution Accelerator

Extract, analyze, and migrate Kubernetes configurations from other cloud providers to Azure Kubernetes Service (AKS) using intelligent multi-agent orchestration powered by Azure OpenAI GPT-5.1, Microsoft Agent Framework, and MCP (Model Context Protocol) servers. This solution provides automated platform detection, multi-dimensional analysis, and expert-guided configuration transformation with comprehensive migration reporting.

Transform your Kubernetes workloads with confidence through AI-driven analysis covering security, networking, storage, and Azure Well-Architected Framework principles. Expert agents collaborate to ensure your migrated configurations are production-ready and optimized for Azure.

[SOLUTION OVERVIEW](#solution-overview) | [QUICK DEPLOY](#quick-deploy) | [MIGRATION SCENARIO](#migration-scenario) | [TECHNICAL DOCUMENTATION](#technical-documentation)

[Solution overview](#solution-overview)

This accelerator provides a complete enterprise migration platform leveraging Azure OpenAI GPT-5.1, Microsoft Agent Framework workflows, Azure Container Apps, Azure Blob Storage, Azure Storage Queue, and MCP (Model Context Protocol) servers. The solution consists of a React-based web application for file upload and validation, coupled with an intelligent multi-agent processing engine that analyzes and transforms Kubernetes configurations through event-driven batch processing pipelines.

The architecture follows enterprise-grade batch processing patterns with loosely coupled components, enabling organizations to migrate from managed cloud, enterprise distribution, and self-managed/on-prem Kubernetes platforms (for example: EKS, GKE/Anthos, OpenShift, Rancher/RKE/K3s, Tanzu, and upstream/on-prem Kubernetes) to Azure Kubernetes Service at scale while maintaining comprehensive audit trails and expert-level analysis quality.

Solution architecture

##

The solution uses a sophisticated multi-agent orchestration pattern where specialized expert agents collaborate to:

1. Platform Detection: Automatically identify source platform (other cloud providers platform) 2. Multi-Dimensional Analysis: Technical Architect, Azure Expert, cloud platform Experts, and QA Engineer agents analyze configurations 3. Design Transformation: Apply Azure Well-Architected Framework principles 4. YAML Conversion: Expert YAML transformation with security, networking, and storage optimizations 5. Documentation Generation: Comprehensive migration reports with expert insights

Features

This solution enables enterprise-grade Kubernetes migration with the following capabilities:

• Enterprise Batch Processing Architecture

Complete solution including React web application for file upload, validation, and queue management coupled with intelligent multi-agent processing engine

• Intelligent Platform Detection

Automatically identifies source Kubernetes platform/distribution (for example: EKS, GKE/Anthos, OpenShift, Rancher/RKE/K3s, Tanzu, and self-managed/on-prem Kubernetes) through configuration analysis and applies platform-aware migration strategies

• Multi-Agent Expert Orchestration

Specialized agents (Chief Architect, AKS Expert, platform experts, QA Engineer, Technical Writer, YAML Expert) collaborate using Microsoft Agent Framework group chat orchestration

• Workflow Engine

Each migration step (analysis, design, conversion, documentation) is executed as a step-based Agent Framework workflow with explicit executor chaining

• MCP Server Tool Integration

Agents access intelligent tools through Model Context Protocol servers for file operations, knowledge search, and specialized functions without direct model training

• Azure Well-Architected Framework Compliance

Configurations transformed according to Azure security, reliability, performance, cost optimization, and operational excellence principles

• Comprehensive Migration Reporting

Detailed reports capturing expert analysis, transformation decisions, and recommendations from multiple specialized agents

Agentic Architecture

Orchestration flow: 4 workflow executors coordinate group chats and tools.

flowchart LR
%% Top-level orchestration + telemetry
TELEM["Agent & Process Status
(telemetry)"]
COSMOS[("Cosmos DB
telemetry/state")]
PROC["Process Orchestration
Agent Framework WorkflowBuilder"]

TELEM --> COSMOS
PROC --- TELEM

%% Step lanes
subgraph S1["Step 1: Analysis"]
direction TB
S1EXEC["Analysis Executor"] --> S1ORCH["Analysis Chat Orchestrator
(GroupChatOrchestrator)"] --> S1AGENTS["Agents:
Chief Architect
AKS Expert
Platform experts (EKS/GKE/OpenShift/Rancher/Tanzu/OnPremK8s)"]
end

subgraph S2["Step 2: Design"]
direction TB
S2EXEC["Design Executor"] --> S2ORCH["Design Chat Orchestrator
(GroupChatOrchestrator)"] --> S2AGENTS["Agents:
Chief Architect
AKS Expert
Platform experts (EKS/GKE/OpenShift/Rancher/Tanzu/OnPremK8s)"]
end

subgraph S3["Step 3: YAML Conversion"]
direction TB
S3EXEC["Convert Executor"] --> S3ORCH["YAML Chat Orchestrator
(GroupChatOrchestrator)"] --> S3AGENTS["Agents:
YAML Expert
Azure Architect
AKS Expert
QA Engineer
Chief Architect"]
end

subgraph S4["Step 4: Documentation"]
direction TB
S4EXEC["Documentation Executor"] --> S4ORCH["Documentation Chat Orchestrator
(GroupChatOrchestrator)"] --> S4AGENTS["Agents:
Technical Writer
Azure Architect
AKS Expert
Chief Architect
Platform experts (EKS/GKE/OpenShift/Rancher/Tanzu/OnPremK8s)"]
end

PROC --> S1
S1 -->|Analysis Result| S2
S2 -->|Design Result| S3
S3 -->|YAML Converting Result| S4

If you want to get know more detail about Agentic Architecture, please take a look at this document: [Agentic Architecture](docs/AgenticArchitecture.md)

Technical implementation highlights

Advanced AI Orchestration Patterns:

• Model: Azure OpenAI GPT-5.1 for advanced reasoning and analysis capabilities
• Framework: Microsoft Agent Framework for multi-agent orchestration and workflow…