×

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

 
ВВЕДЕНИЕ
 
Managed Kubernetes в DevSpace — это полноценный кластер Kubernetes, который разворачивается в вашем пространстве за несколько минут и обслуживается платформой. В отличие от установки на собственных VM или bare-metal-серверах, вам не нужно готовить операционную систему, устанавливать компоненты кластера, настраивать сеть между узлами и следить за управляющим слоем — всё это берёт на себя DevSpace.
 
Управляющие компоненты кластера (API-сервер, планировщик и другие) работают внутри платформы и не занимают ваши рабочие узлы. Рабочие узлы — это виртуальные машины, которые создаются и удаляются автоматически в заданных вами пределах. Вы получаете адрес кластера, файл доступа (kubeconfig) и работаете с кластером так же, как с любым другим Kubernetes: через kubectl, GitOps-инструменты или графические клиенты.
 
ПЕРЕД НАЧАЛОМ
 
У вас уже должно быть создано пространство в сервисе DevSpace и настроен доступ к его к его приложениям (сервисам). Все действия ниже выполняются внутри вашего пространства.
 
Также понадобится компьютер с доступом в интернет, на который вы установите утилиту kubectl для управления кластером.
 
Пошаговое руководство
 
Руководство описывает только то, что нужно заполнить, чтобы получить рабочий кластер. Остальные поля формы можно оставить по умолчанию — их разбор есть в разделе «Параметры».
 
Шаг 1. Откройте форму создания кластера
 
В дашборде откройте Marketplace, выберите категорию Infrastructure и карточку Kubernetes. То же самое делает меню в левом верхнем углу консоли: выберите Kubernetes и нажмите Deploy. У формы две вкладки — Form с полями и YAML с той же конфигурацией текстом.
 
Шаг 2. Задайте имя и основные параметры
 
Поле
Значение в примере
Зачем
Name
demo
Имя кластера: строчные латинские буквы и цифры. Войдёт в адрес API
storageClass
replicated
Класс хранилища для томов приложений внутри кластера. После создания изменить нельзя
version
оставьте по умолчанию
Версия Kubernetes. По умолчанию предлагается самая свежая из доступных
host
оставьте пустым
Своё внешнее имя для API. Пустое поле означает адрес по умолчанию
 
Дальше в статье <name> — это имя, которое вы задали в поле Name: платформа подставляет его в имена сервисов, секретов и компонентов инстанса.
 
Имя попадает в адрес API: кластер demo в пространстве a7f3k9m2q5 получит адрес kubernetes-demo.a7f3k9m2q5.devspace.oblakoteka.ru. По этому адресу API доступен из интернета сразу после создания — он публикуется через входной шлюз платформы, а защищён сертификатами из файла доступа: без него подключиться нельзя.
 
storageClass задаёт, в каком классе хранилища платформы будут создаваться постоянные тома (PVC) ваших приложений. Выбор зависит от того, реплицирует ли приложение свои данные само: кластерным базам и брокерам сообщений подходит local — он быстрее, а копии данных у них и так есть на других экземплярах (репликах). Всему остальному оставляйте replicated, иначе отказ одного сервера хранения означает потерю тома.
 
 
Шаг 3. Добавьте группу рабочих узлов
 
Рабочие узлы — это виртуальные машины, объединённые в группы. Группы задаются как список с именами, и в пустой форме ни одной группы нет: впишите имя группы, например md0, в поле Enter key name… и нажмите рядом + Add. Группа раскроется отдельным блоком с полями.
 
Заполните в этом блоке четыре поля:
Поле
Значение в примере
Зачем
 minReplicas / maxReplicas
2 и 2
Границы автоматического масштабирования. Одинаковые значения дают фиксированный размер группы, разные — кластер сам добавляет и убирает узлы по нагрузке, не выходя за эти границы
 instanceType
u1.medium
Размер виртуальной машины узла — CPU и память. Все узлы группы одинаковы (справочник пресетов)
 diskSize
20Gi
Системный диск узла: образы контейнеров, логи, временные данные. При пересоздании узла его содержимое теряется, данные приложений живут не здесь
 roles
