Обновление версии MongoDB
Вы можете обновить кластер Managed Service for MongoDB только на следующую версию относительно текущей, например, с версии 4.2 на 4.4. Обновление до более поздних версий производится поэтапно. Например, обновление версии MongoDB с 4.2 до 6.0 выполняется в такой последовательности: 4.2 → 4.4 → 5.0 → 6.0.
Внимание
После обновления невозможно вернуть кластер к предыдущей версии.
Перед обновлением версии
Убедитесь, что это не нарушит работу ваших приложений:
- Посмотрите в истории изменений
MongoDB, как обновления могут повлиять на работу ваших приложений. - Попробуйте обновить версию на тестовом кластере. Его можно развернуть из резервной копии основного кластера.
- Создайте резервную копию основного кластера непосредственно перед обновлением версии.
Обновить кластер
- Перейдите на страницу каталога
и выберите сервис Managed Service for MongoDB. - Выберите нужный кластер в списке и нажмите кнопку Редактировать.
- В поле Версия выберите номер новой версии.
- Нажмите кнопку Сохранить изменения.
После запуска обновления кластер переходит в статус UPDATING. Дождитесь окончания операции и проверьте версию кластера.
-
Получите список ваших кластеров MongoDB командой:
yc managed-mongodb cluster list
-
Получите информацию о нужном кластере и проверьте версию MongoDB, указанную в свойстве
config.version
:yc managed-mongodb cluster get <имя_или_идентификатор_кластера>
-
Запустите обновление MongoDB:
yc managed-mongodb cluster update <имя_или_идентификатор_кластера> \ --mongodb-version=<номер_новой_версии>
После запуска обновления кластер переходит в статус UPDATING. Дождитесь окончания операции и проверьте версию кластера.
-
После обновления все возможности MongoDB, у которых нет обратной совместимости с прежней версией, выключаются. Чтобы снять это ограничение, выполните команду:
yc managed-mongodb cluster update <имя_или_идентификатор_кластера> \ --feature-compatibility-version=<номер_новой_версии>
Подробнее об обратной совместимости читайте в документации MongoDB
.
-
Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.
О том, как создать такой файл, см. в разделе Создание кластера.
-
Добавьте к описанию кластера Managed Service for MongoDB поле
version
или измените его значение, если оно уже существует:resource "yandex_mdb_mongodb_cluster" "<имя_кластера>" { ... cluster_config { version = "<версия_MongoDB>" } }
-
Проверьте корректность настроек.
-
В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
-
Выполните команду:
terraform validate
Если в файлах конфигурации есть ошибки, Terraform на них укажет.
-
-
Подтвердите изменение ресурсов.
-
Выполните команду для просмотра планируемых изменений:
terraform plan
Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
-
Если вас устраивают планируемые изменения, внесите их:
-
Выполните команду:
terraform apply
-
Подтвердите изменение ресурсов.
-
Дождитесь завершения операции.
-
-
Подробнее см. в документации провайдера 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.
-
Чтобы узнать идентификатор кластера, получите список всех кластеров в каталоге:
yc managed-mongodb cluster list
Результат:
+----------------------+---------------+---------------------+--------+---------+ | ID | NAME | CREATED AT | HEALTH | STATUS | +----------------------+---------------+---------------------+--------+---------+ | c9q8p8j2gaih******** | mongodb406 | 2019-04-23 12:44:17 | ALIVE | RUNNING | +----------------------+---------------+---------------------+--------+---------+
-
Чтобы получить информацию о кластере
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" ...
-
Чтобы обновить кластер
c9qutgkd4b2o********
до версии 6.0, выполните команду:yc managed-mongodb cluster update c9qutgkd4b2o******** \ --mongodb-version=6.0
-
Чтобы включить все возможности версии 6.0 в кластере
c9qutgkd4b2o********
, выполните команду:yc managed-mongodb cluster update c9qutgkd4b2o******** \ --feature-compatibility-version=6.0