Migrating a Yandex Managed Service for MongoDB cluster from version 4.4 to 6.0 using Yandex Data Transfer

1. If you do not have Terraform yet, install it.

2. Get the authentication credentials. You can add them to environment variables or specify them later in the provider configuration file.

3. Configure and initialize a provider. There is no need to create a provider configuration file manually, you can download it.

4. Place the configuration file in a separate working directory and specify the parameter values. If you did not add the authentication credentials to environment variables, specify them in the configuration file.

5. In the same working directory, place a .tf file with the following contents:

   resource "yandex_mdb_mongodb_cluster" "old" { }
   

6. Write the MongoDB version 4.4 cluster ID to an environment variable:

   export MONGODB_CLUSTER_ID=<cluster_ID>
   

   You can request the ID with a list of clusters in the folder.

7. Import the MongoDB version 4.4 cluster settings into the Terraform configuration:

   terraform import yandex_mdb_mongodb_cluster.old ${MONGODB_CLUSTER_ID}
   

8. Get the imported configuration:

   terraform show
   

9. Copy it from the terminal and paste it into the .tf file.

10. Place the file in the new imported-cluster directory.

11. Modify the copied configuration so that you can create a new cluster from it:

    • Specify a new cluster name in the resource string and the name parameter.
    • Specify version 6.0 in the version parameter.
    • Delete the created_at, health, id, sharded, and status parameters.
    • In the host sections, delete the health and name parameters.
    • If the maintenance_window section specifies the type = "ANYTIME" parameter value, delete the hour parameter.
    • Delete all user sections (if any). You can add database users using the separate yandex_mdb_mongodb_user resource.
    • Delete all database sections (if any). You can add databases using the separate yandex_mdb_mongodb_database resource.
    • (Optional) Make further modifications if you are looking for more customization.

12. Add the resource to create the database to the file:

    resource "yandex_mdb_mongodb_database" "db1" {
      cluster_id = yandex_mdb_mongodb_cluster.<cluster_name>.id
      name       = "db1"
    }
    

    Where <cluster_name> is the new cluster name specified in the yandex_mdb_mongodb_cluster resource.

13. Add the resource to create user1 to the file:

    resource "yandex_mdb_mongodb_user" "user1" {
      cluster_id = yandex_mdb_mongodb_cluster.<cluster_name>.id
      name       = "user1"
      password   = "<user_password>"
      permission {
        database_name = "db1"
        roles         = ["readWrite"]
      }
      depends_on = [
        yandex_mdb_mongodb_database.db1
      ]
    }
    

    Where <cluster_name> is the new cluster name specified in the yandex_mdb_mongodb_cluster resource.

14. In the imported-cluster directory, get the authentication data.

15. In the same directory, configure and initialize a provider. There is no need to create a provider configuration file manually, you can download it.

16. Place the configuration file in the imported-cluster directory and specify the parameter values. If you did not add the authentication credentials to environment variables, specify them in the configuration file.

17. Check that the Terraform configuration files are correct:

    terraform validate
    

    If there are any errors in the configuration files, Terraform will point them out.

18. Create the required infrastructure:

    1. Run the command to view planned changes:

       terraform plan
       

       If the resource configuration descriptions are correct, the terminal will display a list of the resources to modify and their parameters. This is a test step. No resources are updated.

    2. If you are happy with the planned changes, apply them:

       1. Run the command:

          terraform apply
          

       2. Confirm the update of resources.

       3. Wait for the operation to complete.

    All the required resources will be created in the specified folder. You can check resource availability and their settings in the management console.

resource "yandex_mdb_mongodb_cluster" "<cluster_name>" {
  ...
  timeouts {
    create = "1h30m" # An hour and a half
    update = "2h"    # Two hours
  }
}

If you created your cluster using Terraform:

1. In the terminal window, go to the directory containing the infrastructure plan.

2. Delete the configuration file with the .tf extension.

3. Make sure the Terraform configuration files are correct using this command:

   terraform validate
   

   If there are any errors in the configuration files, Terraform will point them out.

4. Confirm updating the resources.

   1. Run the command to view planned changes:

      terraform plan
      

      If the resource configuration descriptions are correct, the terminal will display a list of the resources to modify and their parameters. This is a test step. No resources are updated.

   2. If you are happy with the planned changes, apply them:

      1. Run the command:

         terraform apply
         

      2. Confirm the update of resources.

      3. Wait for the operation to complete.

   All the resources described in the deleted configuration file will be deleted.