ingress-nginx
Роль узлов. Нажмите + add и впишите значение. Без неё не заработает аддон Ingress-NGINX из шага 4
 
 
Остальные поля группы — kubelet, resources, gpus, maxUnhealthy, nodeStartupTimeout — оставьте как есть. А вот на storageClass в этом же блоке стоит посмотреть отдельно.
Подсказка: в форме два поля storageClass, и это разные вещи. Верхнее, из шага 2, — класс хранилища для томов ваших приложений внутри кластера. Поле внутри группы узлов — класс для системных дисков самих виртуальных машин-узлов, и форма подставляет в него local (default).
 
Разница на практике в переносе узлов. С replicated диск узла доступен сразу с нескольких серверов платформы, и работающий узел может переехать между ними без остановки — например, когда сервер уводят на обслуживание. С local узел привязан к своему серверу: вместо переезда его пересоздадут (что немного дольше), а приложения переедут на другие узлы силами самого Kubernetes. Для большинства кластеров local подходит, менять его стоит осознанно.
 
 
Шаг 4. Включите нужные аддоны
 
Аддоны — готовые компоненты, которые платформа ставит в кластер вместе с его созданием. Для публикации веб-приложений включите два:
 
  • certManager → enabled — автоматический выпуск и продление TLS-сертификатов
  • ingressNginx → enabled — контроллер входящего HTTP/HTTPS-трафика. Поле exposeMethod оставьте Proxied, список hosts можно заполнить позже.
 
Остальные аддоны для первого кластера оставьте выключенными. Что умеет каждый и когда его включать — в разделе «Параметры», там же разобраны способы публикации приложений.
 
Всё, что выключено сейчас, можно включить позже, изменив конфигурацию кластера.
 
Шаг 5. Укажите источник образов узлов и создайте кластер
 
В группе полей talos замените imageFactoryURL на адрес зеркала Облакотеки:
https://fs.oblakoteka.ru/talos
 
По умолчанию в поле указан публичный репозиторий образов Talos, из публичных сетей РФ он доступен нестабильно. Без образа виртуальные машины узлов не создадутся, поэтому адрес зеркала обязателен. Пишется без косой черты на конце, остальные поля группы talos не трогайте.
 
Группы полей controlPlane, nodeHealthCheck, oidc и images оставьте по умолчанию — для рабочего кластера их менять не нужно. Нажмите Deploy.
 
Шаг 6. Дождитесь готовности кластера
 
Создание занимает несколько минут. Статус Ready в шапке карточки означает, что платформа применила конфигурацию.
 
Фактическое состояние показывает вкладка Workloads: там перечислены компоненты управляющего слоя и виртуальные машины узлов. Строки virt-launcher-… — это и есть ваши рабочие узлы.
 
Готовность — когда в строках стоит Running, а числа в счётчике равны: 1/1, 5/5, 7/7. Одна строка выбивается из этого правила: разовая задача oidc-bootstrap заканчивается статусом Succeeded со счётчиком 0/1, и это нормально — задача отработала и завершилась. Если что-то долго не запускается, загляните на вкладку Events.
 
Шаг 7. Заберите файл доступа
 
На вкладке Secrets карточки кластера лежит секрет kubernetes-<name>-admin-kubeconfig с четырьмя ключами:
 
  • admin.conf— тот, что вам нужен: файл kubeconfig с внешним адресом кластера, для подключения со своего компьютера
  • admin.svc— тот же доступ, но с внутренним адресом: для сервисов внутри платформы
  • super-admin.confи super-admin.svc — аварийный доступ с максимальными правами в обход обычной модели прав, для повседневной работы не нужен
 
 
Подсказка: не выделяйте содержимое секрета мышкой — так легко захватить лишние символы или потерять переносы строк. Рядом с каждым ключом есть кнопка копирования, она копирует значение в точности.
 
 
Шаг 8. Установите kubectl и подключитесь к кластеру
 
kubectl — стандартная консольная утилита для управления Kubernetes. Установите её по официальной инструкции для вашей операционной системы. Желательно ставить версию, соответствующую версии вашего кластера (например, kubectl 1.35 для кластера v1.35) — допустимо отклонение в один минорный релиз.
 
