Управление кластером

Получить список кластеров

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

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

Откроется список кластеров проекта.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.

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

1
mws mk8s cluster list

1
+----------+-------------+------------+----------------------+
2
|   NAME   | DESCRIPTION |   STATUS   |      UPDATE TIME     |
3
+----------+-------------+------------+----------------------+
4
| cluster  |             | OK         | 2025-10-15T14:37:06Z |
5
+----------+-------------+------------+----------------------+

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.
Выполните запрос:
bash
```
1
curl -X GET https://mk8s.mwsapis.ru/mk8s/v1/projects/<имя проекта>/clusters \
2
  -H "Authorization: Bearer <IAM-токен>"
```
В ответе будет выведен список доступных кластеров проекта с детализацией параметров.

Получить информацию о конкретном кластере

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

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed Kubernetes. Откроется список кластеров проекта.
Нажмите на имя нужного кластера.

Откроется страница с информацией об этом кластере.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mk8s cluster list
```

Получите информацию о кластере:

1
mws mk8s cluster get <имя кластера>

1
kind: mk8s/v1/cluster
2
metadata:
3
    id: mk8s/projects/<имя проекта>/clusters/<имя кластера>
4
    name: <имя кластера>
5
    displayName: <отображаемое имя кластера>
6
    createTime: "<дата и время создания кластера>"
7
    updateTime: "<дата и время последнего изменения кластера>"
8
    usages: []
9
    etag: 797****
10
    description: "<описание кластера>"
11
spec:
12
    availability:
13
        zones:
14
            - <зона доступности>
15
    network:
16
        primaryEndpoint:
17
            spec:
18
                subnet: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
19
        podsCidr: <CIDR подсети для подов>
20
        servicesCidr: <CIDR сервисной подсети>
21
    versionControl:
22
        releaseChannel: <релизный канал>
23
        version: <версия Kubernetes>
24
status:
25
    ready:
26
        state: OK
27
    clusterCaCertificate: <сертификат>
28
    network:
29
        vpcNetwork:
30
            ref: projects/<имя проекта>/networks/<имя сети>
31
        subnet:
32
            ref: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
33
        primaryEndpoint:
34
            ref: projects/<имя проекта>/networks/<имя сети>/addresses/<имя Endpoint>
35
        primaryAddress: <IP-адрес кластера>
36
    versionControl:
37
        releaseChannel: <релизный канал>
38
        version: <версия Kubernetes>
39
    clusterStatus:
40
        state: <статус кластера>

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

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

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

Получите информацию о кластере:

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

1
{
2
  "kind" : "mk8s/v1/cluster",
3
  "metadata" : {
4
    "id" : "mk8s/projects/<имя проекта>/clusters/<имя кластера>",
5
    "name" : "<имя кластера>",
6
    "displayName" : "<отображаемое имя кластера>",
7
    "createTime" : "<дата и время создания кластера>",
8
    "updateTime" : "<дата и время последнего изменения кластера>",
9
    "usages" : [ ],
10
    "etag" : "797****",
11
    "description" : "<описание кластера>"
12
  },
13
  "spec" : {
14
    "availability" : {
15
      "zones" : [ "<зона доступности>" ]
16
    },
17
    "network" : {
18
      "primaryEndpoint" : {
19
        "spec" : {
20
          "subnet" : "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
21
        }
22
      },
23
      "podsCidr" : "<CIDR подсети для подов>",
24
      "servicesCidr" : "<CIDR сервисной подсети>"
25
    },
26
    "versionControl" : {
27
      "releaseChannel" : "<релизный канал>",
28
      "version" : "<версия Kubernetes>"
29
    }
30
  },
31
  "status" : {
32
    "ready" : {
33
      "state" : "OK"
34
    },
35
    "clusterCaCertificate" : "<сертификат>",
36
    "network" : {
37
      "vpcNetwork" : {
38
        "ref" : "projects/<имя проекта>/networks/<имя сети>"
39
      },
40
      "subnet" : {
41
        "ref" : "projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>"
42
      },
43
      "primaryEndpoint" : {
44
        "ref" : "projects/<имя проекта>/networks/<имя сети>/addresses/<имя Endpoint>"
45
      },
46
      "primaryAddress" : "<IP-адрес кластера>"
47
    },
48
    "versionControl" : {
49
      "releaseChannel" : "<релизный канал>",
50
      "version" : "<версия Kubernetes>"
51
    },
52
    "clusterStatus" : {
53
      "state" : "<статус кластера>"
54
    }
55
  }
56
}

Изменить кластер

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

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed Kubernetes.
Нажмите на имя нужного кластера. Откроется страница с его параметрами.
Измените параметры кластера:
- Чтобы изменить имя, наведите на него курсор и нажмите на значок-карандаш.
- Чтобы изменить описание, нажмите на значок-карандаш для соответствующей строки.
- Чтобы изменить расписание сервисного окна, нажмите на значок-карандаш для блока Настройки версии кластера.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mk8s cluster list
```
Передайте в команде изменяемые параметры:
bash
```
1
mws mk8s cluster update <имя кластера> <набор флагов>
```
Полный список флагов вы можете получить с помощью команды:
bash
```
1
mws mk8s cluster update --help
```
Пример команды:
bash
```
1
mws mk8s cluster update <имя кластера> \
2
  --display-name "<новое имя кластера>"
```
Если команда была успешно выполнена, вы получите ответ с обновленными параметрами кластера.

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

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

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

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

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/<имя кластера>?updateOnly=true \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
        "metadata": {
6
          "displayName": "<отображаемое имя кластера>"
7
        }
