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

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

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

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

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

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

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

   • Кластер YTsaurus — описание кластера.

   • Сеть — описание облачной сети, в которой будет расположен кластер. Если подходящая сеть у вас уже есть, описывать ее повторно не нужно.

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

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

   resource "yandex_ytsaurus_cluster" "<имя_кластера>" {
   
     description        = "<описание_кластера>"
     name               = "<имя_кластера>"
     zone_id            = yandex_vpc_subnet.<имя_подсети>.zone
     subnet_id          = yandex_vpc_subnet.<имя_подсети>.id
     security_group_ids = [<список_идентификаторов_групп_безопасности>]
   
     spec = {
       storage = {
         hdd = {
           size_gb = 2048
           count   = 3
         }
         ssd = {
           size_gb = 465
           type    = "network-ssd-nonreplicated"
           count   = 3
         }
       }
       compute = [
         {
           preset = "c8-m32"
           disks = [
             {
               size_gb   = 93
               type      = "network-ssd-nonreplicated"
             }
           ]
           scale_policy = {
             fixed = {
               size = 3
             }
           }
         }
       ]
       tablet = {
         preset = "c8-m16"
         count  = 3
       }
       proxy = {
         http = {
           count = 2
         }
         rpc = {
           count = 2
         }
       }
     }
   }
   
   resource "yandex_vpc_network" "<имя_сети>" { name = "<имя_сети>" }
   
   resource "yandex_vpc_subnet" "<имя_подсети>" {
     name           = "<имя_подсети>"
     zone           = "<зона_доступности>"
     network_id     = yandex_vpc_network.<имя_сети>.id
     v4_cidr_blocks = ["<диапазон>"]
   }
   

   Где:

   • description — описание кластера.

   • name — имя кластера.

   • zone_id — зона доступности.

   • subnet_id — идентификатор подсети.

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

     Важно

     Сетевые настройки нельзя изменить после создания кластера.

   • spec — конфигурация компонентов кластера YTsaurus:

     • storage — параметры хранилища:

       • hdd — параметры HDD-дисков:

         • size_gb — размер диска в ГБ.
         • count — количество дисков.

       • ssd — параметры SSD-дисков:

         • size_gb — размер диска в ГБ.
         • type — тип диска.
         • count — количество дисков.

       Важно

       Тип и размер диска для кластера YTsaurus нельзя изменить после создания.

     • compute — конфигурация exec-нод:

       • preset — конфигурация вычислительных ресурсов.

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

         • size_gb — размер диска в ГБ.
         • type — тип диска.

       • scale_policy.fixed.size — количество exec-нод для фиксированной политики масштабирования.

     • tablet — конфигурация tablet-нод:

       • preset — конфигурация вычислительных ресурсов.
       • count — количество tablet-нод.

       Для использования tablet-нод должны быть указаны параметры SSD-хранилища (spec.storage.ssd).

       Важно

       Количество tablet-нод нельзя изменить после создания кластера.

     • proxy — параметры прокси:

       • http.count — количество HTTP-прокси.
       • rpc.count — количество RPC-прокси.

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

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

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

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

      terraform validate
      

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

3. Создайте кластер YTsaurus.

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

   export IAM_TOKEN="<IAM-токен>"
   

2. Создайте файл body.json и добавьте в него следующее содержимое:

   {
     "folderId": "<идентификатор_каталога>",
     "name": "<имя_кластера>",
     "description": "<описание_кластера>",
     "zoneId": "<зона_доступности>",
     "subnetId": "<идентификатор_подсети>",
     "securityGroupIds": [ <список_идентификаторов_групп_безопасности> ],
     "spec": {
       "storage": {
         "hdd": {
           "sizeGb": "2048",
           "count": "3"
         },
         "ssd": {
           "sizeGb": "465",
           "type": "network-ssd-nonreplicated",
           "count": "3"
         }
       },
       "compute": [
         {
           "preset": "c8-m32",
           "disks": [
             {
               "type": "network-ssd-nonreplicated",
               "sizeGb": "93"
             }
           ],
           "scalePolicy": {
             "fixed": {
               "size": "3"
             }
           }
         }
       ],
       "tablet": {
         "preset": "c8-m16",
         "count": "3"
       },
       "proxy": {
         "http": {
           "count": "2"
         },
         "rpc": {
           "count": "2"
         }
       }
     }
   }
   

   Где:

   • folderId — идентификатор каталога. Его можно запросить со списком каталогов в облаке.

   • name — имя кластера.

   • description — описание кластера.

   • zoneId — зона доступности.

   • subnetId — идентификатор подсети.

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

     Важно

     Сетевые настройки нельзя изменить после создания кластера.

   • spec — конфигурация компонентов кластера YTsaurus:

     • storage — параметры хранилища:

       • hdd — параметры HDD-дисков:

         • sizeGb — размер диска в ГБ.
         • count — количество дисков.

       • ssd — параметры SSD-дисков:

         • sizeGb — размер диска в ГБ.
         • type — тип диска.
         • count — количество дисков.

       Важно

       Тип и размер диска для кластера YTsaurus нельзя изменить после создания.

     • compute — конфигурация exec-нод:

       • preset — конфигурация вычислительных ресурсов.

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

         • type — тип диска.
         • sizeGb — размер диска в ГБ.

       • scalePolicy.fixed.size — количество exec-нод для фиксированной политики масштабирования.

     • tablet — конфигурация tablet-нод:

       • preset — конфигурация вычислительных ресурсов.
       • count — количество tablet-нод.

       Для использования tablet-нод должны быть указаны параметры SSD-хранилища (spec.storage.ssd).

       Важно

       Количество tablet-нод нельзя изменить после создания кластера.

     • proxy — параметры прокси:

       • http.count — количество HTTP-прокси.
       • rpc.count — количество RPC-прокси.

