Изменение настроек кластера
После создания кластера вы можете:
-
Увеличить размер хранилища (недоступно для хранилища на нереплицируемых SSD-дисках).
-
Настроить серверы MongoDB согласно документации MongoDB.
Изменить класс хостов
Примечание
Некоторые настройки MongoDB зависят от выбранного класса хостов.
-
Перейдите на страницу каталога и выберите сервис Managed Service for MongoDB.
-
Выберите кластер и нажмите кнопку Изменить кластер на панели сверху.
-
В блоке Класс хоста выберите:
- Одну из доступных платформ.
- Тип конфигурации: memory-optimized, standard или burstable.
- Класс хостов — он определяет технические характеристики виртуальных машин, на которых будут развернуты хосты БД. При изменении класса хостов для кластера меняются характеристики всех созданных хостов.
-
Нажмите кнопку Сохранить изменения.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы изменить класс хостов для кластера:
-
Посмотрите описание команды CLI для изменения кластера:
yc managed-mongodb cluster update --help
-
Запросите список доступных классов хостов (в колонке
ZONES
указаны зоны доступности, в которых можно выбрать соответствующий класс):yc managed-mongodb resource-preset list +-----------+--------------------------------+-------+----------+ | ID | ZONE IDS | CORES | MEMORY | +-----------+--------------------------------+-------+----------+ | s1.micro | ru-central1-a, ru-central1-b, | 2 | 8.0 GB | | | ru-central1-c | | | | ... | +-----------+--------------------------------+-------+----------+
-
Укажите нужный класс в команде изменения кластера:
yc managed-mongodb cluster update <имя кластера> --mongod-resource-preset <ID класса>
Managed Service for MongoDB запустит операцию изменения класса хостов для кластера.
-
Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.
О том, как создать такой файл, см. в разделе Создание MongoDB-кластера.
-
Измените в описании кластера Managed Service for MongoDB значение параметра
resource_preset_id
в блокеresources
:resource "yandex_mdb_mongodb_cluster" "<имя кластера>" { ... resources { resource_preset_id = "<класс хостов MongoDB>" ... } }
-
Проверьте корректность настроек.
-
В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
-
Выполните команду:
terraform validate
Если в файлах конфигурации есть ошибки, Terraform на них укажет.
-
-
Подтвердите изменение ресурсов.
-
Выполните команду для просмотра планируемых изменений:
terraform plan
Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
-
Если вас устраивают планируемые изменения, внесите их:
-
Выполните команду:
terraform apply
-
Подтвердите изменение ресурсов.
-
Дождитесь завершения операции.
-
-
Подробнее см. в документации провайдера Terraform.
Увеличить размер хранилища
Убедитесь, что:
- Нужный кластер не использует хранилище на нереплицируемых SSD-дисках. Увеличить размер хранилища на нереплицируемых SSD-дисках невозможно.
- В облаке хватает квоты на увеличение хранилища. Откройте страницу Квоты для вашего облака и проверьте, что в секции Managed Databases не исчерпано место в строке Объем HDD-хранилищ или Объем SSD-хранилищ.
Чтобы увеличить размер хранилища для кластера:
- Перейдите на страницу каталога и выберите сервис Managed Service for MongoDB.
- Выберите кластер и нажмите кнопку Изменить кластер на панели сверху.
- В разделе Размер хранилища укажите необходимое значение.
- Нажмите кнопку Сохранить изменения.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы увеличить размер хранилища для кластера:
-
Посмотрите описание команды CLI для изменения кластера:
yc managed-mongodb cluster update --help
-
Укажите нужный объем хранилища в команде изменения кластера. Новый объем должен быть не меньше, чем текущее значение
disk_size
в свойствах кластера.yc managed-mongodb cluster update <имя или идентификатор кластера> \ --mongod-disk-size <размер хранилища в гигабайтах>
Если все условия выполнены, Managed Service for MongoDB запустит операцию по увеличению объема хранилища.
Чтобы увеличить размер хранилища для кластера:
-
Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.
О том, как создать такой файл, см. в разделе Создание MongoDB-кластера.
-
Измените в описании кластера Managed Service for MongoDB значение параметра
disk_size
в блокеresources
:resource "yandex_mdb_mongodb_cluster" "<имя кластера>" { ... resources { disk_size = <размер хранилища в гигабайтах> ... } }
-
Проверьте корректность настроек.
-
В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
-
Выполните команду:
terraform validate
Если в файлах конфигурации есть ошибки, Terraform на них укажет.
-
-
Подтвердите изменение ресурсов.
-
Выполните команду для просмотра планируемых изменений:
terraform plan
Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
-
Если вас устраивают планируемые изменения, внесите их:
-
Выполните команду:
terraform apply
-
Подтвердите изменение ресурсов.
-
Дождитесь завершения операции.
-
-
Подробнее см. в документации провайдера Terraform.
Чтобы увеличить размер хранилища для кластера, воспользуйтесь методом API update и передайте в запросе нужные значения в параметре configSpec.mongodbSpec_4_2.mongod.resources.diskSize
.
Изменить настройки MongoDB
Вы можете изменить настройки СУБД для хостов вашего кластера.
Примечание
Некоторые настройки MongoDB зависят от выбранного класса хостов.
- Перейдите на страницу каталога и выберите сервис Managed Service for MongoDB.
- Выберите кластер и нажмите кнопку Изменить кластер на панели сверху.
- Чтобы изменить настройки MongoDB, нажмите кнопку Настроить в блоке Настройки СУБД.
- Нажмите кнопку Сохранить изменения.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы изменить настройки MongoDB для кластера, используйте команду:
yc managed-mongodb cluster update-config
Например, для установки значения параметра net.maxIncomingConnections в 4096
, выполните следующую команду:
yc managed-mongodb cluster update-config <имя кластера>
--set net.max_incoming_connections=4096
Managed Service for MongoDB запустит операцию изменения настроек СУБД для кластера. Если изменяемая настройка применяется только с перезапуском СУБД, то Managed Service for MongoDB последовательно перезапустит СУБД на всех хостах кластера.
Воспользуйтесь методом API update и передайте в запросе нужные значения в параметре configSpec.mongodbSpec_4_2.mongod.config
.
Все поддерживаемые настройки описаны в справочнике API.
Изменить дополнительные настройки кластера
-
Перейдите на страницу каталога и выберите сервис Managed Service for MongoDB.
-
Выберите кластер и нажмите кнопку Изменить кластер на панели сверху.
-
Измените дополнительные настройки кластера:
-
Начало резервного копирования (UTC)
Время по UTC (в 24-часовом формате), когда начинается резервное копирование кластера. Если время не задано, резервное копирование начнется в 22:00 UTC.
-
Срок хранения автоматических резервных копий, дней
Время, в течение которого нужно хранить созданные автоматически резервные копии. Если для такой копии истекает срок хранения, то она удаляется. Значение по умолчанию — 7 дней. Эта функциональность находится на стадии Preview. Подробнее см. в разделе Резервные копии.
Изменение срока хранения затрагивает как новые автоматические резервные копии, так и уже существующие. Например, если изначальный срок хранения был 7 дней и оставшееся время жизни отдельной автоматической резервной копии при таком сроке — 1 день, то при увеличении срока хранения до 9 дней, оставшееся время жизни этой резервной копии будет уже 3 дня.
Для существующего кластера автоматически созданные копии хранятся заданное количество дней, а созданные вручную — бессрочно. После удаления кластера все копии хранятся 7 дней.
-
Окно обслуживания — настройки времени технического обслуживания:
- Чтобы разрешить проведение технического обслуживания в любое время, выберите пункт произвольное (по умолчанию).
- Чтобы указать предпочтительное время начала обслуживания, выберите пункт по расписанию и укажите нужные день недели и час дня по UTC. Например, можно выбрать время, когда кластер наименее загружен.
Операции по техническому обслуживанию проводятся для включенных и выключенных кластеров. Они могут включать в себя: обновление версии СУБД, применение патчей и так далее.
-
Сбор статистики — включите эту опцию, чтобы воспользоваться инструментом Диагностика производительности в кластере. Эта функциональность находится на стадии Preview.
-
Защита от удаления — управляет защитой кластера от непреднамеренного удаления пользователем.
Включенная защита от удаления кластера не помешает подключиться вручную и удалить содержимое базы данных.
-
-
Нажмите кнопку Сохранить изменения.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы изменить дополнительные настройки кластера:
-
Посмотрите описание команды CLI для изменения кластера:
yc managed-mongodb cluster update --help
-
Выполните команду, передав список настроек, которые хотите изменить:
yc managed-mongodb cluster update <идентификатор или имя кластера> \ --backup-retain-period-days=<срок хранения> \ --backup-window-start <время начала резервного копирования> \ --maintenance-window type=<тип технического обслуживания: anytime или weekly>,` `day=<день недели для типа weekly>,` `hour=<час дня для типа weekly>
Вы можете изменить следующие настройки:
-
--backup-retain-period
— срок хранения автоматических резервных копий (в днях).Значение параметра
<срок хранения>
задается в диапазоне от 7 до 35 (по умолчанию — 7). Эта функциональность находится на стадии Preview. Подробнее см. в разделе Резервные копии.Изменение срока хранения затрагивает как новые автоматические резервные копии, так и уже существующие.
Например, если изначальный срок хранения был 7 дней и оставшееся время жизни отдельной автоматической резервной копии при таком сроке — 1 день, то при увеличении срока хранения до 9 дней, оставшееся время жизни этой резервной копии будет уже 3 дня.
--backup-window-start
— время начала резервного копирования кластера, задается по UTC в форматеHH:MM:SS
. Если время не задано, резервное копирование начнется в 22:00 UTC.
-
--maintenance-window
— настройки времени технического обслуживания (в т. ч. для выключенных кластеров):type
— тип технического обслуживания:anytime
— в любое время.weekly
— по расписанию.
day
— день недели для типаweekly
в форматеDDD
. Например,MON
.hour
— час дня по UTC для типаweekly
в форматеHH
. Например,21
.
-
--deletion-protection
— защита кластера от непреднамеренного удаления пользователем.Включенная защита от удаления кластера не помешает подключиться вручную и удалить содержимое базы данных.
Идентификатор и имя кластера можно получить со списком кластеров в каталоге.
-
Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.
О том, как создать такой файл, см. в разделе Создание MongoDB-кластера.
-
Чтобы изменить время начала резервного копирования, добавьте к описанию кластера Managed Service for MongoDB блок
backup_window_start
в секцииcluster_config
:resource "yandex_mdb_mongodb_cluster" "<имя кластера>" { ... cluster_config { backup_window_start { hours = <Час начала резервного копирования> minutes = <Минута начала резервного копирования> } ... } ... }
-
Чтобы разрешить доступ из сервиса Yandex DataLens, добавьте к описанию кластера Managed Service for MongoDB блок
access
в секцииcluster_config
:resource "yandex_mdb_mongodb_cluster" "<имя кластера>" { ... cluster_config { ... access { data_lens = <Доступ из DataLens: true или false> } ... }
-
Чтобы настроить время технического обслуживания (в т. ч. для выключенных кластеров), добавьте к описанию кластера блок
maintenance_window
:resource "yandex_mdb_mongodb_cluster" "<имя кластера>" { ... maintenance_window { type = <тип технического обслуживания: ANYTIME или WEEKLY> day = <день недели для типа WEEKLY> hour = <час дня для типа WEEKLY> } ... }
Где:
type
— тип технического обслуживания:ANYTIME
— в любое время.WEEKLY
— по расписанию.
day
— день недели для типаWEEKLY
в форматеDDD
. Например,MON
.hour
— час дня по UTC для типаWEEKLY
в форматеHH
. Например,21
.
-
Чтобы включить защиту кластера от непреднамеренного удаления пользователем вашего облака, добавьте к описанию кластера поле
deletion_protection
со значениемtrue
:resource "yandex_mdb_mongodb_cluster" "<имя кластера>" { ... deletion_protection = <защита от удаления кластера: true или false> }
Включенная защита от удаления кластера не помешает подключиться вручную и удалить содержимое базы данных.
-
Проверьте корректность настроек.
-
В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
-
Выполните команду:
terraform validate
Если в файлах конфигурации есть ошибки, Terraform на них укажет.
-
-
Подтвердите изменение ресурсов.
-
Выполните команду для просмотра планируемых изменений:
terraform plan
Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
-
Если вас устраивают планируемые изменения, внесите их:
-
Выполните команду:
terraform apply
-
Подтвердите изменение ресурсов.
-
Дождитесь завершения операции.
-
-
Подробнее см. в документации провайдера Terraform.
Воспользуйтесь методом API update и передайте в запросе:
-
Идентификатор кластера в параметре
clusterId
. -
Новое время начала резервного копирования в параметре
configSpec.backupWindowStart
. -
Настройки доступа из других сервисов в параметре
configSpec.access
. -
Настройки времени технического обслуживания (в т. ч. для выключенных кластеров) в параметре
maintenanceWindow
. -
Настройки защиты от удаления кластера в параметре
deletionProtection
.Включенная защита от удаления кластера не помешает подключиться вручную и удалить содержимое базы данных.
-
Список полей конфигурации кластера, подлежащих изменению, в параметре
updateMask
.
Идентификатор кластера можно получить со списком кластеров в каталоге.
Важно
Этот метод API сбросит все настройки кластера, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, обязательно передайте название полей, подлежащих изменению, в параметре updateMask
.
Изменить группы безопасности
- Перейдите на страницу каталога и выберите сервис Managed Service for MongoDB.
- Выберите кластер и нажмите кнопку Изменить кластер на панели сверху.
- В блоке Сетевые настройки выберите группы безопасности для сетевого трафика кластера.
- Нажмите кнопку Сохранить изменения.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы изменить список групп безопасности для кластера:
-
Посмотрите описание команды CLI для изменения кластера:
yc managed-mongodb cluster update --help
-
Укажите нужные группы безопасности в команде изменения кластера:
yc managed-mongodb cluster update <идентификатор или имя кластера> \ --security-group-ids <список групп безопасности>
-
Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.
О том, как создать такой файл, см. в разделе Создание MongoDB-кластера.
-
Измените в описании кластера Managed Service for MongoDB значение параметра
security_group_ids
:resource "yandex_mdb_mongodb_cluster" "<имя кластера>" { ... security_group_ids = [ <Список идентификаторов групп безопасности> ] ... }
-
Проверьте корректность настроек.
-
В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
-
Выполните команду:
terraform validate
Если в файлах конфигурации есть ошибки, Terraform на них укажет.
-
-
Подтвердите изменение ресурсов.
-
Выполните команду для просмотра планируемых изменений:
terraform plan
Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
-
Если вас устраивают планируемые изменения, внесите их:
-
Выполните команду:
terraform apply
-
Подтвердите изменение ресурсов.
-
Дождитесь завершения операции.
-
-
Подробнее см. в документации провайдера Terraform.
Воспользуйтесь методом API update и передайте в запросе:
- Идентификатор кластера в параметре
clusterId
. Чтобы узнать идентификатор, получите список кластеров в каталоге. - Список групп в параметре
securityGroupIds
. - Список настроек, которые необходимо изменить, в параметре
updateMask
. Если не задать этот параметр, метод API сбросит на значения по умолчанию все настройки кластера, которые не были явно указаны в запросе.
Важно
Может потребоваться дополнительная настройка групп безопасности для подключения к кластеру.