8
      }'

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

Настроить внешний доступ

Вы можете получить доступ к Control Plane кластера как внутри сети облака, так и через интернет.

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

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed Kubernetes.
Нажмите на имя нужного кластера. Откроется страница с его параметрами.
В блоке Настройки сети измените параметр Публичный Endpoint:
- Чтобы управлять кластером через интернет, нажмите кнопку Назначить и перейдите во вкладку Зарезервированный. Выберите существующий внешний IP-адрес или зарезервируйте новый, после чего нажмите кнопку Сохранить.
- Чтобы управлять кластером через промежуточную ВМ в облаке, нажмите на значок-карандаш, выберите вкладку Без адреса и нажмите кнопку Сохранить. Управление кластером через интернет будет недоступно.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mk8s cluster list
```
Выполните команду:
bash
```
1
mws mk8s cluster update <имя кластера> \
2
  --network-public-endpoint-ref vpc/projects/<имя проекта>/externalAddresses/<имя внешнего IP-адреса>
```
Если команда была успешно выполнена, вы получите ответ с обновленными параметрами кластера.

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

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

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

Добавьте в JSON-объект, который был использован при создании кластера, параметр primaryEndpoint:

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

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

Системные правила файрвола по умолчанию запрещают входящий трафик из интернета. Чтобы предоставить доступ к кластеру, создайте правило файрвола со следующими параметрами:

Направление — INGRESS;
Действие — Allow;
Источник трафика — 0.0.0.0/0 или внешний IP-адрес устройства, с которого вы планируете подключаться к кластеру;
Назначение трафика — внутренний IP-адрес кластера в нотации CIDR, например 192.168.1.10/32;
Протокол и порт — TCP:6443.

Удалить кластер

Перед удалением кластера:

удалите группы узлов;
удалите сервисы типа LoadBalancer.

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

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed Kubernetes.
Нажмите на значок ... для удаляемого кластера и выберите Удалить.
Подтвердите удаление.
После удаления кластера удалите диски Compute, связанные с объектами PersistentVolume. Они не удаляются автоматически независимо от значения параметра reclaimPolicy.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mk8s cluster list
```
Выполните команду:
bash
```
1
mws mk8s cluster delete <имя кластера>
```
Если кластер был успешно удален, на экран будет выведен ответ success.
После удаления кластера вручную удалите диски Compute, связанные с объектами PersistentVolume. Они не удаляются автоматически независимо от значения параметра reclaimPolicy.

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

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

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

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

1
curl -X DELETE https://mk8s.mwsapis.ru/mk8s/v1/projects/<имя проекта>/clusters/<имя кластера> \
2
    -H "Authorization: Bearer <IAM-токен>" \
3
    -H "Content-Type: application/json"

После удаления кластера вручную удалите диски Compute, связанные с объектами PersistentVolume. Они не удаляются автоматически независимо от значения параметра reclaimPolicy.