Создание группы узлов

Чтобы разместить в кластере Managed Kubernetes рабочую нагрузку, создайте группу узлов. Вы можете создать:

Группу узлов на основе виртуальных машин Compute — с оптимальным балансом цены и производительности для широкого круга задач: сайтов и приложений со средней нагрузкой, сред разработки и тестирования.
Группу узлов с GPU — для инференса и дообучения моделей среднего и крупного размера, компьютерного зрения, распознавания речи и рекомендательных систем.

Создать группу узлов на основе ВМ Compute

Веб-консоль
MWS CLI
Terraform
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed Kubernetes. Откроется список кластеров.
Нажмите на значок ... для кластера, в котором нужно создать группу узлов, и выберите Добавить группу узлов.
(опционально) Измените автоматически сгенерированное имя группы узлов. Позже это имя (name) и созданный из него идентификатор (ID) нельзя изменить, меняется только отображаемое имя (display name) группы узлов.
Выберите зону доступности для размещения группы узлов.
Выберите подсеть для размещения группы узлов или создайте новую подсеть.
В блоке Сервисное окно настройте расписание, по которому группы узлов будут проходить техническое обслуживание.
(опционально) Введите описание группы узлов.
Нажмите кнопку Далее.
Настройте ресурсы:
1. Выберите тип виртуальных машин для узлов.
2. (опционально) Укажите размер хранилища для контейнеров.
3. (опционально) Укажите значение IOPS.
(опционально) Настройте автоматическое масштабирование:
1. Включите автомасштабирование.
2. Настройте стратегию обновления:
  1. Укажите maxSurge — максимальный шаг изменения числа узлов в группе.
  2. Укажите maxUnavailable — максимальное число недоступных узлов при изменении числа узлов в группе.
Выберите сервисный аккаунт, который будет привязан к группе узлов, или создайте новый.

Важно
Для работы группы узлов сервисному аккаунту достаточно роли registry.puller. Подробнее о том, как обезопасить работу группы узлов.
(опционально) Добавьте метки (labels).
(опционально) Добавьте ограничения (taints).
Нажмите кнопку Далее.
Проверьте заданные настройки и при необходимости измените их.
Нажмите кнопку Создать.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
При необходимости создайте новую подсеть, где будет размещена группа узлов.
Определите тип виртуальных машин для узлов.

Например, тип gen-2-4 соответствует ВМ с 2 vCPU и 4 ГБ оперативной памяти.
При необходимости создайте сервисный аккаунт, который будет использоваться для работы группы узлов.

Важно
Для работы группы узлов сервисному аккаунту достаточно роли registry.puller. Подробнее о том, как обезопасить работу группы узлов.
Узнайте имя кластера:
bash
```
1
mws mk8s cluster list
```

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

1
mws mk8s node-group create <имя группы узлов> \
2
  --cluster-name <имя кластера> \
3
  --zone <зона доступности — ru-central1-a или ru-central1-b> \
4
  --subnet-ref projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети> \
5
  --vm-type-ref compute/vmTypes/<тип ВМ — например, gen-2-4> \
6
  --image-storage-size <размер хранилища для контейнеров — например, 10Gb> \
7
  --scale-fixed <число узлов> \
8
  --version-control-version <минимальная версия Kubernetes — например, v1.31.13-mws.1> \
9
  --version-control-maintenance-window-weekly-days <день недели — например, MONDAY> \
10
  --version-control-maintenance-window-weekly-hour <время начала сервисного окна — от 0 до 23> \
11
  --rollout-strategy-max-surge <максимальный шаг изменения числа узлов в группе> \
12
  --rollout-strategy-max-unavailable <максимальное число недоступных узлов при изменении числа узлов в группе> \
13
  --service-account-ref <имя сервисного аккаунта с ролью registry.puller>

Чтобы создать группу узлов с автоматическим масштабированием, воспользуйтесь инструкцией.

Если команда была успешно выполнена, вы получите ответ с параметрами созданной группы узлов.

