Deploy the solution - Migration Assistant for Amazon OpenSearch Service

Deploy the solution

This solution provides two deployment options: ECS-based deployment and EKS-based deployment. Choose the option that best fits your migration requirements.

Before you begin, review the cost, architecture, network security, and other considerations discussed earlier in this guide.

Important

To update to a newer version of this solution, uninstall and redeploy it. This solution isn’t backwards-compatible.

Important

This solution sends operational metrics to AWS. We use this data to better understand how customers use this solution and related services and products. AWS owns the data gathered though this survey. Data collection is subject to the Privacy Notice.

Deployment options

ECS deployment

The ECS-based deployment is the more mature solution that has been available since Migration Assistant 1.0. However, this solution is being phased out in favor of the EKS deployment, which provides an simplified workflow experience.

Important

The ECS solution is expected to be deprecated by Q3 2026. New deployments should consider using the EKS deployment option unless specific requirements necessitate the ECS approach.

The ECS deployment approach varies depending on your specific migration scenario. Before proceeding, identify your migration scenario at OpenSearch Migration Phases.

Follow the deployment and execution steps outlined for your specific migration scenario in the OpenSearch documentation. The appropriate steps will depend on whether you are performing a metadata migration, snapshot migration, live traffic capture and replay, or another migration pattern.

EKS deployment (preview)

The EKS-based deployment is currently in preview mode and provides a simplified workflow experience. This solution leverages Kubernetes to provide a simpler operator experience and provides quicker turnaround times on configuration changes.

Note

The EKS solution does not currently support Capture and Replay functionality. If your migration requires Capture and Replay, you must use the ECS deployment option.

To deploy the solution using EKS, follow the deployment guide available at OpenSearch Migrations Wiki on GitHub.

The GitHub wiki provides detailed instructions for:

  • Prerequisites and environment setup

  • Infrastructure deployment

  • Configuration options

  • Migration execution

  • Monitoring and troubleshooting