3.06.05 Обновление версии
Подготовьте обновление
- Получите целевой комплект и описание релиза. В описании релиза проверьте поддерживаемые исходные версии, необходимость промежуточных релизов, действия с миграциями и совместимость СУБД. Не начинайте обновление без подтверждённого пути для вашей версии.
- Согласуйте окно недоступности и план возврата.
- Сохраните инвентаризацию сервисов, образов и mounts по 3.02.02.
- Выполните и проверьте резервное копирование: конфигурация, каждая PostgreSQL БД, MongoDB, Neo4j, постоянные тома, объектное хранилище и аналитика. Копия только сервера приложений не покрывает внешние данные.
- Убедитесь, что предыдущие образы доступны по сохранённым ID/digest и есть место для новых образов, дампов и временных файлов миграций.
Результат: подтверждён путь обновления и подготовлен проверенный комплект восстановления.
Примените целевой комплект
- Остановите сервисы проекта:
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env stop
- Разместите файлы целевого релиза. Перенесите параметры своей установки: адреса, секреты, TLS, LDAP/Kerberos, custom CSS, ограничения портов и ротацию журналов. Не заменяйте
.envфайлом другой установки. - Загрузите образы одним из способов:
# Из архива закрытого контура
sudo docker load -i /opt/distr/<АРХИВ_ОБРАЗОВ>
# Либо из реестра
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env pull
- Проверьте конфигурацию и соответствие образов целевому комплекту:
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env config --quiet
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env config --images
- Выполните обязательные предварительные действия из описания целевого релиза, затем запустите комплект:
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env up -d
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env ps -a
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env logs --since 10m --tail 200
Миграции выполняются предусмотренными релизом механизмами. Не повторяйте их вручную, не выполняйте первичную инициализацию из 3.02.01 и не удаляйте volumes при ошибке. Для перехода между основными версиями PostgreSQL, MongoDB, Neo4j или Keycloak используйте отдельную процедуру релиза.
Kafka в типовом комплекте является временной очередью. Перед пересозданием дождитесь обработки накопленных сообщений либо зафиксируйте возможность повторного формирования задач Discovery.
Проверьте обновление
- Убедитесь, что нет циклических перезапусков, ошибок миграций и подключений к хранилищам.
- Проверьте Nginx:
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env exec -T nginx nginx -t
- Проверьте портал, TLS, API, WebSocket, внутренний вход и корпоративный SSO.
- Проверьте пользователей, роли, карточки, графовые связи, загрузку файлов, отчёты, Discovery и фоновые операции.
- Зафиксируйте результаты и версии. До завершения приёмки не удаляйте предыдущие образы и копии.
Верните предыдущую версию при неуспешном обновлении
Простая замена тегов не отменяет миграции и может быть несовместима с новой схемой данных. Откат выполняется восстановлением согласованного состояния до обновления.
- Остановите трафик и сервисы, сохраните журналы неуспешного обновления.
- Выберите комплект конфигурации, БД, volumes и объектного хранилища одной даты либо согласованные копии всех затронутых узлов.
- Восстановите предыдущие конфигурацию, образы и данные по 3.06.04. Не запускайте старые сервисы поверх мигрированной БД.
- Выполните приёмку восстановления и только после неё верните доступ пользователям.
Изменения после даты копии будут потеряны. Сохраните их при необходимости отдельно до начала восстановления.
Результат: целевой релиз принят либо восстановлен проверенный предыдущий комплект данных и образов.