Если у вас не установлен Terraform, установите его.
Убедитесь, что у вас есть кластер, где будет размещена группа узлов. Если у вас нет кластера, создайте его.
Определите тип виртуальных машин для узлов.

Например, тип gen-2-4 соответствует ВМ с 2 vCPU и 4 ГБ оперативной памяти.
Опишите в конфигурационном файле параметры группы узлов, которую необходимо создать:
hcl
```
1
resource "mws_mk8s_node_group" "<имя группы узлов>" {
2
  cluster_name    =  <имя кластера>
3
  node_group_name = "<имя группы узлов>"
4

5
  service_account = {
6
    ref = <ID сервисного аккаунта с ролью registry.puller>
7
  }
8

9
  subnet = {
10
    ref = <ID подсети>
11
  }
12

13
  vm_type = {
14
    ref = "compute/vmTypes/<имя типа ВМ>"
15
  }
16

17
  scale = {
18
    autoscaling = {
19
      min = 5
20
      max = 10
21
    }
22
  }
23

24
  rollout_strategy = {
25
    max_surge       = 1
26
    max_unavailable = 0
27
  }
28

29
  version_control = {
30
    auto_update     = true
31
    version         = "<минимальная версия Kubernetes>"
32
    maintenance_window = {
33
      weekly = {
34
        days     = [<дни недели — например, "MONDAY", "WEDNESDAY">]
35
        hour     = <время начала сервисного окна — от 0 до 23>
36
        duration = "<длительность окна технического обслуживания — например, 4h>"
37
      }
38
    }
39
  }
40

41
  image_storage_size = "<размер хранилища в гигабайтах>"
42

43
  labels = [
44
    { key = "<ключ 1>", value = "<значение 1>" },
45
    { key = "<ключ 2>", value = "<значение 2>" }
46
  ]
47

48
  taints = []
49

50
  zone = "ru-central1-a"
51
}
```
Здесь:
- cluster_name — имя кластера, где будет создана группа узлов;
- node_group_name — имя группы узлов;
- service_account — сервисный аккаунт, который будет использоваться для управления группой узлов;
  
  Важно
  Для работы группы узлов сервисному аккаунту достаточно роли registry.puller. Подробнее о том, как обезопасить работу группы узлов.
- vm-type — тип виртуальной машины для узлов;
- секция scale — настройки масштабирования группы узлов:
  - min — минимальное количество узлов;
  - max — возможное максимальное количество узлов (ограничение при масштабировании);
- секция rollout strategy — стратегия обновления узлов:
  - max_surge— максимальный шаг при изменении числа узлов в группе;
  - max_unavailable — максимальное число недоступных узлов при изменении числа узлов в группе;
- секция version_control — настройки управления версиями и обслуживанием:
  - maintenance_window — параметры сервисного окна: периодичность, время начала, продолжительность;
  - version — минимальная версия Kubernetes;
- image_storage_size — размер хранилища для контейнеров в гигабайтах;
- секция labels — метки для узлов;
- секция taints — ограничения для узлов (определяют, какие поды могут работать на этих узлах);
- zone — зона доступности: ru-central1-a или ru-central1-b
Проверьте конфигурационный файл на наличие синтаксических ошибок:
bash
```
1
terraform validate
```
Если ошибок нет, вы получите следующее сообщение:
bash
```
1
Success! The configuration is valid.
```
Выполните команду:
bash
```
1
terraform plan
```
Terraform проверит конфигурационные файлы, сопоставит описание желаемого состояния облачной инфраструктуры с фактическим и укажет, какие операции с ресурсами будут выполнены.
Примените конфигурацию:
bash
```
1
terraform apply
```
Подтвердите выполнение операций: введите слово yes и нажмите Enter.

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

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.
Убедитесь, что у вас есть сеть и подсеть, где будет размещен кластер. Если сети и подсети нет, создайте их.
Определите тип виртуальных машин для узлов.

Например, тип gen-2-4 соответствует ВМ с 2 vCPU и 4 ГБ оперативной памяти.

