Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Migrations - Capture and Replay release documentation #4991

Conversation

sumobrian
Copy link
Contributor

@sumobrian sumobrian commented Sep 8, 2023

Description

This PR provides the initial documentation for the first Migrations release. The release is the first release in a series of incremental releases leading up to a 1.0 release.

Issues Resolved

Fixes #4855

Checklist

  • By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license and subject to the Developers Certificate of Origin.
    For more information on following Developer Certificate of Origin and signing off your commits, please check here.

_tools/index.md Outdated Show resolved Hide resolved
_tools/index.md Outdated Show resolved Hide resolved
_upgrade-to/index.md Outdated Show resolved Hide resolved
@Naarcha-AWS Naarcha-AWS added 4 - Doc review PR: Doc review in progress backport 2.9 PR: Backport label for 2.9 labels Sep 12, 2023
@sumobrian
Copy link
Contributor Author

Reviewed these changes. They look good to me. One optional change is that I would update the github URL to point to the specific release branch: https://github.com/opensearch-project/opensearch-migrations/tree/capture-and-replay-v0.1.0

@Naarcha-AWS Naarcha-AWS self-requested a review September 12, 2023 17:21
Copy link
Collaborator

@natebower natebower left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Naarcha-AWS @sumobrian Please see my comments and changes and let me know if you have any questions. Thanks!

_tools/index.md Outdated
The OpenSearch Kubernetes (K8s) Operator is an open-source Kubernetes operator that helps automate the deployment and provisioning of OpenSearch and OpenSearch Dashboards in a containerized environment. For information about how to use the K8s operator, see [OpenSearch Kubernetes operator]({{site.url}}{{site.baseurl}}/tools/k8s-operator/)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Operator" is capitalized as part of the name in the documentation (https://opensearch.org/docs/latest/tools/k8s-operator/), so I've followed suit here. Also, the page this links to does not actually have a title.

_tools/index.md Outdated Show resolved Hide resolved
_tools/index.md Outdated
## OpenSearch upgrade, migration, and comparison tools

The OpenSearch Migration tools facilitate migrations to OpenSearch and upgrades to newer version of OpenSearch. These can help you can set up a proof-of-concept environment locally using Docker containers or deploy to AWS using a one-click deployment script. This empowers you to fine-tune cluster configurations and manage workloads more effectively before migration.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ideally, the noun would follow "deploy". Deploy your [noun] to AWS.

_tools/index.md Outdated Show resolved Hide resolved
_tools/index.md Outdated Show resolved Hide resolved
_tools/index.md Outdated
2. Meanwhile, traffic to the target cluster is replayed at an identical rate to ensure a direct comparison between the source cluster and the target.

For more information about OpenSearch Migration tools, see the documentation in the [OpenSearch Migration GitHub repository](https://github.com/opensearch-project/opensearch-migrations/tree/capture-and-replay-v0.1.0).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Capitalizing "migration" implies that we have an offering called "OpenSearch Migration".

_upgrade-to/index.md Outdated Show resolved Hide resolved
_install-and-configure/index.md Outdated Show resolved Hide resolved
@@ -110,4 +111,16 @@ The OpenSearch CLI command line interface (opensearch-cli) lets you manage your

## OpenSearch Kubernetes operator
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## OpenSearch Kubernetes operator
## OpenSearch Kubernetes Operator

_tools/index.md Outdated Show resolved Hide resolved
@Naarcha-AWS Naarcha-AWS added 5 - Editorial review PR: Editorial review in progress and removed 4 - Doc review PR: Doc review in progress labels Sep 12, 2023
Co-authored-by: Nathan Bower <[email protected]>
Signed-off-by: Naarcha-AWS <[email protected]>
@Naarcha-AWS Naarcha-AWS merged commit b024b6c into opensearch-project:main Sep 12, 2023
opensearch-trigger-bot bot pushed a commit that referenced this pull request Sep 12, 2023
* Add Migrations - Capture and Replay release documentation

Signed-off-by: Brian Presley <[email protected]>

* Apply suggestions from code review

Signed-off-by: Naarcha-AWS <[email protected]>

* Apply suggestions from code review

Co-authored-by: Nathan Bower <[email protected]>
Signed-off-by: Naarcha-AWS <[email protected]>

---------

Signed-off-by: Brian Presley <[email protected]>
Signed-off-by: Naarcha-AWS <[email protected]>
Co-authored-by: Brian Presley <[email protected]>
Co-authored-by: Naarcha-AWS <[email protected]>
Co-authored-by: Nathan Bower <[email protected]>
(cherry picked from commit b024b6c)
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Naarcha-AWS added a commit that referenced this pull request Sep 12, 2023
)

* Add Migrations - Capture and Replay release documentation



* Apply suggestions from code review



* Apply suggestions from code review




---------






(cherry picked from commit b024b6c)

Signed-off-by: Brian Presley <[email protected]>
Signed-off-by: Naarcha-AWS <[email protected]>
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: Brian Presley <[email protected]>
Co-authored-by: Naarcha-AWS <[email protected]>
Co-authored-by: Nathan Bower <[email protected]>
vagimeli pushed a commit that referenced this pull request Sep 19, 2023
* Add Migrations - Capture and Replay release documentation

Signed-off-by: Brian Presley <[email protected]>

* Apply suggestions from code review

Signed-off-by: Naarcha-AWS <[email protected]>

* Apply suggestions from code review

Co-authored-by: Nathan Bower <[email protected]>
Signed-off-by: Naarcha-AWS <[email protected]>

---------

Signed-off-by: Brian Presley <[email protected]>
Signed-off-by: Naarcha-AWS <[email protected]>
Co-authored-by: Brian Presley <[email protected]>
Co-authored-by: Naarcha-AWS <[email protected]>
Co-authored-by: Nathan Bower <[email protected]>
vagimeli added a commit that referenced this pull request Sep 19, 2023
harshavamsi pushed a commit to harshavamsi/documentation-website that referenced this pull request Oct 31, 2023
…-project#4991)

* Add Migrations - Capture and Replay release documentation

Signed-off-by: Brian Presley <[email protected]>

* Apply suggestions from code review

Signed-off-by: Naarcha-AWS <[email protected]>

* Apply suggestions from code review

Co-authored-by: Nathan Bower <[email protected]>
Signed-off-by: Naarcha-AWS <[email protected]>

---------

Signed-off-by: Brian Presley <[email protected]>
Signed-off-by: Naarcha-AWS <[email protected]>
Co-authored-by: Brian Presley <[email protected]>
Co-authored-by: Naarcha-AWS <[email protected]>
Co-authored-by: Nathan Bower <[email protected]>
vagimeli pushed a commit that referenced this pull request Dec 21, 2023
* Add Migrations - Capture and Replay release documentation

Signed-off-by: Brian Presley <[email protected]>

* Apply suggestions from code review

Signed-off-by: Naarcha-AWS <[email protected]>

* Apply suggestions from code review

Co-authored-by: Nathan Bower <[email protected]>
Signed-off-by: Naarcha-AWS <[email protected]>

---------

Signed-off-by: Brian Presley <[email protected]>
Signed-off-by: Naarcha-AWS <[email protected]>
Co-authored-by: Brian Presley <[email protected]>
Co-authored-by: Naarcha-AWS <[email protected]>
Co-authored-by: Nathan Bower <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
5 - Editorial review PR: Editorial review in progress backport 2.9 PR: Backport label for 2.9
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[DOC] Live traffic capture and replay solution for Migration
3 participants