Затем сохраните kubeconfig:
mkdir -p ~/.kube
 
# если у вас уже есть файл ~/.kube/config от другого кластера — сначала сохраните его копию:
cp ~/.kube/config ~/.kube/config.backup
 
# откройте файл в редакторе и вставьте содержимое ключа admin.conf, скопированное кнопкой копирования:
nano ~/.kube/config
 
 
После вставки убедитесь, что форматирование не сломалось: файл должен выглядеть как аккуратный YAML с отступами, без «слипшихся» строк. Проверьте подключение:
kubectl get nodes
 
Шаг 9. Дождитесь готовности узлов
 
Готовый кластер — это ещё не готовые к работе узлы и поды в нём. Сразу после создания рабочие узлы могут ещё регистрироваться в кластере, а системные компоненты — запускаться. Порядок такой: сначала стартует сеть кластера (в DevSpace по умолчанию используется Cilium), после неё узлы переходят в состояние Ready, затем поднимаются остальные системные компоненты и включённые аддоны (cert-manager, Ingress-NGINX и другие).
 
Подождите несколько минут и проверьте:
kubectl get nodes
kubectl get pods -A
 
Когда все узлы в состоянии Ready, а системные поды — Running, кластер готов к работе. Единичные перезапуски системных подов на этапе старта — это нормально: компоненты ждут друг друга.
 
Шаг 10 (по желанию). Установите Freelens — графический обозреватель кластера
 
Freelens — бесплатное десктопное приложение с открытым исходным кодом, своеобразный «проводник» по Kubernetes. Оно особенно полезно на первых порах: позволяет изучать кластер визуально, не заучивая команды kubectl.
 
Где взять: скачайте установщик для Windows, macOS или Linux с freelens.app или со страницы релизов на GitHub.
 
Как подключить кластер: Freelens работает с теми же kubeconfig-файлами, что и kubectl. Можно добавить файл конфигурации вручную через меню добавления кластера, а можно настроить автоматическое подхватывание конфигов из нужной директории (например, ~/.kube) — тогда кластер появится в списке сам.
 
Что в нём удобно смотреть:
  • Nodes — состояние и ресурсы узлов кластера
  • Workloads → Pods — запущенные поды. Отсюда же можно посмотреть логи пода или удалить его для перезапуска
  • Namespaces — пространства имён. Здесь же создаются новые
  • Config → Secrets / ConfigMaps — секреты и конфигурации с фильтрацией по пространствам имён
  • Storage → Storage Classes — доступные классы хранения. Пригодятся при написании манифестов с постоянными томами
  • Network — сервисы, endpoints и ingress-ресурсы
 
Функциональность расширяется плагинами: например, плагин для Flux CD показывает состояние GitOps-объектов прямо в интерфейсе.
 
ПАРАМЕТРЫ
 
Полный список параметров кластера. Всё, что не задано явно, платформа заполняет значениями по умолчанию из этой таблицы.
 
Основные
 
Параметр
Что делает
Значение по умолчанию
Когда менять
 version
Версия Kubernetes (major.minor). В списке — несколько последних версий, платформа разворачивает последний патч-релиз выбранной.
самая свежая из списка
При переносе нагрузок с существующего кластера — выбрать его версию.
 host
Внешнее DNS-имя кластера, по которому доступен его API.
пусто = kubernetes-.<домен-пространства>
Если хотите использовать собственный домен.
 storageClass
Класс хранения для постоянных томов (PVC) приложений в кластере: replicated — данные тома дублируются хранилищем на нескольких серверах. local — без репликации на уровне хранилища, быстрее. Объём томов тарифицируется по ресурсу «Хранилище». Нельзя изменить после создания.
replicated
local — для приложений, которые сами реплицируют свои данные между своими экземплярами (кластерные БД, брокеры сообщений). Приложению в одном экземпляре оставляйте replicated: копии данных больше нигде нет. У replicated ввод-вывод медленнее.
 
Управляющий слой (control plane)
 
