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

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

1. Зарегистрируйтесь в личном кабинете Cloud.ru.

   Если вы уже зарегистрированы, войдите под своей учетной записью.

2. Выберите проект или создайте новый.

3. Проверьте свою роль в проекте.

   Чтобы можно было создавать кластеры, пользователю должна быть назначена одна из перечисленных ролей:

   • Администратор организации

   • Администратор проекта

   • Пользователь проекта с сервисной ролью k8s.admin

   • Пользователь сервисов с сервисной ролью k8s.admin

   Если у вас другая роль, запросите права у администратора организации.

4. Установите консольную утилиту kubectl.

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

1. В разделе Сервисы платформы личного кабинета выберите Managed Kubernetes и нажмите Создать кластер.

2. На шаге «Общие параметры»:

   1. Введите название кластера — cloudru-cluster.

   2. Выберите количество мастер-узлов — 3.

   3. Выберите конфигурацию мастер-узлов — 2 vCPU, 4 ГБ RAM.

   4. Нажмите Продолжить.

3. На шаге «Сеть»:

   1. Укажите адрес подсети сервисов — 10.96.0.0/12.

   2. Укажите адрес подсети подов — 10.1.0.0/16.

   3. Выберите адрес подсети мастер-узлов — Default.

   4. Чтобы подключаться к кластеру с локального устройства, активируйте опцию Публичный IP-адрес.

   5. Нажмите Продолжить.

4. На шаге «Группы узлов» нажмите Добавить группу узлов, а затем:

   1. Введите название группы узлов — cloudru-nodepool.

   2. Выберите гарантированную долю vCPU — 30%.

   3. Выберите vCPU — 4, RAM — 8.

   4. Укажите объем хранилища — 20.

   5. Выберите адрес подсети узлов — Default.

   6. Укажите количество узлов — 5.

   7. Нажмите Продолжить.

5. На шаге «Интеграция»:

   1. Чтобы отправлять сообщения в сервис логирования, активируйте опцию Логирование.

   2. В поле Лог-группа выберите default.

   3. Чтобы собирать метрики и отправлять их в сервис мониторинга, активируйте опцию Мониторинг.

   4. Чтобы настраивать подключение дисков в качестве постоянных томов, активируйте опцию Блочное хранилище.

   5. Нажмите Создать.

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

1. Сохраните kubeconfig:

   1. Нажмите справа от названия созданного кластера и выберите Скачать kubeconfig.

   2. Сохраните файл с названием config в каталоге $HOME/.kube.

2. Создайте персональный ключ доступа:

   1. В личном кабинете перейдите в раздел Управление профилем и нажмите Ключи доступа.

   2. Нажмите Создать ключ.

   3. Введите краткое описание — Ключ для кластера Mk8s.

   4. Выберите время жизни ключа — 30 дней и нажмите Создать.

      Будут сгенерированы Key ID (логин) и Key Secret (пароль).

   5. Сохраните Key Secret (пароль).

      После того как вы закроете окно, посмотреть его будет нельзя.

3. Настройте kubeconfig:

   1. Откройте config и скопируйте значения Key ID (логин) и Key Secret (пароль) в value для параметров CLOUDRU_KEY_ID и CLOUDRU_SECRET_ID.

   2. Сохраните config.

4. Для получения токена доступа на основе персонального ключа установите утилиту cloudlogin:

   1. Загрузите cloudlogin.

   2. Распакуйте загруженный архив в директорию cloudlogin.

   3. Переместите директорию cloudlogin в /usr/local/bin (Linux, macOS) или C:\Program File (Windows).

      Для Windows добавьте путь к cloudlogin в переменную окружения PATH.

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

      cloudlogin help
      
      

      Отобразится справочная информация.

5. Проверьте подключение:

   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

Что дальше

• Развернуть рабочие нагрузки

• Подключить постоянный том

• Настроить автоматическое масштабирование

• Настроить балансировщик нагрузки

• Наблюдать за состоянием параметров кластера