platform-migration

Guides infrastructure and platform migration including cloud-to-cloud migration (AWS to GCP, Azure to AWS), Kubernetes cluster migration, CI/CD platform changes, monitoring stack migration, identity provider migration, and network infrastructure transformation. Covers IaC migration, container orchestration, service mesh, observability tools, and multi-cloud strategies. Use when migrating infrastructure, changing cloud providers, moving Kubernetes clusters, or when users mention "cloud migration", "platform switch", "infrastructure migration", "K8s migration", "multi-cloud", or "cloud provider change".

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "platform-migration" with this command: npx skills add dauquangthanh/hanoi-rainbow/dauquangthanh-hanoi-rainbow-platform-migration

Platform Migration

Overview

This skill provides comprehensive guidance for migrating infrastructure platforms, cloud providers, container orchestration systems, CI/CD pipelines, and observability stacks. Focus is on infrastructure-level migrations that complement application modernization efforts.

Platform migrations are infrastructure-focused and should be paired with application migration strategies. Use cloud-neutral design patterns to reduce future migration effort, though multi-cloud strategies increase complexity while reducing vendor lock-in.

Core Migration Principles

Key Practices:

  • Test everything in non-production first
  • Automate using Infrastructure as Code (IaC)
  • Migrate incrementally rather than "big bang"
  • Maintain both platforms during stabilization
  • Budget 20-30% more time than estimated
  • Document architecture decisions and rationale

Avoid These Pitfalls:

  • Migrating everything at once without phased approach
  • Skipping non-production validation
  • Ignoring cost estimation for target platform
  • Failing to optimize during migration (pure lift-and-shift)
  • Inadequate monitoring during transition
  • Leaving resources running on both platforms post-migration

Migration Workflow

Step 1: Assessment and Planning

Identify Migration Type:

  • Cloud-to-cloud (AWS↔GCP↔Azure)
  • Kubernetes cluster migration (EKS→GKE→AKS)
  • CI/CD platform change (Jenkins→GitLab→GitHub Actions)
  • Monitoring stack migration (Prometheus→Datadog→New Relic)
  • Container registry migration (Docker Hub→ECR→GCR→ACR)
  • Network infrastructure transformation
  • Infrastructure as Code migration (Terraform→CloudFormation→Bicep)

For detailed migration type workflows: See migration-types.md

Step 2: Inventory and Dependencies

  • Document all resources in source platform
  • Map dependencies between components
  • Identify proprietary services without direct equivalents
  • Estimate costs in target platform
  • Assess technical constraints and requirements

Step 3: Design Target Architecture

  • Map source services to target equivalents
  • Design network topology and connectivity
  • Plan IAM and security model
  • Define migration approach (phased, parallel, cutover)
  • Create rollback procedures

For IaC-specific migrations: See infrastructure-as-code-migration.md

Step 4: Risk Assessment and Mitigation

  • Identify critical dependencies and single points of failure
  • Plan for downtime windows
  • Establish success criteria and validation tests
  • Define rollback triggers and procedures

For comprehensive risk planning: See risk-management.md

Step 5: Pilot Migration

  • Select non-critical workload for pilot
  • Execute migration following documented procedure
  • Validate functionality and performance
  • Measure costs and resource utilization
  • Document lessons learned and adjust plan

Step 6: Production Migration

  • Migrate in planned waves/phases
  • Implement data replication and synchronization
  • Execute DNS cutover per service
  • Monitor performance and errors continuously
  • Validate each wave before proceeding

For validation procedures: See post-migration-validation.md

Step 7: Optimization and Cleanup

  • Right-size resources based on actual usage
  • Optimize costs using platform-native features
  • Improve performance with platform capabilities
  • Decommission source resources systematically
  • Document final architecture

For cost optimization strategies: See cost-optimization-during-migration.md

Common Migration Scenarios

Cloud-to-Cloud Migration

Migrating between AWS, GCP, Azure, or moving from on-premise to cloud. Requires service mapping, network connectivity, and data transfer strategy.

Load: migration-types.md - Section 1: Cloud-to-Cloud Migration

Kubernetes Platform Migration

Moving clusters between EKS, GKE, AKS, or to self-managed Kubernetes. Involves workload migration, persistent storage, service meshes, and ingress controllers.

Load: migration-types.md - Section 2: Kubernetes Platform Migration

CI/CD Platform Changes

Transitioning between Jenkins, GitLab CI, GitHub Actions, CircleCI, or other platforms. Requires pipeline translation and secrets migration.

Load: migration-types.md - Section 3: CI/CD Platform Migration

Monitoring Stack Migration

Changing observability tools like Prometheus→Datadog, CloudWatch→New Relic. Includes metrics, logs, traces, and alerting.

Load: migration-types.md - Section 4: Monitoring Stack Migration

Container Registry Migration

Moving container images between Docker Hub, ECR, GCR, ACR, Harbor, or private registries.

Load: container-registry-migration.md

Network Infrastructure Migration

Transforming VPC configuration, VPN connections, DNS, load balancers, and CDN infrastructure.

Load: network-infrastructure-migration.md

Database Platform Migration

Migrating databases to different cloud providers or managed services.

Load: database-platform-migration.md

Migration Tools and Utilities

For platform-specific migration tools, automation scripts, and utilities:

Load: migration-tools.md

Includes cloud provider migration tools (AWS MGN, Azure Migrate, Google Cloud Migrate), Kubernetes tools (Velero, Kustomize), IaC tools (Terraformer, CDK), and data transfer utilities.

Reference Documentation

Migration Principles

Load: migration-principles.md
Complete best practices, anti-patterns, and key considerations for any platform migration.

Risk Management

Load: risk-management.md
Risk identification, mitigation strategies, contingency planning, and rollback procedures.

Post-Migration Validation

Load: post-migration-validation.md
Validation checklists, testing procedures, performance benchmarking, and cutover verification.

Cost Optimization

Load: cost-optimization-during-migration.md
Cost analysis, optimization strategies, and budget management during migration.

Output Formats

When generating migration artifacts, produce:

  • Migration Plan: Detailed phases, timelines, dependencies, resources
  • Architecture Diagrams: Source and target architecture with transition states
  • Service Mapping: Complete mapping between source and target services
  • Runbooks: Step-by-step execution procedures with rollback steps
  • Validation Checklists: Acceptance criteria and testing procedures
  • Risk Register: Identified risks, impact, probability, mitigation
  • Cost Analysis: Comparative cost breakdown with optimization opportunities

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

frontend-design-review

No summary provided by upstream source.

Repository SourceNeeds Review
General

keycloak-administration

No summary provided by upstream source.

Repository SourceNeeds Review
General

frontend-ui-ux-design

No summary provided by upstream source.

Repository SourceNeeds Review
General

oracle-cloud

No summary provided by upstream source.

Repository SourceNeeds Review