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

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

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

Чтобы создать кластер:

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

   yc vpc subnet list
   

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

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

   yc managed-greenplum cluster create --help
   

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

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

   Примечание

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

   Где:

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

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

     • PRODUCTION — для стабильных версий ваших приложений.
     • PRESTABLE — для тестирования, в том числе самого сервиса Greenplum®. В 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 — флаг, который указывается, если хостам требуется публичный IP-адрес.

   • --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=<тип технического обслуживания: anytime или weekly>,`
                          `day=<день недели для типа weekly>,`
                          `hour=<час дня для типа weekly>
   

   Где:

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

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

   yc managed-greenplum cluster create <имя кластера> \
      ...
      --datalens-access=<доступ из Yandex DataLens: true или false> \
      --datatransfer-access=<доступ из Yandex Data Transfer: true или false>
   

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

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

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

Чтобы создать кластер:

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

2. Если у вас еще нет Terraform, установите его и создайте конфигурационный файл с настройками провайдера.

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    = <получение публичного IP-адреса: true или false>
     deletion_protection = <защита от удаления кластера: true или false>
     version             = "<версия Greenplum®>"
     master_host_count   = <количество хостов-мастеров: 1 или 2>
     segment_host_count  = <количество хостов-сегментов: от 2 до 32>
     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       = "<тип диска>"
       }
     }
   
     user_name     = "<имя пользователя>"
     user_password = "<пароль>"
   
     security_group_ids = ["<список идентификаторов групп безопасности>"]
   }
   

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

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

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

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

• Идентификатор каталога, в котором должен быть размещен кластер, в параметре folderId.
• Имя кластера в параметре name.
• Окружение кластера в параметре environment.
• Версию Greenplum® в параметре config.version.
• Имя пользователя в параметре userName.
• Пароль пользователя в параметре userPassword.
• Идентификатор сети в параметре networkId.
  • Идентификаторы групп безопасности в параметре securityGroupIds.
• Конфигурацию хостов-мастеров в параметре masterConfig.
• Конфигурацию хостов-сегментов в параметре segmentConfig.

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

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

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

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

• Настройки доступа из Yandex Data Transfer в параметре config.access.dataTransfer.

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

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

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

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