Требования
- Kubernetes 1.33 или новее
- Полное развёртывание Yahont с Helm с включённой векторной базой данных
- Узлы с достаточным CPU, памятью и эфемерным хранилищем для активных песочниц
- URL, по которому поды-песочницы могут обратиться к API Yahont
kubernetes,
когда ONYX_SERVER_URL пуст или когда не настроена аутентификация push в песочницы.
Подготовка узлов песочниц
По умолчанию поды-песочницы выбирают узлы с такой меткой:sandboxPod.nodeSelector селектором,
подходящим для вашего кластера.
Создание Secret для push в песочницу
Craft использует ключ Ed25519 для аутентификации передачи файлов и истории в поды-песочницы. Создайте ключ и сохраните его в пространстве имён Yahont:Настройка 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,
остаётся на том дайджесте, который узел загрузил первым.
Проверка развёртывания
Убедитесь, что существуют прокси, шаблон песочницы и рабочий процесс запланированных задач:Сетевая конфигурация
Поды-песочницы могут отправлять трафик только в DNS и прокси песочниц. Прокси обрабатывает внешние запросы, политики приложений и подстановку учётных данных. В большинстве кластеров достаточно значений чарта по умолчанию. Две схемы кластеров требуют дополнительных значений:Устранение неполадок
Helm отклоняет конфигурацию Craft
Helm отклоняет конфигурацию Craft
Сначала прочитайте ошибку отрисовки. Убедитесь в Kubernetes 1.33 или новее,
SANDBOX_BACKEND: "kubernetes",
непустом ONYX_SERVER_URL и auth.sandboxPushSecret.enabled: true с заполненным Secret.Поды-песочницы остаются в Pending
Поды-песочницы остаются в Pending
Выполните
kubectl -n onyx-sandboxes describe pod <pod-name>. Убедитесь,
что хотя бы один узел соответствует sandboxPod.nodeSelector,
принимает настроенные taint и tolerations и имеет достаточно CPU, памяти и эфемерного хранилища.Песочница завершается ошибкой при инициализации
Песочница завершается ошибкой при инициализации
Изучите журналы контейнера
sandbox-init и поды прокси.
DNS должен разрешать прокси до установки межсетевого экрана песочницы.
Кластерам с NodeLocal DNS обычно нужен CIDR его обработчика в craft.dnsExtraCIDRs.Craft не может обратиться к API Yahont
Craft не может обратиться к API Yahont
Проверьте
ONYX_SERVER_URL (включая префикс /api в публичных URL), DNS, доверие TLS и маршрутизацию от прокси.
Не указывайте имя Service из другого кластера или адрес, который прокси не может разрешить.Прокси песочниц не Ready
Прокси песочниц не Ready
Выполните
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
Настройте модели и доступ пользователей после развёртывания.

