Требования
- Полное развёртывание Yahont в Docker Compose
- Docker Engine с Compose
- Хост с ёмкостью для стека Yahont и активных контейнеров-песочниц
- URL Yahont, доступный через прокси песочниц
Новое развёртывание
Запустите установщик Yahont CLI с оверлеем Craft:docker-compose.craft.yml, включает Craft, выбирает бэкенд песочниц Docker,
создаёт мостовую сеть песочниц и том CA прокси и запускает развёртывание.
В примерах ниже используется каталог развёртывания CLI по умолчанию. Для развёртывания,
созданного старой версией скрипта
install.sh, замените ~/.config/onyx каталогом onyx_data (например,
onyx_data/deployment/.env).~/.config/onyx/deployment/.env и задайте URL Yahont:
Существующее развёртывание
ЗадайтеONYX_SERVER_URL в .env существующего развёртывания, затем снова запустите установщик:
.env:
ENABLE_CRAFT=true без оверлея недостаточно. Оверлей монтирует сокет Docker,
запускает прокси песочниц и подключает API-сервер и фоновый рабочий процесс к сети песочниц.
Задайте URL Yahont
Для продакшена используйте публичный HTTPS-URL, по которому пользователи открывают Yahont:api_server и nginx, не разрешаются из изолированного моста песочниц.
Планирование ёмкости хоста
По умолчанию песочницы Docker получают по одному CPU и 2 ГБ памяти:SANDBOX_IDLE_TIMEOUT_SECONDS,
если нужна более быстрая очистка или более долгоживущие песочницы.
Образ песочницы следует за IMAGE_TAG. Держите бэкенд Yahont и песочницу на одном релизе.
В обычных развёртываниях не следует задавать SANDBOX_CONTAINER_IMAGE отдельно.
Сборка Craft из исходного кода
docker compose up --build собирает сервисы Yahont, объявленные в файлах Compose. Он не собирает образ песочницы Craft,
потому что песочницы создаются API-сервером динамически, а не запускаются как сервис Compose.
Из корня исходного репозитория Yahont отдельно соберите образ песочницы с локальным неизменяемым тегом:
.env, используемом вашим исходным репозиторием:
IMAGE_TAG не собирает соответствующий образ onyxdotapp/sandbox:${IMAGE_TAG}.
Либо соберите этот тег песочницы отдельно, либо задайте SANDBOX_CONTAINER_IMAGE явно.
Пересоздайте api_server и background после изменения настройки.
Существующие контейнеры sandbox-* продолжают использовать образ, с которым были созданы,
и для использования нового образа их нужно завершить и подготовить заново.
Если вы запускаете из подготовленного каталога, например onyx_data/deployment,
скопируйте настройку в .env этого каталога. В подготовленных каталогах развёртывания нет исходного репозитория,
которого ожидают контексты сборки Compose, поэтому используйте уже собранные или опубликованные образы с --no-build.
Проверка развёртывания
Убедитесь, что основные сервисы и прокси работают:background включает рабочий процесс запланированных задач; отдельный сервис Compose не нужен.
Сеть и безопасность хоста
Контейнеры-песочницы подключаются только к внешнему мостуonyx_craft_sandbox. Они не могут разрешать PostgreSQL,
Redis, объектное хранилище или API-сервер по имени сервиса Compose.
Их исходящий трафик HTTP и HTTPS проходит через sandbox-proxy,
который применяет политики приложений и подставляет учётные данные после одобрения запроса.
Полную модель доверия и сети см. в разделе Архитектура Craft.
Устранение неполадок
Craft не появляется после изменения окружения
Craft не появляется после изменения окружения
Убедитесь, что заданы
ENABLE_CRAFT=true и SANDBOX_BACKEND=docker,
затем пересоздайте API-сервер и веб-приложение. Включите в команду Compose оба файла:
docker-compose.yml и docker-compose.craft.yml.Подготовка песочницы сообщает, что ONYX_SERVER_URL отсутствует
Подготовка песочницы сообщает, что ONYX_SERVER_URL отсутствует
Задайте значение в
.env каталога развёртывания и пересоздайте API-сервер,
фоновый рабочий процесс и прокси песочниц с оверлеем Craft.Настроенный URL Yahont использует имя хоста Compose
Настроенный URL Yahont использует имя хоста Compose
Замените
api_server, nginx или другое имя хоста, существующее только в Compose,
публичным URL Yahont или адресом хоста, доступным из контейнеров Docker.Прокси песочниц нездоров
Прокси песочниц нездоров
Выполните
docker compose -f docker-compose.yml -f docker-compose.craft.yml logs sandbox-proxy.
Проверьте ONYX_SERVER_URL, доступность PostgreSQL и Redis, том sandbox_proxy_ca и доступ к сокету Docker.Сеть песочниц или том CA отсутствует
Сеть песочниц или том CA отсутствует
Повторно выполните
onyx-cli deploy install --include-craft. Если автоматическое создание не удалось,
создайте ресурсы и перезапустите развёртывание:Песочница завершается или убивается при больших задачах
Песочница завершается или убивается при больших задачах
Проверьте журналы контейнера песочницы и нагрузку на память хоста.
Увеличивайте
SANDBOX_DOCKER_MEMORY_LIMIT или SANDBOX_DOCKER_CPU_LIMIT только когда у хоста достаточно ёмкости
для каждой одновременной песочницы.Обзор развёртывания Craft
Сравните варианты Docker Compose и Kubernetes.
Управление Craft
Настройте модели и доступ пользователей после развёртывания.

