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

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

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

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed Kubernetes и нажмите кнопку Создать.
(опционально) Измените автоматически сгенерированное имя кластера. Позже это имя (name) и созданный из него идентификатор (ID) нельзя изменить, меняется только отображаемое имя (display name) кластера.
Выберите тип кластера: Standalobe или High Availability.
Выберите зону доступности.
Выберите релизный канал.
Выберите минимальную версию Kubernetes для кластера.
(опционально) В блоке Расписание сервисного окна выберите, когда кластер будет проходить техническое обслуживание:
- в любое время;
- в выбранные дни и время.
(опционально) Введите описание кластера.
Нажмите кнопку Далее.
Задайте сетевые настройки кластера:
1. Выберите сеть для размещения кластера или создайте новую.
2. Выберите подсеть для размещения кластера или создайте новую.
3. Выберите основной эндпоинт — тип внутреннего IP-адреса для кластера:
  - Временный — эндпоинт будет выбран автоматически из диапазона подсети.
  - Зарезервированный — если IP-адрес еще не зарезервирован, зарезервируйте его.
4. Выберите публичный эндпоинт — тип внешнего IP-адреса для кластера:
  - Временный — эндпоинт будет выбран автоматически из диапазона подсети.
  - Зарезервированный — если внешний IP-адрес еще не зарезервирован, зарезервируйте его.
  - Без адреса — управление кластером через интернет будет недоступно.
  Важно
  За использование внешнего IP-адреса взимается плата в соответствии с правилами тарификации.
Укажите подсеть, из диапазона которой будут выделяться IP-адреса для подов. Например, 10.22.0.0/18.
Укажите подсеть, из диапазона которой будут выделяться IP-адреса для сервисов. Например, 10.22.64.0/18.
Нажмите кнопку Далее.
Проверьте заданные настройки и при необходимости измените их.
Нажмите кнопку Создать.

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

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

1
mws mk8s cluster create <имя кластера> \
2
  --network-pods-cidr <CIDR подсети для подов — например, 10.22.0.0/18> \
3
  --network-services-cidr <CIDR подсети для сервисов — например, 10.22.64.0/18> \
4
  --availability-standalone-zone <зона доступности — ru-central1-a или ru-central1-b> \  # Для создания standalone-кластера
5
  --availability-zonal-ha-zone <зона доступности — ru-central1-a или ru-central1-b> \  # Для создания high-availability-кластера
6
  --network-primary-endpoint-spec-subnet projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети> \
7
  --version-control-release-channel <релизный канал — например, stable> \
8
  --version-control-version <минимальная версия Kubernetes — например, v1.34.1-mws.3> \
9
  --network-public-endpoint-ref projects/<имя проекта>/externalAddresses/<имя внешнего IP-адреса>  # (опционально) Публичный IP-адрес кластера

За использование внешнего IP-адреса взимается плата в соответствии с правилами тарификации.

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

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

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

1
resource "mws_mk8s_cluster" "<имя кластера>" {
2
  availability = {
3
    # standalone = {
4
    #   zone = "ru-central1-a"
5
    # }
6
    zonal_ha = { // zonal high available
7
      zone = "ru-central1-b"
8
    }
9
  }
10

11
  cluster_name = "<имя кластера>"
12

13
  metadata = {
14
    description  = "<описание кластера>"
15
    display_name = "<отображаемое имя кластера>"
16
  }
17

18
  network = {
19
    pods_cidr     = "<CIDR подсети для подов — например, 10.22.0.0/18>"
20
    services_cidr = "<CIDR подсети для сервисов — например, 10.22.64.0/18>
21
    primary_endpoint = {
22
      ref = <ID IP-адреса внутреннего эндпоинта>
23
    }
24
    public_endpoint = {
25
      ref = <ID IP-адреса публичного эндпоинта>
26
    }
27
  }
28

29
  version_control = {
30
    release_channel = "<релизный канал — например, stable>"
31
    maintenance_window = {
32
      weekly = {
33
        days = [<дни недели — например, "MONDAY", "WEDNESDAY">]
34
        hour = <время начала сервисного окна — от 0 до 23>
35
      }
36
    }
37
    version = "<минимальная версия Kubernetes – например, v1.34.1-mws.1>"
38
  }
39
}