Опишите характеристики группы узлов в виде JSON-объекта и сохраните его в отдельном файле. Обязательные параметры:

1
{
2
  "metadata": {
3
    "name": "<имя группы узлов>"
4
  },
5
  "spec": {
6
    "zone": "<зона доступности — ru-central1-a или ru-central1-b>",
7
    "subnet": {
8
      "ref": "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
9
    },
10
    "vmType": {
11
      "ref": "compute/vmTypes/<тип ВМ — например, gen-2-4>"
12
    },
13
    "imageStorageSize": "<размер хранилища для контейнеров — например, 10Gb>",
14
    "scale": {
15
      "fixed": <число узлов>
16
    },
17
    "versionControl": {
18
      "version": "<минимальная версия Kubernetes — например, v1.31.13-mws.1>",
19
      "maintenanceWindow": {
20
        "weekly": {
21
          "days": ["<день недели — например, MONDAY>"],
22
          "hour": <время начала сервисного окна — от 0 до 23>
23
        }
24
      }
25
    },
26
    "rolloutStrategy": {
27
      "maxSurge": <максимальный шаг изменения числа узлов в группе>,
28
      "maxUnavailable": <максимальное число недоступных узлов при изменении числа узлов в группе>
29
    },
30
    "serviceAccount": {
31
      "ref": "projects/<имя проекта>/serviceAccounts/<имя сервисного аккаунта с ролью registry.puller>"
32
    }
33
  }
34
}

Чтобы создать группу узлов с автоматическим масштабированием, воспользуйтесь инструкцией.

Узнайте имя кластера:

1
curl -X GET https://mk8s.mwsapis.ru/mk8s/v1/projects/<имя проекта>/clusters \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:

1
curl -X POST https://mk8s.mwsapis.ru/mk8s/v1/projects/<имя проекта>/clusters/<имя кластера>/nodeGroups/<имя группы узлов> \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '@<путь к файлу с JSON-объектом>'

Если запрос был успешно принят, вы получите ответ с параметрами созданной группы узлов.

Создать группу узлов с GPU

Веб-консоль
MWS CLI
Terraform
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed Kubernetes. Откроется список кластеров.
Нажмите на значок ... для кластера, в котором нужно создать группу узлов, и выберите Добавить группу узлов.
(опционально) Измените автоматически сгенерированное имя группы узлов. Позже это имя (name) и созданный из него идентификатор (ID) нельзя изменить, меняется только отображаемое имя (display name) группы узлов.
Выберите зону доступности ru-central1-a — узлы с GPU доступны к развертыванию только в этой зоне.
Выберите подсеть для размещения группы узлов или создайте новую подсеть.
В блоке Сервисное окно настройте расписание, по которому группы узлов будут проходить техническое обслуживание.
(опционально) Введите описание группы узлов.
Нажмите кнопку Далее.
Включите опцию Графический процессор (GPU).
Выберите тип виртуальных машин для узлов.
(опционально) Укажите размер хранилища для контейнеров.
(опционально) Укажите значение IOPS.
(опционально) Настройте автоматическое масштабирование:
1. Включите автомасштабирование.
2. Настройте стратегию обновления:
  1. Укажите maxSurge — максимальный шаг изменения числа узлов в группе.
  2. Укажите maxUnavailable — максимальное число недоступных узлов при изменении числа узлов в группе.
Выберите сервисный аккаунт, который будет привязан к группе узлов, или создайте новый.

Важно
Для работы группы узлов сервисному аккаунту достаточно роли registry.puller. Подробнее о том, как обезопасить работу группы узлов.
(опционально) Добавьте метки (labels).
(опционально) Добавьте ограничения (taints).
Нажмите кнопку Далее.
Проверьте заданные настройки и при необходимости измените их.
Нажмите кнопку Создать.
Когда создание группы узлов будет завершено, установите GPU Operator — стандартный инструмент для управления узлами с GPU в кластере Kubernetes. Без этого инструмента кластер не сможет использовать GPU для рабочих нагрузок.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
При необходимости создайте новую подсеть, где будет размещена группа узлов.
Выберите тип виртуальных машин для узлов.
При необходимости создайте сервисный аккаунт, который будет использоваться для работы группы узлов.

