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

В веб-консоли выберите нужный проект.

В списке сервисов выберите Managed Kubernetes и нажмите кнопку Создать.

(опционально) Измените автоматически сгенерированное имя кластера. Позже это имя (name) и созданный из него идентификатор (ID) нельзя изменить, меняется только отображаемое имя (display name) кластера.

Выберите тип кластера.

Выберите релизный канал.

(опционально) В блоке Расписание сервисного окна выберите, когда кластер будет проходить техническое обслуживание:

• в любое время;
• в выбранные дни и время.

Выберите версию Kubernetes для кластера.

(опционально) Введите описание кластера.

Нажмите кнопку Далее.

Задайте сетевые настройки кластера:

1. Выберите сеть для размещения кластера или создайте новую.

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

3. Выберите основной эндпоинт — тип внутреннего IP-адреса для кластера:

   • Временный — эндпоинт будет выбран автоматически из диапазона подсети.
   • Зарезервированный — если IP-адрес еще не зарезервирован, зарезервируйте его.

4. Выберите публичный эндпоинт — тип внешнего IP-адреса для кластера:

   • Без адреса — управление кластером через интернет будет недоступно.

   • Зарезервированный — если внешний IP-адрес еще не зарезервирован, зарезервируйте его.

     Важно

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

Если у вас нет утилиты 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> \
5
  --network-primary-endpoint-spec-subnet projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети> \
6
  --version-control-release-channel <релизный канал — например, stable> \
7
  --version-control-version <версия Kubernetes — например, v1.31.13-mws.1> \
8
  --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.

Проверьте конфигурационный файл на наличие синтаксических ошибок:

1
terraform validate

Если ошибок нет, вы получите следующее сообщение:

1
Success! The configuration is valid.

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

1
terraform plan

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

Примените конфигурацию:

1
terraform apply

Подтвердите выполнение операций: введите слово yes и нажмите Enter.

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

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

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

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

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
      "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-объектом>'

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