3. Воспользуйтесь методом Cluster.Create и выполните запрос, например с помощью cURL:

   curl \
       --request POST \
       --header "Authorization: Bearer $IAM_TOKEN" \
       --url 'https://ytsaurus.api.cloud.yandex.net/ytsaurus/v1/clusters'
       --data '@body.json'
   

4. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

   export IAM_TOKEN="<IAM-токен>"
   

2. Клонируйте репозиторий cloudapi:

   cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
   

   Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.

3. Создайте файл body.json и добавьте в него следующее содержимое:

   {
     "folder_id": "<идентификатор_каталога>",
     "name": "<имя_кластера>",
     "description": "<описание_кластера>",
     "zone_id": "<зона_доступности>",
     "subnet_id": "<идентификатор_подсети>",
     "security_group_ids": [ <список_идентификаторов_групп_безопасности> ],
     "spec": {
       "storage": {
         "hdd": {
           "size_gb": "2048",
           "count": "3"
         },
         "ssd": {
           "size_gb": "465",
           "type": "network-ssd-nonreplicated",
           "count": "3"
         }
       },
       "compute": [
         {
           "preset": "c8-m32",
           "disks": [
             {
               "type": "network-ssd-nonreplicated",
               "size_gb": "93"
             }
           ],
           "scale_policy": {
             "fixed": {
               "size": "3"
             }
           }
         }
       ],
       "tablet": {
         "preset": "c8-m16",
         "count": "3"
       },
       "proxy": {
         "http": {
           "count": "2"
         },
         "rpc": {
           "count": "2"
         }
       }
     }
   }
   

   Где:

   • folder_id — идентификатор каталога. Его можно запросить со списком каталогов в облаке.

   • name — имя кластера.

   • description — описание кластера.

   • zone_id — зона доступности.

   • subnet_id — идентификатор подсети.

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

     Важно

     Сетевые настройки нельзя изменить после создания кластера.

   • spec — конфигурация компонентов кластера YTsaurus:

     • storage — параметры хранилища:

       • hdd — параметры HDD-дисков:

         • size_gb — размер диска в ГБ.
         • count — количество дисков.

       • ssd — параметры SSD-дисков:

         • size_gb — размер диска в ГБ.
         • type — тип диска.
         • count — количество дисков.

       Важно

       Тип и размер диска для кластера YTsaurus нельзя изменить после создания.

     • compute — конфигурация exec-нод:

       • preset — конфигурация вычислительных ресурсов.

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

         • type — тип диска.
         • size_gb — размер диска в ГБ.

       • scale_policy.fixed.size — количество exec-нод для фиксированной политики масштабирования.

     • tablet — конфигурация tablet-нод:

       • preset — конфигурация вычислительных ресурсов.
       • count — количество tablet-нод.

       Для использования tablet-нод должны быть указаны параметры SSD-хранилища (spec.storage.ssd).

       Важно

       Количество tablet-нод нельзя изменить после создания кластера.

     • proxy — параметры прокси:

       • http.count — количество HTTP-прокси.
       • rpc.count — количество RPC-прокси.

4. Воспользуйтесь вызовом ClusterService.Create и выполните запрос, например с помощью gRPCurl:

   grpcurl \
       -format json \
       -import-path ~/cloudapi/ \
       -import-path ~/cloudapi/third_party/googleapis/ \
       -proto ~/cloudapi/yandex/cloud/ytsaurus/v1/cluster_service.proto \
       -rpc-header "Authorization: Bearer $IAM_TOKEN" \
       -d @ \
       ytsaurus.api.cloud.yandex.net:443 \
       yandex.cloud.ytsaurus.v1.ClusterService.Create \
       < body.json
   

5. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

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

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

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

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

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

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

   • Кластер YTsaurus — описание кластера.

   • Сеть — описание облачной сети, в которой будет расположен кластер. Если подходящая сеть у вас уже есть, описывать ее повторно не нужно.

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

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

   resource "yandex_ytsaurus_cluster" "<имя_кластера>" {
   
     description        = "<описание_кластера>"
     name               = "<имя_кластера>"
     zone_id            = yandex_vpc_subnet.<имя_подсети>.zone
     subnet_id          = yandex_vpc_subnet.<имя_подсети>.id
     security_group_ids = [<список_идентификаторов_групп_безопасности>]
   
     labels = {
       <список_меток>
     }
   
     spec = {
       storage = {
         hdd = {
           size_gb = <размер_диска_в_ГБ>
           count   = <количество_дисков>
         }
         ssd = {
           size_gb = <размер_диска_в_ГБ>
           type    = "<тип_диска>"
           count   = <количество_дисков>
         }
       }
       compute = [
         {
           preset = "<конфигурация_вычислительных_ресурсов>"
           disks = [
             {
               size_gb   = <размер_диска_в_ГБ>
               type      = "<тип_диска>"
             }
           ]
           scale_policy = {
             fixed = {
               size = <количество_exec-нод>
             }
           }
           name = "default"
         }
       ]
       tablet = {
         preset = "<конфигурация_вычислительных_ресурсов>"
         count  = <количество_tablet-нод>
       }
       proxy = {
         http = {
           count = <количество_HTTP-прокси>
         }
         rpc = {
           count = <количество_RPC-прокси>
         }
       },
       odin = {
         checks_ttl = "<частота_проверок>"
       }
     }
   }
   
   resource "yandex_vpc_network" "<имя_сети>" { name = "<имя_сети>" }
   
   resource "yandex_vpc_subnet" "<имя_подсети>" {
     name           = "<имя_подсети>"
     zone           = "<зона_доступности>"
     network_id     = yandex_vpc_network.<имя_сети>.id
     v4_cidr_blocks = ["<диапазон>"]
   }
   

   Где:

   • description — описание кластера.

   • name — имя кластера.

   • zone_id — зона доступности.

   • subnet_id — идентификатор подсети.

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

     Важно

     Сетевые настройки нельзя изменить после создания кластера.

   • labels — список меток. Метки задаются в формате <ключ> = "<значение>".

   • spec — конфигурация компонентов кластера YTsaurus:

     • storage — параметры хранилища:

       • hdd — параметры HDD-дисков:

         • size_gb — размер диска в ГБ.
         • count — количество дисков.

       • ssd — параметры SSD-дисков:

         • size_gb — размер диска в ГБ.
         • type — тип диска: network-ssd или network-ssd-nonreplicated.
         • count — количество дисков.

       От выбранного типа зависит, с каким шагом можно задавать размер диска при создании кластера:

       • Сетевые HDD- и SSD-диски — с шагом 1 ГБ.
       • Нереплицируемые SSD-диски — с шагом 93 ГБ.

       Наличие HDD-диска является обязательным.

       Важно

       Тип и размер диска для кластера YTsaurus нельзя изменить после создания.

     • compute — конфигурация exec-нод:

       • preset — конфигурация вычислительных ресурсов.

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

         • size_gb — размер диска в ГБ.
         • type — тип диска: network-hdd, network-ssd или network-ssd-nonreplicated.

         От выбранного типа зависит, с каким шагом можно задавать размер диска при создании кластера:

         • Сетевые HDD- и SSD-диски — с шагом 1 ГБ.
         • Нереплицируемые SSD-диски — с шагом 93 ГБ.

       • scale_policy.fixed.size — количество exec-нод для фиксированной политики масштабирования.

       • name — имя exec-пула.

     • tablet — конфигурация tablet-нод:

       • preset — конфигурация вычислительных ресурсов.
       • count — количество tablet-нод.

       Для использования tablet-нод должны быть указаны параметры SSD-хранилища (spec.storage.ssd).

       Важно

       Количество tablet-нод нельзя изменить после создания кластера.

     • proxy — параметры прокси:

       • http.count — количество HTTP-прокси.
       • rpc.count — количество RPC-прокси.

     • odin.checks_ttl — частота проверок внутреннего мониторинга Odin. Указывается с единицами измерения: h — часы, m — минуты, s — секунды. Например: 336h0m0s (2 недели).

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

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

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

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

      terraform validate
      

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

