-
Notifications
You must be signed in to change notification settings - Fork 260
feat(mdb): index migration #5206
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
Merged
Merged
Changes from all commits
Commits
Show all changes
5 commits
Select commit
Hold shift + click to select a range
edeb1c3
fix(mdb): migration pt1
ldecarvalho-doc 99c33ad
fix(mdb): migration pt2
ldecarvalho-doc 0d2f811
feat(mdb): mongosync - MTA-6186 (#5208)
ldecarvalho-doc bf01ec6
fix(mdb): reviews
ldecarvalho-doc 5d98710
fix(mdb): review walter
ldecarvalho-doc File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| meta: | ||
| title: Managed MongoDB® - Additional Content | ||
| description: Managed MongoDB® Additional Content | ||
| content: | ||
| h1: Managed MongoDB® - Additional Content | ||
| paragraph: Managed MongoDB® Additional Content | ||
| --- |
25 changes: 25 additions & 0 deletions
25
...s/managed-mongodb-databases/additional-content/migrating-to-managed-mongodb.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,25 @@ | ||
| --- | ||
| meta: | ||
| title: Migrating to Scaleway Managed MongoDB® | ||
| description: Learn how to migrate your MongoDB® databases to Scaleway Managed MongoDB® for improved performance and scalability | ||
| content: | ||
| h1: Migrating to Scaleway Managed MongoDB® | ||
| paragraph: Discover the benefits of migrating your MongoDB® databases to Scaleway Managed MongoDB® and get step-by-step guidance on the migration process | ||
| tags: databases mongodb migration managed-databases | ||
| dates: | ||
| validation: 2025-06-26 | ||
| categories: | ||
| - managed-databases | ||
| - mongodb | ||
| --- | ||
|
|
||
| Scaleway Managed MongoDB® allows you to run your Database Instances without setting up or managing infrastructure. Scaleway is responsible for implementing and maintaining features that improve the performance, scalability and security of your Database Instances. | ||
|
|
||
| If you have a self-managed MongoDB®, or you if use a different cloud provider, you can easily migrate your databases to Scaleway. | ||
|
|
||
| The migration processes described below are defined by the expected downtime. You can select the right option for your use case, depending on your downtime tolerance. | ||
|
|
||
| | Downtime tolerance | Recommended migration method | Benefits | | ||
| | --- | --- | --- | | ||
| | Can afford downtime | [Classic mongodump/mongorestore workflow](/managed-mongodb-databases/api-cli/backup-and-restore/) | Easy, straightforward | | ||
| | Cannot afford downtime | [MongoDB® Cluster-to-Cluster sync tool](/managed-mongodb-databases/api-cli/cluster-to-cluster-sync) (`mongosync` binary) | Zero downtime, real-time data sync, flexible migration windows, easy rollback. Refer to the official PostgreSQL documentation for a list of the tool's [limitations](https://www.mongodb.com/docs/cluster-to-cluster-sync/current/reference/limitations/#std-label-c2c-limitationsl) | |
54 changes: 54 additions & 0 deletions
54
pages/managed-mongodb-databases/api-cli/cluster-to-cluster-sync.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,54 @@ | ||
| --- | ||
| meta: | ||
| title: Migrating data with mongosync | ||
| description: This page shows you how to migrate data using MongoDB®'s Cluster-to-Cluster tool | ||
| content: | ||
| h1: Migrating data with mongosync | ||
| paragraph: This page provides a guide on how to migrate data using MongoDB®'s Cluster-to-Cluster tool | ||
| tags: databases mongodb migration mongosync data-synchronization | ||
| dates: | ||
| validation: 2025-06-30 | ||
| posted: 2025-06-30 | ||
| categories: | ||
| - managed-databases | ||
| - mongodb | ||
| --- | ||
|
|
||
| Scaleway Managed MongoDB® is compatible with the [MongoDB® Cluster-to-Cluster tool](https://www.mongodb.com/docs/cluster-to-cluster-sync/current/quickstart/#std-label-c2c-quickstart). | ||
|
|
||
| Cluster-to-Cluster sync helps you migrate data from one cluster to another without downtime through synchronization. Until the sync is finalized, the tool replicates and writes data from one cluster to another. | ||
|
|
||
|
|
||
| <Message type="important"> | ||
| Refer to the official PostgreSQL documentation for a list of Cluster-to-Cluster sync's [limitations](https://www.mongodb.com/docs/cluster-to-cluster-sync/current/reference/limitations/#std-label-c2c-limitationsl) | ||
| </Message> | ||
|
|
||
| <Macro id="requirements" /> | ||
|
|
||
| - A Scaleway account logged into the [console](https://console.scaleway.com) | ||
| - A [MongoDB® Database Instance](/managed-mongodb-databases/how-to/create-a-database-instance/) | ||
| - Installed a [MongoDB®-compatible client](https://www.mongodb.com/try/download/shell) | ||
| - Set up your [environment variables](/scaleway-cli/reference-content/environment-variables/#reserved-environment-variables) for the Scaleway API | ||
|
|
||
| 1. Create a user in your MongoDB® Instance. Make sure you replace `<user-name>`, `<password>` and `{instance_id}` with the user name of the user, its password and the MongoDB® Instance UUID, respectively. | ||
|
|
||
| ``` | ||
| curl -X POST \ | ||
| -H "X-Auth-Token: $SCW_SECRET_KEY" \ | ||
| -H "Content-Type: application/json" \ | ||
| -d '{"name":"<user-name>","password":"<password>"}' \ | ||
| "https://api.scaleway.com/mongodb/v1/regions/fr-par/instances/{instance_id}/users" | ||
| ``` | ||
|
|
||
| 2. [Apply the `sync` role to the user](/managed-mongodb-databases/how-to/manage-users/#how-to-apply-a-role-to-a-user) for any database. The `db_admin`role also allows you to sync. | ||
| 3. [Download and install `mongosync` for your host system](https://www.mongodb.com/docs/cluster-to-cluster-sync/current/quickstart/#download-and-install-mongosync). | ||
|
|
||
| <Message type="tip"> | ||
| If the database you want to sync is bigger than 100 GB, we recommend you use a [Scaleway Instance](/instances/how-to/create-an-instance) to sync. | ||
| </Message> | ||
|
|
||
| 3. [Connect the clusters](https://www.mongodb.com/docs/cluster-to-cluster-sync/current/quickstart/#connect-the-clusters). | ||
|
|
||
| 4. [Migrate data between clusters](https://www.mongodb.com/docs/cluster-to-cluster-sync/current/quickstart/#migrate-data-between-clusters). | ||
|
|
||
| 5. [Finalize the cut-over process](https://www.mongodb.com/docs/cluster-to-cluster-sync/current/quickstart/#finalize-cutover-process). | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.