Важно
Для работы группы узлов сервисному аккаунту достаточно роли registry.puller. Подробнее о том, как обезопасить работу группы узлов.
Узнайте имя кластера:
bash
```
1
mws mk8s cluster list
```

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

1
mws mk8s node-group create <имя группы узлов> \
2
  --cluster-name <имя кластера> \
3
  --zone ru-central1-a \
4
  --subnet-ref projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети> \
5
  --vm-type-ref compute/vmTypes/<имя типа ВМ с GPU>
6
  --image-storage-size <размер хранилища для контейнеров — например, 10Gb> \
7
  --scale-fixed <число узлов> \
8
  --version-control-version <минимальная версия Kubernetes — например, v1.31.13-mws.1> \
9
  --version-control-maintenance-window-weekly-days <день недели — например, MONDAY> \
10
  --version-control-maintenance-window-weekly-hour <время начала сервисного окна — от 0 до 23> \
11
  --rollout-strategy-max-surge <максимальный шаг изменения числа узлов в группе> \
12
  --rollout-strategy-max-unavailable <максимальное число недоступных узлов при изменении числа узлов в группе> \
13
  --service-account-ref <имя сервисного аккаунта с ролью registry.puller>

Чтобы создать группу узлов с автоматическим масштабированием, воспользуйтесь инструкцией.

Если команда была успешно выполнена, вы получите ответ с параметрами созданной группы узлов.

Установите GPU Operator — стандартный инструмент для управления узлами с GPU в кластере Kubernetes. Без этого инструмента кластер не сможет использовать GPU для рабочих нагрузок.

Если у вас не установлен Terraform, установите его.
Убедитесь, что у вас есть кластер, где будет размещена группа узлов. Если у вас нет кластера, создайте его.
Выберите тип виртуальных машин для узлов.
Опишите в конфигурационном файле параметры группы узлов, которую необходимо создать:
hcl
```
1
resource "mws_mk8s_node_group" "<имя группы узлов>" {
2
  cluster_name    =  <имя кластера>
3
  node_group_name = "<имя группы узлов>"
4

5
  service_account = {
6
    ref = <ID сервисного аккаунта с ролью registry.puller>
7
  }
8

9
  subnet = {
10
    ref = <ID подсети>
11
  }
12

13
  vm_type = {
14
    ref = "compute/vmTypes/<имя типа ВМ с GPU>"
15
  }
16

17
  scale = {
18
    autoscaling = {
19
      min = 5
20
      max = 10
21
    }
22
  }
23

24
  rollout_strategy = {
25
    max_surge       = 1
26
    max_unavailable = 0
27
  }
28

29
  version_control = {
30
    auto_update     = true
31
    version         = "<минимальная версия Kubernetes>"
32
    maintenance_window = {
33
      weekly = {
34
        days     = [<дни недели — например, "MONDAY", "WEDNESDAY">]
35
        hour     = <время начала сервисного окна — от 0 до 23>
36
        duration = "<длительность окна технического обслуживания — например, 4h>"
37
      }
38
    }
39
  }
40

41
  image_storage_size = "<размер хранилища в гигабайтах>"
42

43
  labels = [
44
    { key = "<ключ 1>", value = "<значение 1>" },
45
    { key = "<ключ 2>", value = "<значение 2>" }
46
  ]
47

48
  taints = []
49

50
  zone = "ru-central1-a"
51
}
```
Здесь:
- cluster_name — имя кластера, где будет создана группа узлов;
- node_group_name — имя группы узлов;
- service_account — сервисный аккаунт, который будет использоваться для управления группой узлов;
  
  Важно
  Для работы группы узлов сервисному аккаунту достаточно роли registry.puller. Подробнее о том, как обезопасить работу группы узлов.