3. Создайте кластер Managed Service for YTsaurus.

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

   export IAM_TOKEN="<IAM-токен>"
   

2. Создайте файл body.json и добавьте в него следующее содержимое:

   {
     "folderId": "<идентификатор_каталога>",
     "name": "<имя_кластера>",
     "description": "<описание_кластера>",
     "labels": { <список_меток> },
     "zoneId": "<зона_доступности>",
     "subnetId": "<идентификатор_подсети>",
     "securityGroupIds": [ <список_идентификаторов_групп_безопасности> ],
     "spec": {
       "storage": {
         "hdd": {
           "sizeGb": "<размер_диска_в_ГБ>",
           "count": "<количество_дисков>"
         },
         "ssd": {
           "sizeGb": "<размер_диска_в_ГБ>",
           "type": "<тип_диска>",
           "count": "<количество_дисков>"
         }
       },
       "compute": [
         {
           "preset": "<конфигурация_вычислительных_ресурсов>",
           "disks": [
             {
               "type": "<тип_диска>",
               "sizeGb": "<размер_диска_в_ГБ>"
             }
           ],
           "scalePolicy": {
             "fixed": {
               "size": "<количество_exec-нод>"
             }
           },
           "name": "default"
         }
       ],
       "tablet": {
         "preset": "<конфигурация_вычислительных_ресурсов>",
         "count": "<количество_tablet-нод>"
       },
       "proxy": {
         "http": {
           "count": "<количество_HTTP-прокси>"
         },
         "rpc": {
           "count": "<количество_RPC-прокси>"
         }
       },
       "odin": {
         "checksTtl": "<частота_проверок_в_секундах>"
       }
     }
   }
   

   Где:

   • folderId — идентификатор каталога. Его можно запросить со списком каталогов в облаке.

   • name — имя кластера.

   • description — описание кластера.

   • labels — список меток. Метки задаются в формате "<ключ>": "<значение>".

   • zoneId — зона доступности.

   • subnetId — идентификатор подсети.

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

     Важно

     Сетевые настройки нельзя изменить после создания кластера.

   • spec — конфигурация компонентов кластера YTsaurus:

     • storage — параметры хранилища:

       • hdd — параметры HDD-дисков:

         • sizeGb — размер диска в ГБ.
         • count — количество дисков.

       • ssd — параметры SSD-дисков:

         • sizeGb — размер диска в ГБ.
         • type — тип диска: network-ssd или network-ssd-nonreplicated.
         • count — количество дисков.

       От выбранного типа зависит, с каким шагом можно задавать размер диска при создании кластера:

       • Сетевые HDD- и SSD-диски — с шагом 1 ГБ.
       • Нереплицируемые SSD-диски — с шагом 93 ГБ.

       Наличие HDD-диска является обязательным.

       Важно

       Тип и размер диска для кластера YTsaurus нельзя изменить после создания.

     • compute — конфигурация exec-нод:

       • preset — конфигурация вычислительных ресурсов.

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

         • type — тип диска: network-hdd, network-ssd или network-ssd-nonreplicated.
         • sizeGb — размер диска в ГБ.

         От выбранного типа зависит, с каким шагом можно задавать размер диска при создании кластера:

         • Сетевые HDD- и SSD-диски — с шагом 1 ГБ.
         • Нереплицируемые SSD-диски — с шагом 93 ГБ.

       • scalePolicy.fixed.size — количество exec-нод для фиксированной политики масштабирования.

       • name — имя exec-пула.

     • tablet — конфигурация tablet-нод:

       • preset — конфигурация вычислительных ресурсов.
       • count — количество tablet-нод.

       Для использования tablet-нод должны быть указаны параметры SSD-хранилища (spec.storage.ssd).

       Важно

       Количество tablet-нод нельзя изменить после создания кластера.

     • proxy — параметры прокси:

       • http.count — количество HTTP-прокси.
       • rpc.count — количество RPC-прокси.

     • odin.checksTtl — частота проверок внутреннего мониторинга Odin. Указывается в секундах (s). Например: 1209600s (2 недели).

3. Воспользуйтесь методом Cluster.Create и выполните запрос, например с помощью cURL:

   curl \
       --request POST \
       --header "Authorization: Bearer $IAM_TOKEN" \
       --url 'https://ytsaurus.api.cloud.yandex.net/ytsaurus/v1/clusters' \
       --data '@body.json'
   

4. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

   export IAM_TOKEN="<IAM-токен>"
   

