Миграция кластера Yandex Managed Service for MongoDB с версии 4.4 на 6.0

1. Если у вас еще нет Terraform, установите его.

2. Получите данные для аутентификации. Вы можете добавить их в переменные окружения или указать далее в файле с настройками провайдера.

3. Настройте и инициализируйте провайдер. Чтобы не создавать конфигурационный файл с настройками провайдера вручную, скачайте его.

4. Поместите конфигурационный файл в отдельную рабочую директорию и укажите значения параметров. Если данные для аутентификации не были добавлены в переменные окружения, укажите их в конфигурационном файле.

5. В той же рабочей директории разместите файл с расширением .tf и содержимым:

   resource "yandex_mdb_mongodb_cluster" "old" { }
   

6. Запишите идентификатор кластера MongoDB версии 4.4 в переменную окружения:

   export MONGODB_CLUSTER_ID=<идентификатор_кластера>
   

   Идентификатор можно запросить вместе со списком кластеров в каталоге.

7. Импортируйте настройки кластера MongoDB версии 4.4 в конфигурацию Terraform:

   terraform import yandex_mdb_mongodb_cluster.old ${MONGODB_CLUSTER_ID}
   

8. Получите импортированную конфигурацию:

   terraform show
   

9. Скопируйте ее из терминала и вставьте в файл с расширением .tf.

10. Расположите файл в новой директории imported-cluster.

11. Измените скопированную конфигурацию так, чтобы из нее можно было создать новый кластер:

    • Укажите новое имя кластера в строке resource и параметре name.
    • Укажите в параметре version версию 6.0.
    • Удалите параметры created_at, health, id, sharded и status.
    • В блоках host удалите параметры health и name.
    • Если в блоке maintenance_window указано значение параметра type = "ANYTIME", удалите параметр hour.
    • Если есть блоки user, удалите их. Пользователи БД добавляются с помощью отдельного ресурса yandex_mdb_mongodb_user.
    • Если есть блоки database, удалите их. Базы данных добавляются с помощью отдельного ресурса yandex_mdb_mongodb_database.
    • (Опционально) Внесите дополнительные изменения, если вам нужна не идентичная, а кастомизированная копия кластера.

12. Добавьте в файл ресурс для создания базы данных:

    resource "yandex_mdb_mongodb_database" "db1" {
      cluster_id = yandex_mdb_mongodb_cluster.<имя_кластера>.id
      name       = "db1"
    }
    

    Где <имя_кластера> — новое имя кластера, указанное в ресурсе yandex_mdb_mongodb_cluster.

13. Добавьте в файл ресурс для создания пользователя user1:

    resource "yandex_mdb_mongodb_user" "user1" {
      cluster_id = yandex_mdb_mongodb_cluster.<имя_кластера>.id
      name       = "user1"
      password   = "<пароль_пользователя>"
      permission {
        database_name = "db1"
        roles         = ["readWrite"]
      }
      depends_on = [
        yandex_mdb_mongodb_database.db1
      ]
    }
    

    Где <имя_кластера> — новое имя кластера, указанное в ресурсе yandex_mdb_mongodb_cluster.

14. В директории imported-cluster получите данные для аутентификации.

15. В этой же директории настройте и инициализируйте провайдер. Чтобы не создавать конфигурационный файл с настройками провайдера вручную, скачайте его.

16. Поместите конфигурационный файл в директорию imported-cluster и укажите значения параметров. Если данные для аутентификации не были добавлены в переменные окружения, укажите их в конфигурационном файле.

17. Проверьте корректность файлов конфигурации Terraform:

    terraform validate
    

    Если в файлах конфигурации есть ошибки, Terraform на них укажет.

18. Создайте необходимую инфраструктуру:

    1. Выполните команду для просмотра планируемых изменений:

       terraform plan
       

       Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

    2. Если вас устраивают планируемые изменения, внесите их:

       1. Выполните команду:

          terraform apply
          

       2. Подтвердите изменение ресурсов.

       3. Дождитесь завершения операции.

    В указанном каталоге будут созданы все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в консоли управления.

resource "yandex_mdb_mongodb_cluster" "<имя_кластера>" {
  ...
  timeouts {
    create = "1h30m" # Полтора часа
    update = "2h"    # 2 часа
  }
}

Если вы создавали кластер с помощью Terraform:

1. В терминале перейдите в директорию с планом инфраструктуры.

2. Удалите конфигурационный файл с расширением .tf.

3. Проверьте корректность файлов конфигурации Terraform с помощью команды:

   terraform validate
   

   Если в файлах конфигурации есть ошибки, Terraform на них укажет.

4. Подтвердите изменение ресурсов.

   1. Выполните команду для просмотра планируемых изменений:

      terraform plan
      

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

   2. Если вас устраивают планируемые изменения, внесите их:

      1. Выполните команду:

         terraform apply
         

      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

   Все ресурсы, которые были описаны в удаленном конфигурационном файле, будут удалены.