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

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

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

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

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

   $ yc managed-postgresql cluster update --help
   

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

   $ yc managed-postgresql resource-preset list
   
   +-----------+--------------------------------+-------+----------+
   |    ID     |            ZONE IDS            | CORES |  MEMORY  |
   +-----------+--------------------------------+-------+----------+
   | s1.micro  | ru-central1-a, ru-central1-b,  |     2 | 8.0 GB   |
   |           | ru-central1-c                  |       |          |
   | ...                                                           |
   +-----------+--------------------------------+-------+----------+
   

3. Укажите нужный класс в команде изменения кластера:

   $ yc managed-postgresql cluster update <имя кластера>
        --resource-preset <ID класса>
   

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

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

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

2. Измените в описании кластера Managed Service for PostgreSQL значение атрибута resource_preset_id в блоке config.resources:

   resource "yandex_mdb_postgresql_cluster" "<имя кластера>" {
     ...
     config {
       resources {
         resource_preset_id = "<класс хоста>"
         ...
       }
     }
   }
   

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

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

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

      terraform plan
      

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

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

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

      terraform apply
      

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

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

Воспользуйтесь методом API update и передайте в запросе нужное значение в параметре configSpec.resources.resourcePresetId.

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

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

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

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

1. Проверьте, что нужный кластер использует стандартное или быстрое сетевое хранилище (увеличить размер локального или нереплицируемого сетевого хранилища невозможно). Для этого запросите информацию о кластере и найдите поле disk_type_id — его значение должно быть network-hdd или network-ssd:

   $ yc managed-postgresql cluster get <имя кластера>
   
   id: c7qkvr3u78qiopj3u4k2
   folder_id: b1g0ftj57rrjk9thribv
   ...
   config:
     ...
     resources:
       resource_preset_id: s1.micro
       disk_size: "10737418240"
       disk_type_id: network-ssd
   ...
   

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

   $ yc managed-postgresql cluster update --help
   

3. Проверьте, что в облаке хватает квоты на увеличение хранилища: откройте страницу Квоты для вашего облака и проверьте, что в секции Yandex Managed Service for PostgreSQL не исчерпано место в строке space.

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

   $ yc managed-postgresql cluster update <имя кластера>
        --disk-size <объем хранилища, ГБ>
   

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

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

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

2. Измените в описании кластера Managed Service for PostgreSQL значение атрибута disk_size в блоке config.resources:

   resource "yandex_mdb_postgresql_cluster" "<имя кластера>" {
     ...
     config {
       resources {
         disk_size = <объем хранилища, ГБ>
         ...
       }
     }
   }
   

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

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

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

      terraform plan
      

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

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

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

      terraform apply
      

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

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

Воспользуйтесь методом API update и передайте в запросе нужные значения в параметре configSpec.postgresqlConfig_<версия>.resources.diskSize.

Проверьте, что в облаке хватает квоты на увеличение хранилища: откройте страницу Квоты для вашего облака и проверьте, что в секции Yandex Managed Service for PostgreSQL не исчерпано место в строке space.

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

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

Чтобы изменить настройки сервера PostgreSQL:

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

   $ yc managed-postgresql cluster get <имя кластера> --full
   

2. Посмотрите описание команды CLI для изменения конфигурации кластера:

   $ yc managed-postgresql cluster update-config --help
   

3. Установите нужные значения параметров:

   $ yc managed-postgresql cluster update-config <имя кластера>
        --set <имя параметра1>=<значение1>,...
   

   Managed Service for PostgreSQL запустит операцию по изменению настроек кластера.

   Все поддерживаемые параметры перечислены в описании настроек PostgreSQL.

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

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

2. Измените в описании кластера Managed Service for PostgreSQL значения параметров в блоке config.postgresql_config. Если такого блока нет — создайте его.

   resource "yandex_mdb_postgresql_cluster" "<имя кластера>" {
     ...
     config {
       ...
       postgresql_config = {
         max_connections                   = <макс.число соединений>
         enable_parallel_hash              = <true или false>
         vacuum_cleanup_index_scale_factor = <число от 0 до 1>
         ...
       }
     }
   }
   

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

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

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

      terraform plan
      

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

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

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

      terraform apply
      

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

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