Управляющий слой работает на стороне платформы, и для рабочего кластера эту группу полей менять не нужно — всё, что ниже, имеет разумные значения по умолчанию. Единственное, что стоит выбрать осознанно, — controlPlane.replicas: две реплики переживают отказ, одна экономит ресурсы на тестовом кластере.
 
Ресурсы каждого компонента задаются либо именованным пресетом (resourcesPreset), либо явными значениями CPU и памяти (resources) — явные значения имеют приоритет. Справочник по пресетам ресурсов.
 
 
Параметр
Что делает
Значение по умолчанию
Когда менять
 controlPlane.replicas
Число реплик управляющего слоя.
2
1 — для экономии на тестовых кластерах. 2+ — отказоустойчивость для production.
 controlPlane.apiServer.resourcesPreset
c1.medium
При росте кластера и числа обращений к API.
 controlPlane.apiServer.resources
Явные CPU/память API-сервера (переопределяют пресет).
не заданы
Когда пресетов недостаточно и нужны точные значения. Память указывайте с единицами измерения: 512Mi, 2Gi.
 controlPlane.controllerManager.resourcesPreset
Пресет ресурсов controller manager.
t1.micro
Редко. При большом числе объектов в кластере.
 controlPlane.controllerManager.resources
Явные CPU/память controller manager.
не заданы
Аналогично. Память указывайте с единицами измерения: 512Mi, 2Gi.
 controlPlane.scheduler.resourcesPreset
Пресет ресурсов планировщика.
t1.micro
Редко.
 controlPlane.scheduler.resources
Явные CPU/память планировщика.
не заданы
Редко. Память указывайте с единицами измерения: 512Mi, 2Gi.
 controlPlane.konnectivity.server.resourcesPreset
Пресет ресурсов konnectivity-сервера (туннель между управляющим слоем и узлами).
t1.micro
Редко.
 controlPlane.konnectivity.server.resources
Явные CPU/память konnectivity-сервера.
не заданы
Редко. Память указывайте с единицами измерения: 512Mi, 2Gi.
 
Группы рабочих узлов (nodeGroups)
 
Узлы объединяются в именованные группы. По умолчанию создаётся одна группа md0. Групп может быть несколько — например, отдельная группа более крупных узлов под ресурсоёмкие сервисы. Все параметры ниже задаются для каждой группы.
 
Параметр
Что делает
Значение по умолчанию
Когда менять
 minReplicas
Минимальное число узлов в группе — нижняя граница автомасштабирования.
0
Задайте не меньше числа узлов, которое должно работать всегда.
 maxReplicas
Максимальное число узлов — верхняя граница автомасштабирования.
10
По потолку бюджета и ожидаемой нагрузке.
 instanceType
Тип виртуальной машины узла (CPU и память), например u1.medium. Справочник по типам.
u1.medium
Под требования ваших приложений.
 diskSize
Размер временного (ephemeral) диска узла: образы контейнеров, логи, временные данные подов, данные kubelet и containerd. Содержимое теряется при пересоздании узла. Постоянные тома приложений сюда не входят — они выделяются из хранилища платформы (см. storageClass кластера).
20Gi
Если приложения используют много крупных образов или активно пишут во временные тома.
 storageClass
Класс хранения для дисков самих виртуальных машин узлов. Не путайте с storageClass кластера: тот отвечает за тома приложений.
local (default) — подставляет форма
replicated — чтобы работающий узел мог переезжать между серверами платформы без пересоздания: его диск должен быть доступен сразу с нескольких серверов.
 roles
Список ролей узлов группы. Роль ingress-nginx требуется хотя бы у одной группы, чтобы работал одноимённый аддон.
[] у группы, созданной вручную. ["ingress-nginx"] у служебной группы md0
Добавьте ingress-nginx своей группе, если планируете включать и использовать одноимённый аддон (см. раздел Аддоны)
 resources
Явные CPU/память узла (вместо instanceType).
не заданы
Когда типовые размеры не подходят. Память указывайте с единицами измерения: 512Mi, 2Gi.
 gpus
Список GPU, подключаемых к узлам группы, — для вычислительных и ML-нагрузок.
[]
Пока не используется: узлов с GPU в DevSpace нет.
 kubelet.evictionHardMemory
