Перейти к содержанию

3.06.05 Обновление версии

Подготовьте обновление

  1. Получите целевой комплект и описание релиза. В описании релиза проверьте поддерживаемые исходные версии, необходимость промежуточных релизов, действия с миграциями и совместимость СУБД. Не начинайте обновление без подтверждённого пути для вашей версии.
  2. Согласуйте окно недоступности и план возврата.
  3. Сохраните инвентаризацию сервисов, образов и mounts по 3.02.02.
  4. Выполните и проверьте резервное копирование: конфигурация, каждая PostgreSQL БД, MongoDB, Neo4j, постоянные тома, объектное хранилище и аналитика. Копия только сервера приложений не покрывает внешние данные.
  5. Убедитесь, что предыдущие образы доступны по сохранённым ID/digest и есть место для новых образов, дампов и временных файлов миграций.

Результат: подтверждён путь обновления и подготовлен проверенный комплект восстановления.

Примените целевой комплект

  1. Остановите сервисы проекта:
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env stop
  1. Разместите файлы целевого релиза. Перенесите параметры своей установки: адреса, секреты, TLS, LDAP/Kerberos, custom CSS, ограничения портов и ротацию журналов. Не заменяйте .env файлом другой установки.
  2. Загрузите образы одним из способов:
# Из архива закрытого контура
sudo docker load -i /opt/distr/<АРХИВ_ОБРАЗОВ>

# Либо из реестра
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env pull
  1. Проверьте конфигурацию и соответствие образов целевому комплекту:
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
  1. Выполните обязательные предварительные действия из описания целевого релиза, затем запустите комплект:
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.

Проверьте обновление

  1. Убедитесь, что нет циклических перезапусков, ошибок миграций и подключений к хранилищам.
  2. Проверьте Nginx:
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env exec -T nginx nginx -t
  1. Проверьте портал, TLS, API, WebSocket, внутренний вход и корпоративный SSO.
  2. Проверьте пользователей, роли, карточки, графовые связи, загрузку файлов, отчёты, Discovery и фоновые операции.
  3. Зафиксируйте результаты и версии. До завершения приёмки не удаляйте предыдущие образы и копии.

Верните предыдущую версию при неуспешном обновлении

Простая замена тегов не отменяет миграции и может быть несовместима с новой схемой данных. Откат выполняется восстановлением согласованного состояния до обновления.

  1. Остановите трафик и сервисы, сохраните журналы неуспешного обновления.
  2. Выберите комплект конфигурации, БД, volumes и объектного хранилища одной даты либо согласованные копии всех затронутых узлов.
  3. Восстановите предыдущие конфигурацию, образы и данные по 3.06.04. Не запускайте старые сервисы поверх мигрированной БД.
  4. Выполните приёмку восстановления и только после неё верните доступ пользователям.

Изменения после даты копии будут потеряны. Сохраните их при необходимости отдельно до начала восстановления.

Результат: целевой релиз принят либо восстановлен проверенный предыдущий комплект данных и образов.