Релизы и окружения

Проверьте серверный комплект

Команды регистрации и переключения версий ниже относятся к локальному кандидату нового установщика. Их поставка на действующие серверы пока не подтверждена. Прежде чем выполнять их, получите и примите соответствующий комплект у сопровождающего. Применимость инструкции.

Релиз связывает удобное имя версии с проверенным неизменяемым образом приложения. Окружение определяет, где этот релиз работает и какие данные, секреты и внешние системы ему доступны. Одинаковое имя версии не делает две установки одним окружением.

Окружение	Назначение
DEV	Разработка и первичные проверки изменений
STAGE	Приёмка подготовленного релиза и его эксплуатационных сценариев
Production	Работа пользователей с действующими данными

У каждой установки должны быть отдельные Compose-проект, PostgreSQL 17, файловое хранилище и доступы. Тестовые сообщения и webhook направляйте на тестовые получатели. Старое имя каталога или скрипта не определяет роль окружения: проверяйте актуальную схему размещения перед каждой операцией.

Регистрация версии

cd /opt/ngensia/deploy
sh ngensia.sh release-add VERSION IMAGE_DIGEST
sh ngensia.sh history

Замените обозначения согласованным именем и digest образа. Повторно назначить тому же имени другой образ нельзя. Регистрация проверяет совпадение инфраструктурных файлов образа и установленного комплекта. Если образ совпадает с текущим APP_IMAGE, дополнительно проверяется готовность app и сохраняется исходная успешная запись со схемой базы.

release-add не выполняет сборку, публикацию в registry или выкладку. Для переключения используется обновление. Закрепляйте также образы PostgreSQL и Caddy из квалифицированного комплекта; плавающий latest не обеспечивает повторяемость восстановления.

Приёмка и учёт

До production зафиксируйте целевую версию, исходный образ, результат STAGE-проверки, копию перед обновлением и ответственного за решение. После переключения проверьте HTTPS, вход, согласованные операции, вложения и нужные интеграции. История ready подтверждает внутреннюю готовность в рамках команды, но не заменяет эту приёмку.

Не переносите рабочие секреты в репозиторий и не подключайте тестовую установку к production-базе. Отдельно проверяйте bucket/prefix и remote резервных копий: ошибка назначения опасна даже при разных именах контейнеров.

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

Откат версии · Резервное копирование · Параметры установки