Настройки приложения можно вести через Deployment UI и дополнять custom-файлами. Этот раздел объясняет, что меняет конфигурацию, что создаёт файлы и когда изменения попадают на сервер.
Настройки окружения
| Путь | Владелец и назначение |
|---|---|
deploy/generated/environments/ENV_NAME.json |
Генератор: полный профиль из UI |
deploy/custom/environments/ENV_NAME.json |
Ваша команда: частичное переопределение профиля |
deploy/environments/ENV_NAME.json |
Ваша команда: необязательный полный ручной профиль, который имеет приоритет над обоими файлами выше |
ENV_NAME — имя вашего профиля, например production или test. Это не имя проекта и не тип размещения. После Save → Generate custom-файл уже создан; {} означает «оставить настройки UI». Копировать generated-файл в deploy/environments для обычной работы не требуется.
Добавить переопределение
Пример для custom-файла выбранного профиля:
{
"allowedOrigins": [
"https://admin.example.com",
"https://app.example.com"
]
}
Замените домены своими. Массив заменяется целиком, вложенные объекты объединяются по полям, null удаляет свойство. Не меняйте schemaVersion, project, environment и не добавляйте неизвестные поля. Полный результат проверьте через Preview effective JSON. Пароли и токены в эти файлы не кладут.
Если старый ручной файл скрывает правки UI, импортируйте его в настройки, сохраните и сгенерируйте проект, затем сами перенесите ручной файл за пределы deploy/environments. Генератор не удаляет его молча.
Свои CI-задания и сборка frontend
Для GitLab дополнительные jobs находятся в deploy/custom/gitlab.yml; generated CI включает этот файл. Не правьте .gitlab/admingen.yml и .gitlab-ci.yml, которые принадлежат генератору. Для GitHub используйте отдельные workflows с собственными именами. Настройки Vite расширяются через admin/custom/vite.ts.
Source CI берёт код и профиль из конкретного коммита pipeline. Незакоммиченные правки серверного checkout не попадут в релиз. Необязательная защищённая File-переменная ADMINGEN_ENVIRONMENT_JSON полностью перекрывает профиль; удалите устаревший override, если хотите использовать UI и custom из Git.
Когда сервер изменится
Generate пишет локальные файлы, но не запускает deploy. Обычный новый код публикуется через build/deploy. Смену поддерживаемых параметров доставки и backup уже работающего окружения выполняют через reconfigure; оно не переносит домены, топологию, БД и хранилища.
Дальше: Deployment UI, GitLab CI, Команды окружения.