Холодный апгрейд docker-контейнера из нового образа

Оглавление

Обзор
Процедура апгрейда

Обзор

В случаях, когда обновление через API невозможно, необходимо провести операцию апгрейда с заменой docker-образа и пересозданием контейнера.

Все данные, сохраненные в БД, а также файлы и каталоги в волюмах на хосте, остаются нетронутыми, и после запуска новой версии системы сохраняются и используются.

Процедура апгрейда

Шаг 1. Выяснить текущее имя контейнера с платформой.

Это имя формата "era<Postfix>", заданное при установке системы или при прошлом апгрейде.

Обнаружить его можно, выполнив команду:

docker ps -a

и найдя активный контейнер с указанным форматом имени.

Шаг 2. Сгенерировать строку запуска контейнера.

Для этого выполнить скрипт из инсталлятора - gen_container_cmd_ssh.sh

bash gen_container_cmd_ssh.sh --user=era --host=192.168.10.127 --port=22

Скрипт подключится к серверу и отобразит список контейнеров:

Please, answer some questions about installed instance.

Select container (or enter custom):
     1	era_11
     2	postgres

необходимо указать номер контейнера для которого нужно сгенерировать команду (в примере: 1), после чего будет сгенерирована команда, например:

1
2026.01.27 17:48:27. GenerateCmd. Start script for generate start command for existing era container
2026.01.27 17:48:27. GenerateCmd. Start generate cmd for container: era_11
2026.01.27 17:48:27. GenerateCmd. Command:
docker run --name=era_11 \
           --volume=/opt/era_11/syncroot:/var/lib/era_files/syncroot:rslave \
           --volume=/opt/era_11/era_recpath:/var/lib/era_files/recpath:rslave \
           --volume=/opt/era_11/era_siteshare:/var/lib/era_files/siteshare:rslave \
           --volume=/opt/era_11/c:/var/lib/era_files/c:rslave \
           --volume=/opt/era_11/lib:/var/lib/era:rslave \
           --volume=/opt/era_11/local:/var/lib/era_files/local:rslave \
           --volume=/opt/era_11/era_globalshare:/var/lib/era_files/globalshare:rslave \
           --volume=/opt/era_11/a:/var/lib/era_files/a:rslave \
           --volume=/opt/era_11/b:/var/lib/era_files/b:rslave \
           --volume=/opt/era_11/log:/var/log/era:rslave \
           --volume=/opt/era_11/rectemp:/var/lib/era_files/rectemp:rslave \
           --volume=/opt/era_11/logstore:/var/lib/era_files/logstore:rslave \
           --cap-add=CAP_NET_ADMIN \
           --cap-add=CAP_NET_BIND_SERVICE \
           --cap-add=CAP_NET_RAW \
           --network=host \
           --restart=unless-stopped \
           --env=STARTTYPE=firstinit \
           --env=SRVIP=192.168.10.127 \
           --env=SRVNAME=testsrv \
           --env=PSK=123456 \
           --env=SQLSTR=host:192.168.10.127,port:5451,login:platformpgadmin,pwd:Era_User_pwd,database:postgres \
           --env=GENDOMAIN=tester.ru \
           --tty \
           --detach=true \
           era:v.1

Запомнить сгенерированную длинную команду, она понадобится в пункте 5.

ВАЖНО! Проверить в полученной команде наличие параметра "--restart unless-stopped". Без него контейнер не стартанет после будущего обновления.

ВАЖНО! Перед применением удалить из строки указание volume на localtime и timezone, т.к. начиная с версии 1.9.0 настройка часового пояса происходит внутри контейнера через параметр мастер домена settings.timezone

Пример строк которые нужно удалить:

  --volume=/etc/localtime:/etc/localtime:rprivate \
  --volume=/etc/timezone:/etc/timezone:rprivate \

Шаг 3. Загрузить новый образ

docker load -i <ImageFileName>

заменив "<ImageFileName>" на имя docker-образа с новой версией. Образ имеет имя формата "era_<VERSION>_docker.tar.gz".

Шаг 4. Остановить текущий контейнер

docker container stop <CurrentContainerName>

Шаг 5. Запустить новый контейнер

Выполняем команду из пункта 2, заменив имя контейнера на новое. Например, если оригинальная команда была:

docker run --name era<Postfix1> ...

то она становится:

docker run --name era<Postfix2> ...

Новое имя контейнера необходимо для возможности быстрого отката на предыдущую версию. Второй контейнер с тем же именем не может быть создан и запущен. После запуска и проверки корректности состояния предыдущий контейнер можно удалить.

Шаг 6. Проверить часовой пояс внутри контейнера

Для этого необходимо проверить настройку мастер домена timezone (domain.settings.timezone) и при необходимости указать нужный часовой пояс, после чего перезагрузить систему (или контейнер)