Создание кластера Greenplum®

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

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

Чтобы создать кластер Managed Service for Greenplum®:

1. Проверьте, есть ли в каталоге подсети для хостов кластера:

   yc vpc subnet list
   

   Если ни одной подсети в каталоге нет, создайте нужные подсети в сервисе VPC.

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

   yc managed-greenplum cluster create --help
   

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

   yc managed-greenplum cluster create <имя_кластера> \
      --greenplum-version=<версия_Greenplum> \
      --environment=<окружение> \
      --network-name=<имя_сети> \
      --user-name=<имя_пользователя> \
      --user-password=<пароль_пользователя> \
      --master-config resource-id=<класс_хоста>,`
                     `disk-size=<объем_хранилища_ГБ>,`
                     `disk-type=<network-hdd|network-ssd|network-ssd-nonreplicated|local-ssd> \
      --segment-config resource-id=<класс_хоста>,`
                     `disk-size=<объем_хранилища_ГБ>,`
                     `disk-type=<network-ssd-nonreplicated|local-ssd> \
      --zone-id=<зона_доступности> \
      --subnet-id=<идентификатор_подсети> \
      --assign-public-ip=<публичный_доступ_к_хостам> \
      --security-group-ids=<список_идентификаторов_групп_безопасности> \
      --deletion-protection
   

   Примечание

   Имя кластера должно быть уникальным в каталоге. Оно может содержать латинские буквы, цифры, дефис и подчеркивание. Максимальная длина имени 63 символа.

   Где:

   • --greenplum-version — версия Greenplum®: 6.22 или 6.25.

   • --environment — окружение:

     • PRODUCTION — для стабильных версий ваших приложений.
     • PRESTABLE — для тестирования. Prestable-окружение аналогично Production-окружению и на него также распространяется SLA, но при этом на нем раньше появляются новые функциональные возможности, улучшения и исправления ошибок. В Prestable-окружении вы можете протестировать совместимость новых версий с вашим приложением.

   • --network-name — имя сети.

   • --user-name — имя пользователя. Может содержать латинские буквы, цифры, дефис и подчеркивание, но должно начинаться с буквы, цифры или подчеркивания. Длина от 1 до 32 символов.

   • --user-password — пароль. Длина от 8 до 128 символов.

   • --master-config и --segment-config — конфигурация хостов-мастеров и хостов-сегментов:

     • resource-id — класс хоста.
     • disk-size — объем хранилища в гигабайтах.
     • disk-type — тип диска:
       • network-hdd (только для хостов-мастеров);
       • network-ssd (только для хостов-мастеров);
       • local-ssd;
       • network-ssd-nonreplicated.

   • --zone-id — зона доступности.

   • --subnet-id — идентификатор подсети. Необходимо указывать, если в выбранной зоне доступности создано 2 и больше подсетей.

   • --assign-public-ip — флаг, который указывается, если для хостов нужен публичный доступ: true или false.

   • --security-group-ids — список идентификаторов групп безопасности.

   • --deletion-protection — защита от удаления кластера.

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

4. Чтобы задать время начала резервного копирования, передайте нужное значение в формате HH:MM:SS в параметре --backup-window-start:

   yc managed-greenplum cluster create <имя_кластера> \
      ...
      --backup-window-start=<время_начала_резервного_копирования>
   

5. Чтобы создать кластер, размещенный на группах выделенных хостов, укажите через запятую их идентификаторы в параметре --host-group-ids:

   yc managed-greenplum cluster create <имя_кластера> \
      ...
      --host-group-ids=<идентификаторы_групп_выделенных_хостов>
   

   Внимание

   Эту настройку нельзя изменить после создания кластера. Использование выделенных хостов существенно влияет на тарификацию кластера.

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

   yc managed-greenplum cluster create <имя_кластера> \
      ...
      --maintenance-window type=<тип_технического_обслуживания>,`
                          `day=<день_недели>,`
                          `hour=<час_дня> \
   

   Где type — тип технического обслуживания:

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

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

   yc managed-greenplum cluster create <имя_кластера> \
      ...
      --datalens-access=<доступ_из_DataLens> \
      --yandexquery-access=<доступ_из_Yandex_Query>
   

   Доступные сервисы:

   • --datalens-access — Yandex DataLens;
   • --yandexquery-access — Yandex Query.

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

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

