AWS solutions documentation change
Summary
Updated deployment documentation to recommend EKS deployment over ECS, added CloudFormation templates and instructions, and noted ECS deployment will reach end of support on July 15, 2026.
Security assessment
This is a routine documentation update about deployment architecture changes and deprecation timelines. No security vulnerabilities, incidents, or security features are mentioned. The change focuses on deployment methodology and support lifecycle without any security implications.
Diff
diff --git a/solutions/latest/migration-assistant-for-amazon-opensearch-service/deploy-the-solution.md b/solutions/latest/migration-assistant-for-amazon-opensearch-service/deploy-the-solution.md index e4844e17b..e62906a8c 100644 --- a//solutions/latest/migration-assistant-for-amazon-opensearch-service/deploy-the-solution.md +++ b//solutions/latest/migration-assistant-for-amazon-opensearch-service/deploy-the-solution.md @@ -25 +25 @@ This solution sends operational metrics to AWS. We use this data to better under -### ECS deployment +### EKS deployment (recommended) @@ -27 +27 @@ This solution sends operational metrics to AWS. We use this data to better under -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. +The EKS-based deployment is the recommended deployment option for Migration Assistant 3.0. It leverages Amazon Elastic Kubernetes Service (Amazon EKS) to provide a simplified workflow experience with faster configuration changes and built-in orchestration. @@ -29,3 +29 @@ The ECS-based deployment is the more mature solution that has been available sin -###### 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. +#### Launch the CloudFormation stack @@ -33 +31 @@ The ECS solution is expected to be deprecated by Q3 2026. New deployments should -The ECS deployment approach varies depending on your specific migration scenario. Before proceeding, identify your migration scenario at [OpenSearch Migration Phases](https://docs.opensearch.org/latest/migration-assistant/migration-phases). +Choose one of the following options to deploy the EKS infrastructure: @@ -35 +33 @@ The ECS deployment approach varies depending on your specific migration scenario -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. + * [Launch with a new VPC](https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/new?templateURL=https://solutions-reference.s3.amazonaws.com/migration-assistant-for-amazon-opensearch-service/latest/migration-assistant-for-amazon-opensearch-service-create-vpc-eks.template) — Creates a new VPC with all required networking. @@ -37 +35 @@ Follow the deployment and execution steps outlined for your specific migration s -### EKS deployment (preview) + * [Launch into an existing VPC](https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/new?templateURL=https://solutions-reference.s3.amazonaws.com/migration-assistant-for-amazon-opensearch-service/latest/migration-assistant-for-amazon-opensearch-service-import-vpc-eks.template&redirectId) — Uses an existing VPC (requires proper subnet and security group configuration). @@ -39 +36,0 @@ Follow the deployment and execution steps outlined for your specific migration s -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. @@ -41 +37,0 @@ The EKS-based deployment is currently in preview mode and provides a simplified -###### Note @@ -43 +38,0 @@ The EKS-based deployment is currently in preview mode and provides a simplified -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. @@ -45 +40 @@ The EKS solution does not currently support Capture and Replay functionality. If -To deploy the solution using EKS, follow the deployment guide available at [OpenSearch Migrations Wiki on GitHub](https://github.com/opensearch-project/opensearch-migrations/wiki). +After the CloudFormation stack deploys, run the bootstrap script to install the Helm chart and configure the EKS cluster. For detailed instructions, see [Deploying to EKS on GitHub](https://github.com/opensearch-project/opensearch-migrations/wiki/Deploying-to-EKS). @@ -47 +42 @@ To deploy the solution using EKS, follow the deployment guide available at [Open -The GitHub wiki provides detailed instructions for: +The deployment guide provides detailed instructions for: @@ -51 +46 @@ The GitHub wiki provides detailed instructions for: - * Infrastructure deployment + * CloudFormation-based infrastructure deployment (new VPC or existing VPC) @@ -53 +48 @@ The GitHub wiki provides detailed instructions for: - * Configuration options + * Helm chart installation and configuration @@ -55 +50 @@ The GitHub wiki provides detailed instructions for: - * Migration execution + * Migration execution using the Workflow CLI @@ -61,0 +57,12 @@ The GitHub wiki provides detailed instructions for: +For the complete Migration Assistant documentation, see [Migration Assistant for OpenSearch](https://docs.opensearch.org/latest/migration-assistant/). + +### ECS deployment (support only) + +###### Important + +The ECS-based deployment is in support-only mode and will reach end of support on **July 15, 2026**. No new features will be developed for the ECS deployment. New deployments should use the EKS deployment option. + +The ECS-based deployment has been available since Migration Assistant 1.0. Existing ECS deployments will continue to function, but customers are encouraged to migrate to the EKS deployment for access to new features and ongoing support. + +For ECS deployment documentation, see [Migration Assistant (Classic)](https://docs.opensearch.org/classic/migration-assistant/). +