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

Обзор

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

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

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

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

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

docker ps -a

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

Шаг 2. Сгенерировать строку запуска контейнера. Можно вручную собрать из шаблона из инсталлятора или если есть интернет выполнить команду:

docker run --rm -v /var/run/docker.sock:/var/run/docker.sock assaflavie/runlike <CurrentContainerName>

заменив "<CurrentContainerName>" на имя текущего контейнера, выясненное на предыдущем шаге.

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

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

Шаг 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. Установить часовой пояс внутри контейнера

unlink /etc/localtime

ln -s /usr/share/zoneinfo/Europe/Moscow /etc/localtime

Шаг 7. Проверить возможные линки на другие директории

era_meet: в рабочей директории "/var/lib/era/<MeetNode>/"