tocdepth: 2

Быстрый старт

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

Перед началом работы

Установите консольную утилиту kubectl.
Авторизуйтесь в личном кабинете. Подробнее об этом см. в руководстве.
В личном кабинете вверху слева выберите проект или создайте новый.
Проверьте свою роль в проекте. Сделать это можно в разделе Пользователи.

Чтобы можно было создавать кластеры, пользователю должна быть назначена одна из перечисленных ролей:
- Администратор организации
- Администратор проекта
- Пользователь проекта с сервисной ролью k8s.admin
- Пользователь сервисов с сервисной ролью k8s.admin
Если у вас другая роль, запросите права у администратора организации.

Создайте кластер и группу узлов

В разделе Сервисы платформы личного кабинета выберите Managed Kubernetes и нажмите Создать кластер.
На шаге «Общие параметры»:
1. Введите название кластера — cloudru-cluster.
2. Выберите количество мастер-узлов — 3.
3. Выберите конфигурацию мастер-узлов — 2 vCPU,4 ГБ RAM.
4. Укажите версию Kubernetes — 1.27.14.
5. Нажмите Продолжить.
На шаге «Сеть»:
1. Укажите адрес подсети сервисов — 10.96.0.0/12.
2. Укажите адрес подсети подов — 10.1.0.0/16.
3. Выберите адрес подсети мастер-узлов — Default.
4. Активируйте опцию Публичный IP-адрес, чтобы подключаться к кластеру с вашего компьютера.
5. Нажмите Продолжить.
На шаге «Группы узлов» нажмите Добавить группу узлов, а затем:
1. Введите название группы узлов — cloudru-nodepool.
2. Выберите гарантированную долю vCPU — 30%.
3. Выберите vCPU — 4, RAM — 8.
4. Укажите объем хранилища — 20.
5. Выберите адрес подсети узлов — Default.
6. Укажите количество узлов — 5.
7. Нажмите Продолжить.
На шаге «Интеграция и плагины»:
1. Активируйте опцию Логирование, чтобы отправлять сообщения в сервис логирования.
2. Активируйте опцию Мониторинг, чтобы собирать метрики и отправлять их в сервис мониторинга.
3. Выберите плагины:
  - Calico — для управления сетевыми политиками.
  - Kube State Metrics — для получения метрик объектов кластера.
  - Node Exporter — для получения системных метрик кластера.
  - Fluent Bit — для сбора логов.
4. Нажмите Создать.

Создание кластера занимает 5–10 минут. Для продолжения работы убедитесь, что состояние кластера — «Запущено».

Подключитесь к кластеру

Сохраните kubeconfig:
1. Нажмите справа от названия созданного кластера и выберите Скачать kubeconfig.
2. Сохраните файл с названием config в каталоге $HOME/.kube.
Создайте персональный ключ доступа:
1. В личном кабинете перейдите в раздел Управление профилем и нажмите Ключи доступа.
2. Нажмите Создать ключ.
3. Введите краткое описание — Ключ для кластера Mk8s.
4. Выберите время жизни ключа — 30 дней и нажмите Создать.
  
  Будут сгенерированы Key ID (логин) и Key Secret (пароль).
5. Сохраните Key Secret (пароль).
  
  После того как вы закроете окно, посмотреть его будет нельзя.
Настройте kubeconfig:
1. Откройте config и скопируйте значения Key ID (логин) и Key Secret (пароль) в value для параметров CLOUDRU_KEY_ID и CLOUDRU_SECRET_ID.
2. Сохраните config.
Для получения токена доступа на основе персонального ключа установите утилиту cloudlogin:
1. Загрузите cloudlogin.
2. Распакуйте загруженный архив в директорию cloudlogin.
3. Переместите директорию cloudlogin в /usr/local/bin (Linux, macOS) или C:\Program File (Windows).
  
  Для Windows добавьте путь к cloudlogin в переменную окружения PATH.
4. Выполните команду:
```
cloudlogin help
```
  Будет доступна справочная информация.
Проверьте подключение:
```
kubectl cluster-info
```
Ответ команды должен содержать адреса плоскости управления и сервисов.

Проверьте состояние узлов

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

kubectl get nodes

Если рабочие узлы созданы успешно и готовы к работе, ответ будет содержать следующее:

NAME                                      STATUS   ROLES    AGE   VERSION

vm-11bafdce-a69d-4a27-b237-0b03b08c6c6f   Ready    <none>   22m   v1.27.14
vm-490d6d62-916e-4229-9549-642834545ca7   Ready    <none>   27m   v1.27.14
vm-6b92e610-46c0-47d5-9c47-52bc884fcc8a   Ready    <none>   27m   v1.27.14
vm-aefc56d0-2edb-4ee5-9ef4-90c30f4abc52   Ready    <none>   22m   v1.27.14
vm-b5353fe6-2fca-4422-bb53-34987ee7e816   Ready    <none>   18m   v1.27.14

Что дальше

Далее для созданного кластера вы можете:

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

См.также