Воспользуйтесь методом API update и передайте в запросе нужные значения в параметре configSpec.postgresqlConfig_<версия>.config.

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

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

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

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

   yc managed-postgresql cluster update --help
   

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

   yc managed-postgresql cluster update <имя кластера> \
       --backup-window-start <время начала резервного копирования> \
       --datalens-access=<true или false> \
       --maintenance-window type=<weekly или anytime> \
       --websql-access=<true или false> \
       --deletion-protection=<защита от удаления кластера: true или fasle>
   

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

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

• --datalens-access — разрешает доступ из DataLens. Значение по умолчанию — false. Подробнее о настройке подключения см. в разделе Подключение к DataLens.

• --maintenance-window — настройки времени технического обслуживания:
  • type=anytime — техническое обслуживание может проводиться в любое время.
  • type=weekly — техническое обслуживание должно выполняться по расписанию. Укажите через запятую в параметрах day и hour день и час начала технического обслуживания, например: type=weekly,day=wed,hour=14.
    По умолчанию установлено значение anytime.

• --websql-access — разрешает выполнять SQL запросы из консоли управления. Значение по умолчанию — false.

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

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

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

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

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

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

   resource "yandex_mdb_postgresql_cluster" "<имя кластера>" {
     ...
     config {
       backup_window_start {
         hours   = <Час начала резервного копирования>
         minutes = <Минута начала резервного копирования>
       }
       ...
     }
   }
   

3. Чтобы разрешить доступ из Yandex DataLens и выполнение SQL-запросов из консоли управления, измените значения соответствующих полей в блоке config.access:

   resource "yandex_mdb_postgresql_cluster" "<имя кластера>" {
     ...
     config {
       access {
         data_lens = <Доступ из DataLens: true или false>
         web_sql   = <Выполнение SQL-запросов из консоли управления: true или false>
         ...
     }
     ...
   }
   

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

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

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

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

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

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

      terraform plan
      

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

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

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

      terraform apply
      

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

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

Воспользуйтесь методом API update и передайте в запросе:

• Идентификатор кластера в параметре clusterId.

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

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

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

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

• Список полей конфигурации кластера, подлежащих изменению, в параметре updateMask.

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

Для изменения режима работы менеджера соединений:

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

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

2. Укажите нужный режим работы в блоке config.pooler_config.

   resource "yandex_mdb_postgresql_cluster" "<имя кластера>" {
     ...
     config {
       pooler_config {
         pool_discard = <параметр Odissey pool_discard: true или false>
         pooling_mode = "<режим работы: SESSION или TRANSACTION>"
       }
       ...
     }
   }
   

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

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

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

      terraform plan
      

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

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

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

      terraform apply
      

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

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

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

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

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

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

$ yc managed-postgresql cluster start-failover <имя кластера> --host <имя хоста-реплики>

Имя хоста-реплики можно запросить со списком хостов в кластере, имя кластера — со списком кластеров в каталоге.

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

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

2. Укажите имя хоста-реплики, на которую нужно переключиться, в параметре host_master_name.

   resource "yandex_mdb_postgresql_cluster" "<имя кластера>" {
       ...
       host_master_name = "<имя хоста-реплики: атрибут name соответствующего блока host>"
     }
   }
   

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

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

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

      terraform plan
      

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

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

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

      terraform apply
      

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

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

Воспользуйтесь методом API startFailover и передайте в запросе:

1. Идентификатор кластера, в котором нужно переключить мастер, в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
2. Имя хоста-реплики, на которую нужно переключиться, в параметре hostName. Чтобы узнать имя, получите список хостов в кластере.

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

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

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

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

   $ yc managed-postgresql cluster update --help
   

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

   $ yc managed-postgresql cluster update <имя кластера>
        --security-group-ids <список групп безопасности>
   

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

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

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

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

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

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

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

      terraform plan
      

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

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

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

      terraform apply
      

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

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

Воспользуйтесь методом API update и передайте в запросе:

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