2. Клонируйте репозиторий cloudapi:

   cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
   

   Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.

3. Создайте файл body.json и добавьте в него следующее содержимое:

   {
     "folder_id": "<идентификатор_каталога>",
     "name": "<имя_кластера>",
     "description": "<описание_кластера>",
     "labels": { <список_меток> },
     "zone_id": "<зона_доступности>",
     "subnet_id": "<идентификатор_подсети>",
     "security_group_ids": [ <список_идентификаторов_групп_безопасности> ],
     "spec": {
       "storage": {
         "hdd": {
           "size_gb": "<размер_диска_в_ГБ>",
           "count": "<количество_дисков>"
         },
         "ssd": {
           "size_gb": "<размер_диска_в_ГБ>",
           "type": "<тип_диска>",
           "count": "<количество_дисков>"
         }
       },
       "compute": [
         {
           "preset": "<конфигурация_вычислительных_ресурсов>",
           "disks": [
             {
               "type": "<тип_диска>",
               "size_gb": "<размер_диска_в_ГБ>"
             }
           ],
           "scale_policy": {
             "fixed": {
               "size": "<количество_exec-нод>"
             }
           },
           "name": "default"
         }
       ],
       "tablet": {
         "preset": "<конфигурация_вычислительных_ресурсов>",
         "count": "<количество_tablet-нод>"
       },
       "proxy": {
         "http": {
           "count": "<количество_HTTP-прокси>"
         },
         "rpc": {
           "count": "<количество_RPC-прокси>"
         }
       },
       "odin": {
         "checks_ttl": "<частота_проверок_в_секундах>"
       }
     }
   }
   

   Где:

   • folderId — идентификатор каталога. Его можно запросить со списком каталогов в облаке.

   • name — имя кластера.

   • description — описание кластера.

   • labels — список меток. Метки задаются в формате "<ключ>": "<значение>".

   • zone_id — зона доступности.

   • subnet_id — идентификатор подсети.

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

     Важно

     Сетевые настройки нельзя изменить после создания кластера.

   • spec — конфигурация компонентов кластера YTsaurus:

     • storage — параметры хранилища:

       • hdd — параметры HDD-дисков:

         • size_gb — размер диска в ГБ.
         • count — количество дисков.

       • ssd — параметры SSD-дисков:

         • size_gb — размер диска в ГБ.
         • type — тип диска: network-ssd или network-ssd-nonreplicated.
         • count — количество дисков.

       От выбранного типа зависит, с каким шагом можно задавать размер диска при создании кластера:

       • Сетевые HDD- и SSD-диски — с шагом 1 ГБ.
       • Нереплицируемые SSD-диски — с шагом 93 ГБ.

       Наличие HDD-диска является обязательным.

       Важно

       Тип и размер диска для кластера YTsaurus нельзя изменить после создания.

     • compute — конфигурация exec-нод:

       • preset — конфигурация вычислительных ресурсов.

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

         • type — тип диска: network-hdd, network-ssd или network-ssd-nonreplicated.
         • size_gb — размер диска в ГБ.

         От выбранного типа зависит, с каким шагом можно задавать размер диска при создании кластера:

         • Сетевые HDD- и SSD-диски — с шагом 1 ГБ.
         • Нереплицируемые SSD-диски — с шагом 93 ГБ.

       • scale_policy.fixed.size — количество exec-нод для фиксированной политики масштабирования.

       • name — имя exec-пула.

     • tablet — конфигурация tablet-нод:

       • preset — конфигурация вычислительных ресурсов.
       • count — количество tablet-нод.

       Для использования tablet-нод должны быть указаны параметры SSD-хранилища (spec.storage.ssd).

       Важно

       Количество tablet-нод нельзя изменить после создания кластера.

     • proxy — параметры прокси:

       • http.count — количество HTTP-прокси.
       • rpc.count — количество RPC-прокси.

     • odin.checks_ttl — частота проверок внутреннего мониторинга Odin. Указывается в секундах (s). Например: 1209600s (2 недели).

4. Воспользуйтесь вызовом ClusterService.Create и выполните запрос, например с помощью gRPCurl:

   grpcurl \
       -format json \
       -import-path ~/cloudapi/ \
       -import-path ~/cloudapi/third_party/googleapis/ \
       -proto ~/cloudapi/yandex/cloud/ytsaurus/v1/cluster_service.proto \
       -rpc-header "Authorization: Bearer $IAM_TOKEN" \
       -d @ \
       ytsaurus.api.cloud.yandex.net:443 \
       yandex.cloud.ytsaurus.v1.ClusterService.Create \
       < body.json
   

5. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.