Skip to main content
Используйте Helm-чарт Yahont, чтобы развернуть Craft с песочницами Kubernetes. Чарт создаёт пространство имён песочниц, PodTemplate, RBAC, egress-прокси, NetworkPolicy и рабочий процесс запланированных задач, используемые Craft.

Требования

  • Kubernetes 1.33 или новее
  • Полное развёртывание Yahont с Helm с включённой векторной базой данных
  • Узлы с достаточным CPU, памятью и эфемерным хранилищем для активных песочниц
  • URL, по которому поды-песочницы могут обратиться к API Yahont
Чарт завершает установку или обновление ошибкой, когда Craft включён в более старой версии Kubernetes, когда бэкенд песочниц не kubernetes, когда ONYX_SERVER_URL пуст или когда не настроена аутентификация push в песочницы.

Подготовка узлов песочниц

По умолчанию поды-песочницы выбирают узлы с такой меткой:
Назначьте метку каждому узлу, на котором могут работать песочницы:
Токен по умолчанию для песочницы также поддерживает узлы, выделенные с таким taint:
Taint необязателен. Метка узла обязательна, если вы не замените sandboxPod.nodeSelector селектором, подходящим для вашего кластера.

Создание Secret для push в песочницу

Craft использует ключ Ed25519 для аутентификации передачи файлов и истории в поды-песочницы. Создайте ключ и сохраните его в пространстве имён Yahont:
Держите этот Secret неизменным при обновлениях. Замена ключа, пока песочницы работают, прерывает аутентифицированную передачу, пока затронутые компоненты и песочницы не будут созданы заново.

Настройка Helm

Добавьте следующие настройки в файл значений, используемый вашим существующим развёртыванием Yahont. Если configMap или auth уже есть, объедините эти записи с существующими ключами, а не добавляйте второй блок.
values.yaml
ONYX_SERVER_URL — полный базовый URL API, включая префикс пути. Это может быть публичный URL Yahont через ваш прокси (https://yahont.example.com/api) или внутрикластерный Service API (http://<release>-api-service.<namespace>.svc.cluster.local:8080, без префикса). Используйте схему и имя хоста, которые разрешаются из прокси песочниц и маршрутизируются к API Yahont. Публичный URL без префикса /api приводит к ошибке при подготовке песочницы с исправленным значением. Установите или обновите Yahont с полными значениями вашего развёртывания:
Замените onyx-values.yaml путём к файлу значений, используемому вашим развёртыванием. Либо сохраните только настройки Craft в отдельном оверлее craft-values.yaml. Передайте сначала значения существующего развёртывания, а затем оверлей Craft, чтобы Helm их объединил:

Планирование ёмкости песочниц

Каждый активный пользователь получает под-песочницу. У основного контейнера песочницы такие значения по умолчанию: Под также включает контейнеры инициализации и sidecar для настройки сети, передачи файлов, снимков и восстановления. Чтобы изменить ресурсы основного контейнера, объедините эти записи configMap со значениями вашего развёртывания или оверлеем Craft:
Используйте sandboxPod.nodeSelector, sandboxPod.tolerations и sandboxPod.affinity, чтобы управлять размещением. У прокси и рабочего процесса запланированных задач отдельные настройки ресурсов в sandboxProxy.resources и celery_worker_scheduled_tasks.resources.

Предварительная загрузка образа песочницы

Когда Craft включён, чарт запускает DaemonSet (sandboxImagePrepull), который заранее загружает образ песочницы на каждый узел песочниц, чтобы первая песочница на узле не ждала загрузки образа. Он включён по умолчанию и занимает около 3,3 ГБ диска на узел песочниц.
Задайте enabled: false на узлах без такого запаса диска. Закрепите global.version на неизменяемом теге при предварительной загрузке; изменяемый тег, такой как latest, остаётся на том дайджесте, который узел загрузил первым.

Проверка развёртывания

Убедитесь, что существуют прокси, шаблон песочницы и рабочий процесс запланированных задач:
После настройки модели и доступа пользователей отправьте запрос в Craft. Должен появиться под-песочница:

Сетевая конфигурация

Поды-песочницы могут отправлять трафик только в DNS и прокси песочниц. Прокси обрабатывает внешние запросы, политики приложений и подстановку учётных данных. В большинстве кластеров достаточно значений чарта по умолчанию. Две схемы кластеров требуют дополнительных значений:
Оставьте включёнными NetworkPolicy исходящего трафика песочниц. Они ограничивают поды-песочницы прокси и DNS и блокируют доступ к link-local метаданным облака через путь прокси.

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

Сначала прочитайте ошибку отрисовки. Убедитесь в Kubernetes 1.33 или новее, SANDBOX_BACKEND: "kubernetes", непустом ONYX_SERVER_URL и auth.sandboxPushSecret.enabled: true с заполненным Secret.
Выполните kubectl -n onyx-sandboxes describe pod <pod-name>. Убедитесь, что хотя бы один узел соответствует sandboxPod.nodeSelector, принимает настроенные taint и tolerations и имеет достаточно CPU, памяти и эфемерного хранилища.
Изучите журналы контейнера sandbox-init и поды прокси. DNS должен разрешать прокси до установки межсетевого экрана песочницы. Кластерам с NodeLocal DNS обычно нужен CIDR его обработчика в craft.dnsExtraCIDRs.
Проверьте ONYX_SERVER_URL (включая префикс /api в публичных URL), DNS, доверие TLS и маршрутизацию от прокси. Не указывайте имя Service из другого кластера или адрес, который прокси не может разрешить.
Выполните kubectl -n onyx logs -l app.kubernetes.io/component=sandbox-proxy --tail=200 и проверьте его доступ к PostgreSQL, Redis, API Yahont и внешним адресам. В dual-stack-кластерах включите sandboxProxy.egressAllowIPv6.

Обзор развёртывания Craft

Сравните варианты Kubernetes и Docker Compose.

Управление Craft

Настройте модели и доступ пользователей после развёртывания.