Здесь:

секция availability — уровень доступности кластера:
- standalone — в одной зоне без резервирования;
- zonal_ha — с зональной высокой доступностью;
cluster_name — имя кластера;
секция metadata — метаданные кластера:
- description — описание кластера;
- display_name — отображаемое имя кластера;
секция network — настройки сети:
- pods_cidr — диапазон IP-адресов для подов в CIDR-нотации;
- services_addr — диапазон IP-адресов для сервисов в CIDR-нотации;
- primary_endpoint — внутренний IP-адрес для доступа к API кластера;
- public_endpoint — внешний IP-адрес для доступа к API кластера.
секция version_control — настройки управления версиями и обслуживанием:
- release_channel — релизный канал;
- maintainance_window — параметры сервисного окна: периодичность и время начала;
- version — минимальная версия Kubernetes.

Проверьте конфигурационный файл на наличие синтаксических ошибок:
bash
```
1
terraform validate
```
Если ошибок нет, вы получите следующее сообщение:
bash
```
1
Success! The configuration is valid.
```
Выполните команду:
bash
```
1
terraform plan
```
Terraform проверит конфигурационные файлы, сопоставит описание желаемого состояния облачной инфраструктуры с фактическим и укажет, какие операции с ресурсами будут выполнены.
Примените конфигурацию:
bash
```
1
terraform apply
```
Подтвердите выполнение операций: введите слово yes и нажмите Enter.

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

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

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

1
{
2
  "metadata": {
3
    "name": "<имя кластера>"
4
  },
5
  "spec": {
6
    "availability": {
7
      "standalone": { // Или "zonalHA" для создания high-availability-кластера
8
         "zone": "<зона доступности — ru-central1-a или ru-central1-b>"
9
      }
10
    },
11
    "network": {
12
      "primaryEndpoint": {
13
        "spec": {
14
          "subnet": "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
15
        }
16
      },
17
      "podsCidr": "<CIDR подсети для подов — например, 10.22.0.0/18>",
18
      "servicesCidr": "<CIDR подсети для сервисов — например, 10.22.64.0/18>"
19
    },
20
    "versionControl": {
21
      "releaseChannel": "<релизный канал — например, stable>",
22
      "version": "<минимальная версия Kubernetes — например, v1.31.13-mws.1>"
23
    }
24
  }
25
}

(опционально) Чтобы управлять кластером через интернет, добавьте в характеристики кластера параметр publicEndpoint. За использование внешнего IP-адреса взимается плата в соответствии с правилами тарификации.

1
{
2
  "metadata": {
3
    "name": "<имя кластера>"
4
  },
5
  "spec": {
6
    "availability": {
7
      "standalone": {
8
         "zone": "<зона доступности — ru-central1-a или ru-central1-b>"
9
      }
10
    },
11
    "network": {
12
      "primaryEndpoint": {
13
        "spec": {
14
          "subnet": "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
15
        }
16
      },
17
      "publicEndpoint": {
18
        "ref": "projects/<имя проекта>/externalAddresses/<имя внешнего IP-адреса>"
19
      },
20
      "podsCidr": "<CIDR подсети для подов — например, 10.22.0.0/18>",
21
      "servicesCidr": "<CIDR подсети для сервисов — например, 10.22.64.0/18>"
22
    },
23
    "versionControl": {
24
      "releaseChannel": "<релизный канал — например, stable>",
25
      "version": "<минимальная версия Kubernetes — например, v1.31.13-mws.1>"
26
    }
27
  }
28
}

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

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

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