Подключиться
Yandex Managed Service for MongoDB

Обновление версии MongoDB

Статья создана
,
улучшена

Вы можете обновить кластер Managed Service for MongoDB до версий 4.2 или 4.4.

Обновление доступно только на следующую версию относительно текущей, т.е.:

  • с версии 4.0 на версию 4.2;
  • с версии 4.2 на версию 4.4.

Обновление до версий, которые не являются следующими относительно текущей версии, должно производиться в несколько этапов. Например, для обновления версии кластера с 4.0 до 4.4 его необходимо выполнить в такой последовательности: 4.0 → 4.2 → 4.4.

Перед обновлением

Перед обновлением кластера убедитесь, что это не нарушит работу ваших приложений:

  1. Посмотрите историю изменений для версий 4.2 или 4.4 MongoDB и проверьте, не повлияют ли какие-то изменения на работу приложений.
  2. Попробуйте обновить тестовый кластер (его можно развернуть, например, из резервной копии основного кластера).
  3. Выполните резервное копирование основного кластера непосредственно перед обновлением.

Обновить кластер

  1. Откройте страницу сервиса Managed Service for MongoDB в каталоге, где находится обновляемый кластер.
  2. Выберите нужный кластер в списке и нажмите кнопку Изменить кластер.
  3. В поле Версия выберите пункт 4.2 или 4.4.
  4. Нажмите кнопку Сохранить изменения.

После запуска обновления кластер переходит в статус UPDATING. Дождитесь окончания операции и проверьте версию кластера.

  1. Получите список ваших кластеров MongoDB командой:

    yc managed-mongodb cluster list

  2. Получите информацию о нужном кластере и проверьте версию MongoDB, указанную в свойстве config.version:

    yc managed-mongodb cluster get <id кластера>

  3. Запустите обновление MongoDB:

    yc managed-mongodb cluster update <id кластера> --mongodb-version=<номер новой версии>

    После того, как обновление запущено, кластер переходит в статус UPDATING. Дождитесь окончания операции и проверьте версию кластера.

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

    yc managed-mongodb cluster update <id кластера> --feature-compatibility-version=<номер новой версии>

    Подробнее об обратной совместимости читайте в документации MongoDB.

  1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

    О том, как создать такой файл, см. в разделе Создание MongoDB-кластера.

  2. Добавьте к описанию кластера Managed Service for MongoDB поле version или измените его значение, если оно уже существует:

    resource "yandex_mdb_mongodb_cluster" "<имя кластера>" {
  ...
  cluster_config {
    version = "<версия MongoDB>"
  }
}

  3. Проверьте корректность настроек.

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

    2. Выполните проверку с помощью команды:

      terraform plan

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

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

    1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply

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

Подробнее см. в документации провайдера Terraform.

Обновить версию MongoDB для кластера можно с помощью метода API update: передайте в запросе нужное значение в свойстве configSpec.version.

После обновления все возможности MongoDB, у которых нет обратной совместимости с прежней версией, выключены. Чтобы снять это ограничение, используйте метод API update: передайте в запросе номер новой версии в свойстве configSpec.featureCompatibilityVersion.

Подробнее об обратной совместимости читайте в документации MongoDB.

Примеры

Допустим, нужно обновить кластер с версии 4.0 до версии 4.2.

  1. Чтобы получить список кластеров и узнать идентификатор кластера, выполните команду:

    $ yc managed-mongodb cluster list
+----------------------+---------------+---------------------+--------+---------+
|          ID          |     NAME      |     CREATED AT      | HEALTH | STATUS  |
+----------------------+---------------+---------------------+--------+---------+
| c9q8p8j2gaih8iti42mh |   mongodb406  | 2019-04-23 12:44:17 | ALIVE  | RUNNING |
+----------------------+---------------+---------------------+--------+---------+

  2. Чтобы получить информацию о кластере c9qut3k64b2o9umqogr7, выполните команду:

    $ yc managed-mongodb cluster get c9qut3k64b2o9umqogr7
  id: c9qut3k64b2o9umqogr7
  folder_id: b1g0itj57rbjk9thrinv
  created_at: "2019-07-16T09:43:50.393231Z"
  name: mongodb406
  environment: PRODUCTION
  monitoring:
  - name: Console
    description: Console charts
    link: https://console.cloud.yandex.ru/folders/b1g0itj57rbjk9thrinv/managed-mongodb/cluster/c9qut3k64b2o9umqogr7?section=monitoring
  config:
    version: "4.0"
    feature_compatibility_version: "4.0"
    ...

  3. Для обновления кластера c9qutgkd4b2o9umqog97 до версии 4.2, выполните команду:

    $ yc managed-mongodb cluster update c9qutgkd4b2o9umqog97 --mongodb-version=4.2

  4. Чтобы включить все возможности версии 4.2 в кластере c9qutgkd4b2o9umqog97, выполните команду:

    $ yc managed-mongodb cluster update c9qutgkd4b2o9umqog97 --feature-compatibility-version=4.2
В этой статье: