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

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

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

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

Выберите тип кластера: Standalone или High Availability.

Выберите зону доступности.

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

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

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

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

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

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

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

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

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

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

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

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

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

   Важно

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

5. Выберите сетевой плагин (CNI) — Calico или Cilium.

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

6. Укажите подсеть, из диапазона которой будут выделяться IP-адреса для подов. Например, 10.22.0.0/18. Минимальный размер подсети — /18, максимальный размер подсети — /8.

7. Укажите подсеть, из диапазона которой будут выделяться IP-адреса для сервисов. Например, 10.22.64.0/18. Минимальный размер подсети — /18, максимальный размер подсети — /12.

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

Проверьте заданные настройки и при необходимости измените их.

Нажмите кнопку Создать.

Если у вас нет утилиты MWS CLI:

1. Установите утилиту.

2. Инициализируйте профиль.

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

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

1
mws mk8s cluster create <имя кластера> \
2
  --network-pods-cidr <CIDR подсети для подов — например, 10.22.0.0/18> \  # Минимальный размер подсети — /18, максимальный размер подсети — /8
3
  --network-services-cidr <CIDR подсети для сервисов — например, 10.22.64.0/18> \  # Минимальный размер подсети — /18, максимальный размер подсети — /12
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-адрес кластера \
10
  --plugins-cni-calico {} # Или --plugins-cni-cilium {}

Чтобы получить возможность создавать кластеры Managed Kubernetes без CNI, обратитесь в техническую поддержку. После этого вы сможете создать кластер без CNI с помощью флага --plugins-cni={}.

За использование внешнего 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

40
  plugins = {
41
    cni = {
42
      calico = {} // Или cilium = {}
43
    }
44
  }
45
}

Здесь:

• Cекция availability — уровень доступности кластера:

  • standalone — в одной зоне без резервирования;
  • zonal_ha — с зональной высокой доступностью.

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

• Секция metadata — метаданные кластера:

  • description — описание кластера;
  • display_name — отображаемое имя кластера.

• Секция network — настройки сети:

  • pods_cidr — диапазон IP-адресов для подов в CIDR-нотации. Минимальный размер подсети — /18, максимальный размер подсети — /8.
  • services_addr — диапазон IP-адресов для сервисов в CIDR-нотации. Минимальный размер подсети — /18, максимальный размер подсети — /12.
  • primary_endpoint — внутренний IP-адрес для доступа к API кластера.
  • public_endpoint — внешний IP-адрес для доступа к API кластера.

• Секция version_control — настройки управления версиями и обслуживанием:

  • release_channel — релизный канал;
  • maintainance_window — параметры сервисного окна: периодичность и время начала;
  • version — минимальная версия Kubernetes.

• Секция plugins — сетевой плагин (CNI). Можно выбрать или Calico, или Cilium.

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

  1
  plugins = {
  2
    cni = {}
  3
  }

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

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": { // Или "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, максимальный размер подсети — /8
18
      "servicesCidr": "<CIDR подсети для сервисов — например, 10.22.64.0/18>" // Минимальный размер подсети — /18, максимальный размер подсети — /12
19
    },
20
    "versionControl": {
21
      "releaseChannel": "<релизный канал — например, stable>",
22
      "version": "<минимальная версия Kubernetes — например, v1.31.13-mws.1>"
23
    },
24
    "plugins": {
25
      "cni": {
26
        "calico": {} // Или "cilium": {}
27
      }
28
    }
29
  }
30
}

Здесь spec.plugins — секция для указания сетевого плагина (CNI). Можно выбрать или Calico, или Cilium.

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

1
"plugins": {
2
  "cni": {}
3
}

(опционально) Чтобы управлять кластером через интернет, добавьте в характеристики кластера параметр 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
    "plugins": {
28
      "cni": {
29
        "calico": {} // Или "cilium": {}
30
      }
31
    }
32
  }
33
}

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

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

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