Связаться с намиПодключиться

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

Статья создана
Улучшена
Обновлена 2 декабря 2024 г.

Вы можете обновить кластер Managed Service for MongoDB только на следующую версию относительно текущей, например, с версии 4.2 на 4.4. Обновление до более поздних версий производится поэтапно. Например, обновление версии MongoDB с 4.2 до 6.0 выполняется в такой последовательности: 4.2 → 4.4 → 5.0 → 6.0.

Примечание

Начиная с 3 февраля 2025 года существующие кластеры с версией MongoDB 5.0 будут автоматически обновлены до версии 6.0 в связи с прекращением поддержки версии 5.0 разработчиком. Рекомендуем заранее перейти на использование актуальных версий MongoDB.

Внимание

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

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

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

  1. Посмотрите в истории изменений MongoDB, как обновления могут повлиять на работу ваших приложений.
  2. Попробуйте обновить версию на тестовом кластере. Его можно развернуть из резервной копии основного кластера.
  3. Создайте резервную копию основного кластера непосредственно перед обновлением версии.

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

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

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

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

    yc managed-mongodb cluster list

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

    yc managed-mongodb cluster get <имя_или_идентификатор_кластера>

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

    yc managed-mongodb cluster update <имя_или_идентификатор_кластера> \
   --mongodb-version=<номер_новой_версии>

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

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

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

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

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

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

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

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

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

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

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

      terraform validate

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

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

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

      terraform plan

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

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

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

        terraform apply

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

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

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

Ограничения по времени

Провайдер Terraform ограничивает время на выполнение операций с кластером Managed Service for MongoDB:

  • создание, в т. ч. путем восстановления из резервной копии, — 30 минут;
  • изменение — 60 минут.

Операции, длящиеся дольше указанного времени, прерываются.

Как изменить эти ограничения?

Добавьте к описанию кластера блок timeouts, например:

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

Чтобы обновить версию MongoDB, воспользуйтесь методом REST API update для ресурса Cluster или вызовом gRPC API ClusterService/Update и передайте в запросе:

  • Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
  • Версию MongoDB, до которой производится обновление, в параметре configSpec.version.
  • Список настроек, которые необходимо изменить (в данном случае — configSpec.version), в параметре updateMask.

Важно

Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask (одной строкой через запятую).

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

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

Примеры

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

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

    yc managed-mongodb cluster list

    Результат:

    +----------------------+---------------+---------------------+--------+---------+
|          ID          |     NAME      |     CREATED AT      | HEALTH | STATUS  |
+----------------------+---------------+---------------------+--------+---------+
| c9q8p8j2gaih******** |   mongodb406  | 2019-04-23 12:44:17 | ALIVE  | RUNNING |
+----------------------+---------------+---------------------+--------+---------+

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

    yc managed-mongodb cluster get c9qut3k64b2o********

    Результат:

    id: c9qut3k64b2o********
folder_id: b1g0itj57rbj********
created_at: "2019-07-16T09:43:50.393231Z"
name: mongodb406
environment: PRODUCTION
monitoring:
- name: Console
  description: Console charts
  link: https://console.yandex.cloud/folders/b1g0itj57rbj********/managed-mongodb/cluster/c9qut3k64b2o********?section=monitoring
config:
  version: "5.0"
  feature_compatibility_version: "5.0"
  ...

  3. Чтобы обновить кластер c9qutgkd4b2o******** до версии 6.0, выполните команду:

    yc managed-mongodb cluster update c9qutgkd4b2o******** \
    --mongodb-version=6.0

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

    yc managed-mongodb cluster update c9qutgkd4b2o******** \
    --feature-compatibility-version=6.0
Предыдущая
Изменение настроек кластера
Следующая
Остановка и запуск кластера