Жёсткий порог памяти, при котором узел начинает вытеснять поды (абсолютное значение или процент).
7%
Тонкая настройка стабильности узлов.
 kubelet.evictionSoftMemory
Мягкий порог вытеснения по памяти.
10%
Аналогично.
 kubelet.systemReservedMemory / kubelet.systemReservedCpu
Память/CPU, зарезервированные для ОС узла.
пусто = вычисляются из instanceType
Обычно не требуется.
 kubelet.kubeReservedMemory / kubelet.kubeReservedCpu
Память/CPU, зарезервированные для kubelet и контейнерного рантайма.
пусто = вычисляются из instanceType
Обычно не требуется.
 
Аддоны (addons)
 
У каждого аддона есть поле valuesOverride — расширенная настройка компонента для опытных пользователей. По умолчанию оно пустое - компонент работает с настройками платформы по умолчанию.
 
Параметр
Что делает
Значение по умолчанию
Когда менять
 certManager.enabled
Автоматический выпуск и продление TLS-сертификатов (включая Let’s Encrypt).
false
Включите вместе с Ingress-NGINX для публикации приложений по HTTPS.
 ingressNginx.enabled
Контроллер входящего HTTP/HTTPS-трафика. Требует роли ingress-nginx на узлах (есть по умолчанию).
false
Включите для публикации веб-приложений.
 ingressNginx.exposeMethod
Способ публикации контроллера: Proxied — через входной шлюз платформы (без выделенного IP, только домены из hosts), LoadBalancer — через выделенный балансировщик с собственным внешним IP (список hosts не используется, DNS-записи ваших приложений направляются на этот IP. Внешний IP тарифицируется отдельно).
Proxied
LoadBalancer — когда нужен отдельный внешний IP и трафик в обход общего шлюза.
 ingressNginx.hosts
Полные доменные имена, трафик которых входной шлюз платформы направляет в этот кластер (при exposeMethod: Proxied). Записываются как есть, без автоматического дополнения. Поддомены домена пространства работают без настройки DNS. Для собственных доменов настройте CNAME на домен пространства. Wildcard-имена (*.apps.example.com) допустимы, но HTTPS для них терминируется на шлюзе платформы с его сертификатом — для полноценного TLS с собственными сертификатами перечисляйте имена явно. Список открывает домену путь только до кластера. Маршрут до приложения задаёт Ingress-ресурс внутри кластера.
[]
Обязательно заполните при публикации приложений через Proxied. Можно дополнять после создания кластера.
 fluxcd.enabled
GitOps-оператор Flux CD: применяет манифесты из Git-репозитория.
false
Включите для GitOps-подхода. Не включайте при использовании Argo CD.
 velero.enabled
Резервное копирование и восстановление объектов кластера в S3.
false
Рекомендуется для любых важных сред.
 gatewayAPI.enabled
Поддержка Gateway API — современной альтернативы Ingress для маршрутизации трафика.
false
Если ваши приложения используют Gateway API.
 gpuOperator.enabled
NVIDIA GPU Operator: драйверы и обвязка для работы с GPU на узлах.
false
Пока не используется: узлов с GPU в DevSpace нет.
 hami.enabled
HAMi — виртуализация GPU (разделение одной карты между подами). Требует включённого GPU Operator.
false
Пока не используется: узлов с GPU в DevSpace нет.
 monitoringAgents.enabled
Агенты мониторинга (сбор метрик и логов) с отправкой в систему мониторинга пространства (заказывается через заявку в поддержку)
false
Рекомендуется для production.
 ouroboros.enabled
Исправление hairpin-NAT для Ingress-NGINX с PROXY-протоколом. Требует включённого ingressNginx. Полезен только при настроенном PROXY-протоколе.
false
Узкий случай. Включайте по рекомендации поддержки.
 cilium.valuesOverride
Тонкая настройка сети кластера (Cilium — сеть по умолчанию, отключить её нельзя).
{}
Только для опытных пользователей.
 coredns.valuesOverride
Тонкая настройка DNS кластера (CoreDNS устанавливается всегда).
{}
Только для опытных пользователей.
 verticalPodAutoscaler.
valuesOverride
Тонкая настройка Vertical Pod Autoscaler.
{}
Только для опытных пользователей.
 
Публикация веб-приложений подробнее
 
Приложения, запущенные в кластере, по умолчанию не доступны из интернета. Способ публикации выбирается под задачу:
  • сайты, веб-приложения, HTTP-API — связка cert-manager и Ingress-NGINX: все веб-приложения кластера публикуются через один вход, с маршрутизацией по доменам и автоматическими сертификатами. Если приложения построены на Gateway API, вместо Ingress-NGINX включите одноимённый аддон
  • не-веб-сервис — база данных, брокер сообщений, игровой сервер, что угодно с произвольным TCP- или UDP-протоколом — аддоны не нужны: создайте для приложения сервис типа LoadBalancer внутри кластера. Приложение получит собственный внешний адрес, трафик пойдёт напрямую в него. Каждый такой адрес тарифицируется отдельно
 
У Ingress-NGINX два способа публикации самого контроллера:
 
  • Proxied (по умолчанию) — трафик приходит через общий входной шлюз платформы, отдельный внешний адрес не выделяется. Перечислите в поле hosts полные доменные имена ваших приложений — они записываются как есть, без автоматического дополнения домена. Пока список пуст, внешний трафик в кластер не маршрутизируется. Поддомен вашего пространства (app.<домен-пространства>) уже указывает на шлюз платформы и работает сразу. Для собственного домена создайте у своего DNS-провайдера CNAME на домен пространства, а для корневого домена, где CNAME недопустим, — A-запись на адрес шлюза
  • LoadBalancer — контроллер получает выделенный балансировщик с собственным внешним адресом, на него вы направляете DNS-записи своих доменов, и трафик идёт в кластер напрямую. Список hosts при этом не используется. Это по-прежнему один вход для всех веб-приложений кластера — не путайте с сервисом LoadBalancer для отдельного приложения
 
При способе Proxied список hosts лишь открывает домену дорогу от шлюза платформы до вашего кластера. Куда направить запрос дальше, внутри кластера, решают обычные Ingress-ресурсы, которые вы создаёте рядом со своими приложениями — без них запрос дойдёт до кластера и получит в ответ 404 от контроллера. То есть каждый домен настраивается в двух местах: в hosts кластера и в Ingress-ресурсе приложения. Минимальный пример такого ресурса:
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: my-app
spec:
  ingressClassName: nginx
  rules:
  - host: app.<домен-пространства>   # то же имя, что указано в hosts кластера
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: my-app             # сервис вашего приложения
            port:
              number: 80
 
Flux CD позволяет хранить конфигурацию приложений в Git-репозитории: оператор сам скачивает манифесты и поддерживает состояние кластера в соответствии с репозиторием. Включайте, если работаете по GitOps-подходу. При использовании Argo CD или другого подобного инструмента Flux не включайте, иначе они будут спорить за управление одними и теми же ресурсами.
 
Velero сохраняет объекты Kubernetes в S3-совместимое хранилище и позволяет восстановиться после сбоя или ошибочного удаления. Настраивается фильтрами: копировать можно как весь кластер, так и отдельные пространства имён или типы объектов.
 
Образ операционной системы узлов (talos)
 
Рабочие узлы работают под управлением Talos Linux, и образ системы платформа скачивает по сети при создании каждого узла.
Параметр
Что делает
Значение по умолчанию
Когда менять
 talos.imageFactoryURL
Адрес, откуда скачивается образ операционной системы узлов.
публичный репозиторий образов
Указывайте https://fs.oblakoteka.ru/talos — зеркало Облакотеки: публичный источник из сетей РФ доступен нестабильно, а без образа узлы не создадутся. Адрес пишется без косой черты на конце.
 talos.version
Версия Talos Linux для узлов.
подставляется платформой
Не менять: версия согласована с выбранной версией Kubernetes.
 talos.schematicID
Вариант сборки образа.
проверенная платформой сборка
Не менять без необходимости в собственной сборке образа.
 talos.installerRepository
Источник образа-установщика для обновления узлов.
публичный репозиторий
Для изолированных сред и зеркал реестров.
 
Проверка здоровья узлов (nodeHealthCheck)
 
Параметр
Что делает
Значение по умолчанию
Когда менять
 nodeHealthCheck.maxUnhealthy
Доля неисправных узлов в группе, при превышении которой платформа приостанавливает их автоматическую замену.
50%
Редко. Значение задавайте процентом.
 nodeHealthCheck.nodeStartupTimeout
Сколько ждать готовности нового узла, прежде чем считать его неисправным и пересоздать.
10m
Увеличьте, если образ узла загружается медленно.
 
Вход пользователей в кластер (oidc)
 
Параметр
Что делает
Значение по умолчанию
Когда менять
 oidc.mode
Способ входа: None — работает только kubeconfig из секрета, System — вход по учётным записям платформы без дополнительной настройки, CustomConfig — собственный провайдер входа.
None
System — чтобы дать коллегам доступ, не передавая им kubeconfig.
 oidc.users
Кому открыт доступ при включённом входе: для каждого почта и роль — admin (полные права) или view (только просмотр).
[]
Вместе с mode: System.
 oidc.customConfig
Описание собственного провайдера входа: конфигурация текстом или ссылка на существующий секрет.
пусто
Только при mode: CustomConfig, по согласованию с поддержкой.
 
Служебные
 
Параметр
Что делает
Значение по умолчанию
Когда менять
 images.waitForKubeconfig / images.kubectl / images.talosCsrSigner
Переопределение служебных образов платформы — для изолированных сред и реестров с лимитами.
пусто = встроенные образы
Практически никогда, по указанию поддержки.
 
ПРИМЕР КОНФИГУРАЦИИ
 
Итоговая конфигурация, соответствующая шагам из руководства: два узла фиксированным размером и связка cert-manager + Ingress-NGINX. Остальные аддоны выключены, управляющий слой и служебные группы полей оставлены по умолчанию.
 
apiVersion: apps.cozystack.io/v1alpha1
kind: Kubernetes
metadata:
  name: demo                      # имя кластера; адрес API будет kubernetes-demo.<домен-пространства>
spec:
  version: v1.35                  # версия из списка формы; при переезде — версия исходного кластера
  host: ""                        # пусто = адрес по умолчанию
  storageClass: replicated        # класс хранения PVC приложений; неизменяемый после создания!
  controlPlane:
    replicas: 2                   # 2 реплики управляющего слоя — отказоустойчивость
    apiServer:
      resources: {}
      resourcesPreset: c1.medium
    controllerManager:
      resources: {}
      resourcesPreset: t1.micro
    scheduler:
      resources: {}
      resourcesPreset: t1.micro
    konnectivity:
      server:
        resources: {}
        resourcesPreset: t1.micro
  talos:
    imageFactoryURL: https://fs.oblakoteka.ru/talos   # зеркало Облакотеки: публичный источник из сетей РФ нестабилен
  nodeGroups:
    md0:
      minReplicas: 2              # ровно два узла:
      maxReplicas: 2              # min = max отключает автомасштабирование
      instanceType: u1.medium
      diskSize: 20Gi              # временный диск узла: образы, логи, временные данные
      storageClass: ""            # пусто = как у кластера; диски самих машин-узлов
      roles:
      - ingress-nginx             # роль нужна для аддона Ingress-NGINX
      resources: {}
      gpus: []
      kubelet: {}
  addons:
    certManager:
      enabled: true               # автоматические TLS-сертификаты
      valuesOverride: {}
    ingressNginx:
      enabled: true               # приём входящего HTTP/HTTPS-трафика
      exposeMethod: Proxied
      hosts: []
      valuesOverride: {}
    fluxcd:
      enabled: false              # GitOps-доставка манифестов
      valuesOverride: {}
    velero:
      enabled: false              # резервное копирование объектов кластера
      valuesOverride: {}
    cilium:
      valuesOverride: {}
    coredns:
      valuesOverride: {}
    gatewayAPI:
      enabled: false
    gpuOperator:
      enabled: false
      valuesOverride: {}
    hami:
      enabled: false
      valuesOverride: {}
    monitoringAgents:
      enabled: false
      valuesOverride: {}
    ouroboros:
      enabled: false
      valuesOverride: {}
    verticalPodAutoscaler:
      valuesOverride: {}
 
 