Чтобы создать кластер Managed Service for Greenplum®:

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

2. Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

3. Создайте конфигурационный файл с описанием облачной сети и подсетей.

   Кластер размещается в облачной сети. Если подходящая сеть у вас уже есть, описывать ее повторно не нужно.

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

   Пример структуры конфигурационного файла, в котором описывается облачная сеть с одной подсетью:

   resource "yandex_vpc_network" "<имя_сети_в_Terraform>" { name = "<имя_сети>" }
   resource "yandex_vpc_subnet" "<имя_подсети_в_Terraform>" {
     name           = "<имя_подсети>"
     zone           = "<зона_доступности>"
     network_id     = yandex_vpc_network.<имя_сети_в_Terraform>.id
     v4_cidr_blocks = ["<подсеть>"]
   }
   

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

   Пример структуры конфигурационного файла:

   resource "yandex_mdb_greenplum_cluster" "<имя_кластера_в_Terraform>" {
     name                = "<имя_кластера>"
     environment         = "<окружение>"
     network_id          = yandex_vpc_network.<имя_сети_в_Terraform>.id
     zone                = "<зона_доступности>"
     subnet_id           = yandex_vpc_subnet.<имя_подсети_в_Terraform>.id
     assign_public_ip    = <публичный_доступ_к_хостам_кластера>
     deletion_protection = <защита_от_удаления_кластера>
     version             = "<версия_Greenplum>"
     master_host_count   = <количество_хостов_мастеров>
     segment_host_count  = <количество_хостов_сегментов>
     segment_in_host     = <количество_сегментов_на_хост>
     master_subcluster {
       resources {
         resource_preset_id = "<класс_хоста>"
         disk_size          = <объем_хранилища_ГБ>
         disk_type_id       = "<тип_диска>"
       }
     }
     segment_subcluster {
       resources {
         resource_preset_id = "<класс_хоста>"
         disk_size          = <объем_хранилища_ГБ>
         disk_type_id       = "<тип_диска>"
       }
     }
   
     access {
       data_lens    = <доступ_из_DataLens>
       yandex_query = <доступ_из_Yandex_Query>
     }
   
     user_name     = "<имя_пользователя>"
     user_password = "<пароль>"
   
     security_group_ids = ["<список_идентификаторов_групп_безопасности>"]
   }
   

   Где:

   • assign_public_ip — публичный доступ к хостам кластера: true или false.

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

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

   • version — версия Greenplum®.

   • master_host_count — количество хостов-мастеров: 1 или 2.

   • segment_host_count — количество хостов-сегментов: от 2 до 32.

   • segment_in_host — количество сегментов на хост. Максимальное значение этого параметра зависит от класса хостов.

   • access.data_lens — доступ к кластеру из сервиса Yandex DataLens: true или false.

   • access.yandex_query — доступ к кластеру из сервиса Yandex Query: true или false.

   Более подробную информацию о ресурсах, которые вы можете создать с помощью Terraform, см. в документации провайдера.

5. Проверьте корректность файлов конфигурации Terraform:

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

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

      terraform validate
      

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

6. Создайте кластер:

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

Чтобы создать кластер Managed Service for Greenplum®, воспользуйтесь методом REST API create для ресурса Cluster или вызовом gRPC API ClusterService/Create и передайте в запросе:

• Идентификатор каталога, в котором должен быть размещен кластер, в параметре folderId.

• Имя кластера в параметре name.

• Окружение кластера в параметре environment.

• Версию Greenplum® в параметре config.version.

• Имя пользователя в параметре userName.

• Пароль пользователя в параметре userPassword.

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

• Идентификаторы групп безопасности в параметре securityGroupIds.

• Конфигурацию хостов-мастеров в параметре masterConfig.

• Конфигурацию хостов-сегментов в параметре segmentConfig.

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

• Публичный доступ в параметре assignPublicIp.

• Окно резервного копирования в параметре config.backupWindowStart.

• Доступ к кластеру из сервиса Yandex DataLens в параметре config.access.dataLens.

• Доступ к кластеру из сервиса Yandex Query в параметре config.access.yandexQuery.

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

• Настройки СУБД в параметре configSpec.greenplumConfig_<версия>.

• Регламентные операции технического обслуживания в параметре configSpec.backgroundActivities.analyzeAndVacuum.

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

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