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

От установки до первого клиентского кластера и базового мониторинга за 6 шагов.

Для кого эта страница

Если вы впервые работаете с платформой «Штурвал» и не знаете, с чего начать — эта страница задаёт маршрут от пустой инфраструктуры до полностью настроенной платформы с клиентскими кластерами.

Общая схема

Платформа «Штурвал» — это кластер управления (management cluster), который создаёт и управляет клиентскими кластерами (workload clusters). Сначала вы устанавливаете кластер управления, затем настраиваете провайдеры инфраструктуры (VMware vSphere, oVirt и oVirt-подобные платформы, OpenStack, VK Cloud, Selectel, Shturval v2 и др.) и создаёте клиентские кластеры. Как устроены компоненты и их взаимодействие, см. на странице Архитектура платформы.


Установка → Первый вход → Провайдеры → Доступ пользователей → Первый клиентский кластер → Контроль состояния

Шаг 1: Установка кластера управления

Время: 20–90 минут (зависит от контура, провайдера и количества узлов)

Что делаете: Определяете редакцию лицензии, сверяете требования и подготовку к инсталляции, затем разворачиваете кластер управления утилитой shtil по инструкции Процесс инсталляции.

Ключевые действия:

  1. Лицензия — порядок получения лицензии для CE и Enterprise описан на странице Виды лицензии.

  2. Требования и подготовка — требования к платформе, подготовка к инсталляции; для закрытого контура — работа с зеркалом; для открытого контура с публичным Ingress — TLS Let’s Encrypt.

  3. Установка — следуйте странице Процесс инсталляции или инсталляция через shtil (в том числе с провайдерами OpenStack и oVirt).

Шаг 2: Первый вход и проверка

Время: 5–10 минут

Что делаете: Входите в графический интерфейс, убеждаетесь, что кластер управления в статусе «Готов», сохраняете kubeconfig и учётные данные.

Ключевые действия:

  1. Войдите в GUI по URL (логин admin, пароль — из вывода shtil или второй строки в $HOME/.shturval/installer/user.conf).

  2. Убедитесь, что кластер управления отображается в разделе Кластеры и имеет статус «Готов» (зелёная галочка).

  3. Сохраните kubeconfig: стрелка рядом с именем пользователя → Скачать Kubeconfig; см. также доступ к kubeconfig.

  4. Сохраните пароль admin; при необходимости смените его по инструкции в разделе управления доступом.

Если временный bootstrap-кластер больше не нужен, удалите его по инструкции Деинсталляция временного кластера.

Шаг 3: Настройка провайдеров и пула IP

Время: 20–60 минут (зависит от провайдера)

Что делаете: По обзору работы с провайдерами готовите связку пул IP → экземпляр провайдера → шаблон ВМ, чтобы затем создавать клиентские кластеры.

Ключевые действия:

  1. Пул IP-адресов: Провайдеры → Пулы IP-адресов → Добавить пул — см. Пулы IP-адресов.

  2. Провайдер: Провайдеры → Конфигурация провайдеров → Добавить экземпляр. Полный список типов — на странице О провайдерах. Документация по типам: VMware vSphere, oVirt и oVirt-подобные платформы, OpenStack, VK Cloud и Selectel, VMware vCloud Director, Yandex Cloud, Basis Dynamix, Shturval v2.

  3. Шаблон ВМ — по инструкции по подготовке шаблона, если ваш провайдер использует образы или шаблоны.

Шаг 4: Настройка доступа пользователей

Время: 15–45 минут (зависит от выбора: LDAP или OIDC)

Что делаете: Определяете сценарий входа пользователей: LDAP или OIDC (Keycloak/Blitz), затем назначаете права.

Варианты:

Ключевые действия:

  1. Подключите LDAP (Управление доступом → Интеграция с LDAP) или OIDC в Аутентификация в платформе / через PatchSSC модуля shturval-auth (см. подключение внешних провайдеров).

  2. При необходимости создайте наборы разрешений: Управление доступом → Менеджер доступов — см. роли и разрешения.

  3. Назначьте права на объекте (платформа, кластер, неймспейс) — управление доступом.

Шаг 5: Создание первого клиентского кластера

Время: 20–60 минут (развёртывание кластера)

Что делаете: Перед мастером сверяйте требования к клиентскому кластеру. Создаёте кластер через Кластеры → Создать кластер: провайдер, VIP/API, подсети, узлы, сертификат и сервисы.

Пошаговый чек-лист — в Создание кластера; поля мастера по провайдерам — на страницах провайдеров.

Ключевые действия:

  1. Кластеры → Создать кластер.

  2. Выберите провайдер и экземпляр.

  3. Заполните имя, версию Kubernetes, адрес API-сервера, VIP Ingress (из пула, если применимо), подсети подов и сервисов.

  4. Настройте Control Plane (1 или 3 узла) и Worker-узлы (минимум 2).

  5. Выберите сертификат (в том числе Let’s Encrypt для открытого контура) и сервисы (мониторинг, логирование, Velero и др.).

  6. Запустите создание и дождитесь статуса «Кластер готов».

Шаг 6: Контроль состояния кластеров

Время: 5–15 минут в день (регулярная проверка)

Что делаете: Регулярно смотрите состояние узлов и нагрузок на дашборде кластера, предустановленные дашборды Grafana, а срабатывания и настройку каналов — в алертинге.

Ключевые места:

  • Дашборд кластера — вкладки Кластер, Узлы, Аннотации, События, Логи.

  • Статистика — переход к метрикам (Grafana).

  • Оповещения — правила и просмотр алертов по метрикам и логам.

← Требования к ОС
Требования к балансировщику нагрузки →