- vm-type — тип виртуальной машины для узлов с GPU;
- секция scale — настройки масштабирования группы узлов:
  - min — минимальное количество узлов;
  - max — возможное максимальное количество узлов (ограничение при масштабировании);
- секция rollout strategy — стратегия обновления узлов:
  - max_surge— максимальный шаг при изменении числа узлов в группе;
  - max_unavailable — максимальное число недоступных узлов при изменении числа узлов в группе;
- секция version_control — настройки управления версиями и обслуживанием:
  - maintenance_window — параметры сервисного окна: периодичность, время начала, продолжительность;
  - version — минимальная версия Kubernetes;
- image_storage_size — размер хранилища для контейнеров в гигабайтах;
- секция labels — метки для узлов;
- секция taints — ограничения для узлов (определяют, какие поды могут работать на этих узлах);
- zone — зона доступности: ru-central1-a.
Проверьте конфигурационный файл на наличие синтаксических ошибок:
bash
```
1
terraform validate
```
Если ошибок нет, вы получите следующее сообщение:
bash
```
1
Success! The configuration is valid.
```
Выполните команду:
bash
```
1
terraform plan
```
Terraform проверит конфигурационные файлы, сопоставит описание желаемого состояния облачной инфраструктуры с фактическим и укажет, какие операции с ресурсами будут выполнены.
Примените конфигурацию:
bash
```
1
terraform apply
```
Подтвердите выполнение операций: введите слово yes и нажмите Enter.

Во время создания ресурсов Terraform будет выводить краткие сообщения о выполняемых операциях. Проверить, что ресурсы созданы и настроены корректно, можно в веб-консоли.
Установите GPU Operator — стандартный инструмент для управления узлами с GPU в кластере Kubernetes. Без этого инструмента кластер не сможет использовать GPU для рабочих нагрузок.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.
Убедитесь, что у вас есть сеть и подсеть, где будет размещен кластер. Если сети и подсети нет, создайте их.
Выберите тип виртуальных машин для узлов.

1
{
2
  "metadata": {
3
    "name": "<имя группы узлов>"
4
  },
5
  "spec": {
6
    "zone": "ru-central1-a",
7
    "subnet": {
8
      "ref": "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
9
    },
10
    "vmType": {
11
      "ref": "compute/vmTypes/<тип ВМ с GPU>"
12
    },
13
    "imageStorageSize": "<размер хранилища для контейнеров — например, 10Gb>",
14
    "scale": {
15
      "fixed": <число узлов>
16
    },
17
    "versionControl": {
18
      "version": "<минимальная версия Kubernetes — например, v1.31.13-mws.1>",
19
      "maintenanceWindow": {
20
        "weekly": {
21
          "days": ["<день недели — например, MONDAY>"],
22
          "hour": <время начала сервисного окна — от 0 до 23>
23
        }
24
      }
25
    },
26
    "rolloutStrategy": {
27
      "maxSurge": <максимальный шаг изменения числа узлов в группе>,
28
      "maxUnavailable": <максимальное число недоступных узлов при изменении числа узлов в группе>
29
    },
30
    "serviceAccount": {
31
      "ref": "projects/<имя проекта>/serviceAccounts/<имя сервисного аккаунта с ролью registry.puller>"
32
    }
33
  }
34
}

Чтобы создать группу узлов с автоматическим масштабированием, воспользуйтесь инструкцией.

Узнайте имя кластера:

1
curl -X GET https://mk8s.mwsapis.ru/mk8s/v1/projects/<имя проекта>/clusters \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:

1
curl -X POST https://mk8s.mwsapis.ru/mk8s/v1/projects/<имя проекта>/clusters/<имя кластера>/nodeGroups/<имя группы узлов> \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '@<путь к файлу с JSON-объектом>'

Если запрос был успешно принят, вы получите ответ с параметрами созданной группы узлов.

Установите GPU Operator — стандартный инструмент для управления узлами с GPU в кластере Kubernetes. Без этого инструмента кластер не сможет использовать GPU для рабочих нагрузок.