Изменение настроек кластера MongoDB

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы изменить класс хостов для кластера:

1. Посмотрите описание команды CLI для изменения кластера:

   yc managed-mongodb cluster update --help
   

2. Запросите список доступных классов хостов (в колонке ZONE IDS указаны зоны доступности, в которых можно выбрать соответствующий класс):

   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-d                  |       |          |
   | ...                                                           |
   +-----------+--------------------------------+-------+----------+
   

3. Укажите нужный класс в команде изменения кластера. При смене класса учитывайте роль хоста, она зависит от типа шардирования. В одной команде можно использовать параметры для хостов с разными ролями.

   • Для хостов MONGOD:

     yc managed-mongodb cluster update <имя_или_идентификатор_кластера> \
        --mongod-resource-preset <ID_класса>
     

   • Для хостов MONGOINFRA:

     yc managed-mongodb cluster update <имя_или_идентификатор_кластера> \
        --mongoinfra-resource-preset <ID_класса>
     

   • Для хостов MONGOS:

     yc managed-mongodb cluster update <имя_или_идентификатор_кластера> \
        --mongos-resource-preset <ID_класса>
     

   • Для хостов MONGOCFG:

     yc managed-mongodb cluster update <имя_или_идентификатор_кластера> \
        --mongocfg-resource-preset <ID_класса>
     

   Managed Service for MongoDB запустит операцию изменения класса хостов для кластера.

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

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

2. Измените в описании кластера Managed Service for MongoDB значение параметра resource_preset_id для ресурсов resources_mongod, resources_mongoinfra, resources_mongos или resources_mongocfg. Тип ресурса зависит от типа шардирования.

   Пример:

   resource "yandex_mdb_mongodb_cluster" "<имя_кластера>" {
     ...
     resources_mongod {
         resource_preset_id = "<класс_хостов>"
         ...
     }
   }
   

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

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

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

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

• Класс хоста в параметре configSpec.mongodbSpec_<версия_MongoDB>.mongod.resources.resourcePresetId.

  Чтобы получить список поддерживаемых значений, воспользуйтесь методом list для ресурсов ResourcePreset.

• Список настроек, которые необходимо изменить, в параметре updateMask.

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы увеличить размер хранилища для кластера:

1. Посмотрите описание команды CLI для изменения кластера:

   yc managed-mongodb cluster update --help
   

2. Укажите нужный размер хранилища в команде изменения кластера. Новый размер должен быть не меньше, чем текущее значение disk_size в свойствах кластера.

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

   • Для хостов MONGOD:

     yc managed-mongodb cluster update <имя_или_идентификатор_кластера> \
        --mongod-disk-size <размер_хранилища_ГБ>
     

   • Для хостов MONGOINFRA:

     yc managed-mongodb cluster update <имя_или_идентификатор_кластера> \
        --mongoinfra-disk-size <размер_хранилища_ГБ>
     

   • Для хостов MONGOS:

     yc managed-mongodb cluster update <имя_или_идентификатор_кластера> \
        --mongos-disk-size <размер_хранилища_ГБ>
     

   • Для хостов MONGOCFG:

     yc managed-mongodb cluster update <имя_или_идентификатор_кластера> \
        --mongocfg-disk-size <размер_хранилища_ГБ>
     

   Если все условия выполнены, Managed Service for MongoDB запустит операцию по увеличению размера хранилища.

Чтобы увеличить размер хранилища для кластера:

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

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

2. Измените в описании кластера Managed Service for MongoDB значение параметра disk_size для ресурсов resources_mongod, resources_mongoinfra, resources_mongos или resources_mongocfg. Тип ресурса зависит от типа шардирования.

   Пример:

   resource "yandex_mdb_mongodb_cluster" "<имя_кластера>" {
     ...
     resources_mongod {
       disk_size = <размер_хранилища_ГБ>
       ...
     }
   }
   

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

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

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

• Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
• Новый размер хранилища в параметре configSpec.mongodbSpec_<версия_MongoDB>.mongod.resources.diskSize.
• Список настроек, которые необходимо изменить, в параметре updateMask.

Если у вас еще нет интерфейса командной строки 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 последовательно перезапустит СУБД на всех хостах кластера.

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

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

• Нужные значения настроек MongoDB в параметре configSpec.mongodbSpec_<версия_MongoDB>.mongod.config.

  Все поддерживаемые настройки описаны в справочнике API и в разделе Настройки MongoDB.

• Список настроек кластера, которые необходимо изменить, в параметре updateMask.

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы изменить дополнительные настройки кластера:

1. Посмотрите описание команды CLI для изменения кластера:

   yc managed-mongodb cluster update --help
   

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

   yc managed-mongodb cluster update <идентификатор_или_имя_кластера> \
     --backup-retain-period-days=<срок_хранения> \
     --backup-window-start <время_начала_резервного_копирования> \
     --maintenance-window type=<тип_технического_обслуживания>,`
                          `day=<день_недели>,`
                          `hour=<час_дня> \
     --performance-diagnostics=<включить_диагностику> \
     --deletion-protection
   

Вы можете изменить следующие настройки:

• --backup-retain-period — срок хранения автоматических резервных копий (в днях).

  Значение параметра <срок_хранения> задается в диапазоне от 7 до 35 (по умолчанию — 7). Эта функциональность находится на стадии Preview. Подробнее см. в разделе Резервные копии.

  Изменение срока хранения затрагивает как новые автоматические резервные копии, так и уже существующие.

  Например, если изначальный срок хранения был семь дней и оставшееся время жизни отдельной автоматической резервной копии при таком сроке — один день, то при увеличении срока хранения до девяти дней оставшееся время жизни этой резервной копии будет уже три дня.

• --backup-window-start — время начала резервного копирования кластера, задается по UTC в формате HH:MM:SS. Если время не задано, резервное копирование начнется в 22:00 UTC.

• --maintenance-window — настройки времени технического обслуживания (в т. ч. для выключенных кластеров), где type — тип технического обслуживания:

  • anytime (по умолчанию) — в любое время.
  • weekly — по расписанию. При задании этого значения укажите день недели и час дня:
    • day — день недели в формате DDD: MON, TUE, WED, THU, FRI, SAT или SUN.
    • hour — час дня по UTC в формате HH: от 1 до 24.

• --performance-diagnostics — укажите параметр, чтобы воспользоваться инструментом Диагностика производительности в кластере. Эта функциональность находится на стадии Preview.

• --deletion-protection — защита кластера, его баз данных и пользователей от непреднамеренного удаления.

  Включенная защита от удаления не помешает подключиться вручную и удалить содержимое базы данных.

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

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

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

2. Чтобы изменить время начала резервного копирования, добавьте к описанию кластера Managed Service for MongoDB блок backup_window_start в секции cluster_config:

   resource "yandex_mdb_mongodb_cluster" "<имя_кластера>" {
     ...
     cluster_config {
       backup_window_start {
         hours   = <час>
         minutes = <минута>
       }
       ...
     }
     ...
   }
   

   Где hours и minutes — час и минута начала резервного копирования.

3. Чтобы разрешить доступ из сервиса Yandex DataLens, добавьте к описанию кластера Managed Service for MongoDB блок access в секции cluster_config:

   resource "yandex_mdb_mongodb_cluster" "<имя_кластера>" {
     ...
     cluster_config {
       ...
       access {
         data_lens = <доступ_из_DataLens>
       }
     ...
   }
   

   Где data_lens — доступ из DataLens: true или false.

4. Чтобы настроить время технического обслуживания (в т. ч. для выключенных кластеров), добавьте к описанию кластера блок maintenance_window:

   resource "yandex_mdb_mongodb_cluster" "<имя_кластера>" {
     ...
     maintenance_window {
       type = <тип_технического_обслуживания>
       day  = <день_недели>
       hour = <час_дня>
     }
     ...
   }
   

   Где:

   • type — тип технического обслуживания. Принимает значения:
     • ANYTIME — в любое время.
     • WEEKLY — по расписанию.
   • day — день недели для типа WEEKLY в формате DDD. Например, MON.
   • hour — час дня по UTC для типа WEEKLY в формате HH. Например, 21.

5. Чтобы включить защиту кластера от непреднамеренного удаления пользователем вашего облака, добавьте к описанию кластера поле deletion_protection со значением true:

   resource "yandex_mdb_mongodb_cluster" "<имя_кластера>" {
     ...
     deletion_protection = <защита_от_удаления>
   }
   

   Где deletion_protection — защита от удаления кластера: true или false.

   Включенная защита от удаления не помешает подключиться вручную и удалить содержимое базы данных.

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

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

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

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

• Новое время начала резервного копирования в параметре configSpec.backupWindowStart.

• Настройки доступа из других сервисов в параметре configSpec.access.

• Настройки времени технического обслуживания (в т. ч. для выключенных кластеров) в параметре maintenanceWindow.

• Разрешение на сбор статистики для диагностики производительности кластера в параметре performanceDiagnostics.profilingEnabled.

• Настройки защиты от удаления кластера в параметре deletionProtection.

  Включенная защита от удаления не помешает подключиться вручную и удалить содержимое базы данных.

• Список изменяемых полей конфигурации кластера в параметре updateMask.

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы переместить кластер:

1. Посмотрите описание команды CLI для перемещения кластера:

   yc managed-mongodb cluster move --help
   

2. Укажите каталог назначения в команде перемещения кластера:

   yc managed-mongodb cluster move <имя_или_идентификатор_кластера> \
      --destination-folder-name=<имя_каталога_назначения>
   

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

Чтобы переместить кластер, воспользуйтесь методом REST API move для ресурса Cluster или вызовом gRPC API ClusterService/Move и передайте в запросе:

• Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
• Идентификатор каталога назначения в параметре destinationFolderId.

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы изменить список групп безопасности для кластера:

1. Посмотрите описание команды CLI для изменения кластера:

   yc managed-mongodb cluster update --help
   

2. Укажите нужные группы безопасности в команде изменения кластера:

   yc managed-mongodb cluster update <имя_или_идентификатор_кластера> \
     --security-group-ids <список_идентификаторов_групп_безопасности>
   

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

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

2. Измените в описании кластера Managed Service for MongoDB значение параметра security_group_ids:

   resource "yandex_mdb_mongodb_cluster" "<имя_кластера>" {
     ...
     security_group_ids = [ <список_идентификаторов_групп_безопасности> ]
     ...
   }
   

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

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

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

• Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
• Список идентификаторов групп безопасности в параметре securityGroupIds.
• Список изменяемых полей конфигурации кластера в параметре updateMask.