ПРОВЕРКА
 
1. В дашборде: статус кластера — Ready, поды на вкладке Workloads — в состоянии Running, на вкладке Secrets доступен kubeconfig. На вкладке Ingresses должна появиться запись kubernetes-, адрес которой совпадает с адресом кластера в kubeconfig — это публикация API вашего кластера через входной шлюз платформы. Она создаётся вместе с управляющим слоем, и её наличие подтверждает, что он развёрнут и опубликован. Ingress-ресурсы ваших приложений появятся на этой вкладке позже, когда вы начнёте их публиковать.
 
2. Узлы зарегистрированы и готовы:
kubectl get nodes
 
Ожидаемый результат — все узлы в состоянии Ready (первые минуты после создания они могут быть NotReady, пока поднимается сеть). Имена узлов складываются из имени кластера, имени группы и случайных суффиксов, а колонка ROLES показывает роли группы:
NAME                              STATUS   ROLES           AGE   VERSION
kubernetes-demo-md0-stxhx-4k6hh   Ready    ingress-nginx   5m    v1.35.1
kubernetes-demo-md0-stxhx-7zq2m   Ready    ingress-nginx   5m    v1.35.1
...
 
3. Системные компоненты запущены: kubectl get pods -A Все поды в состоянии Running или Completed. Если включали аддоны — в списке будут поды cert-manager, ingress-nginx, flux и velero.
 
ЧАСТЫЕ ОШИБКИ
 
Аддон Ingress-NGINX включён, всё в состоянии Running, но приложения снаружи недоступны — и нигде нет ни одной ошибки. Причина: способ публикации Proxied с пустым списком hosts. Входному шлюзу платформы некуда маршрутизировать трафик, маршрут для ваших доменов просто не создаётся, и это не считается ошибкой. Что делать: добавьте полные доменные имена приложений в ingressNginx.hosts и сохраните конфигурацию кластера.
 
Приложения перестали открываться, шлюз отвечает ошибкой 503. Причина: ни в одной группе узлов не осталось роли ingress-nginx — контроллеру входящего трафика негде работать, и запросы упираются в пустоту. Что делать: верните роль ingress-nginx хотя бы одной группе узлов.
 
Сразу после создания кластера узлы в состоянии NotReady. Причина: сеть кластера ещё запускается, а узлы становятся готовыми только после её старта — это нормальный порядок запуска, а не сбой. Что делать: подождите несколько минут. Если состояние не меняется 10–15 минут, посмотрите вкладку Events на странице кластера.
kubectl
не подключается: ошибки соединения или сертификатов. Причина: повреждён kubeconfig — скопирован не тот ключ секрета или при вставке сломалось форматирование YAML. Что делать: скопируйте содержимое ключа admin.conf кнопкой копирования и вставьте заново, проверив отступы.
 
Не удаётся изменить storageClass [кластера]{.underline}. Причина: этот параметр неизменяем после создания. Что делать: создайте новый кластер с нужным классом хранения и перенесите нагрузки.
 
Кластер в статусе Ready, но поды приложений висят в Pending. Причина: автомасштабирование упёрлось в maxReplicas, либо запросы ресурсов приложений не помещаются на узлы выбранного размера. Что делать: увеличьте maxReplicas группы узлов или выберите более крупный instanceType.
 
После переключения exposeMethod с Proxied на LoadBalancer приложения перестали открываться по прежним адресам. Причина: при LoadBalancer маршрут через общий шлюз платформы удаляется, а DNS-имена приложений всё ещё указывают на шлюз — тот отвечает 404. Что делать: направьте DNS-записи приложений на внешний адрес выделенного балансировщика, он виден на вкладке Services страницы кластера.
 
ЧТО ДАЛЬШЕ
 
Справочник по instanceType и resourcesPreset — какие типы инстансов и пресеты ресурсов доступны и как выбрать подходящий.