Обновление Docker-контейнера

Обновление MikoPBX, запущенной в Docker или Docker Compose

Рекомендуется производить обновления последовательно, «не перепрыгивая» через релизы и версии.

Docker-контейнер MikoPBX не обновляется файлами .img или .iso. Для перехода на новую версию нужно скачать новый Docker image и пересоздать контейнер, сохранив каталоги /cf, /storage, сетевые параметры и переменные окружения.

Подготовка

1. Создайте резервную копию настроек MikoPBX. Если модуль резервного копирования недоступен в непривилегированном контейнере, подготовьте резервное копирование каталогов или volumes на стороне Docker-хоста.

2. Запишите имя и версию текущего image:

sudo docker inspect mikopbx --format '{{.Config.Image}}'

1. Сохраните текущую конфигурацию контейнера:

sudo docker inspect mikopbx > mikopbx-container-before-update.json

1. Проверьте подключения /cf и /storage:

sudo docker inspect mikopbx --format '{{range .Mounts}}{{println .Source "->" .Destination}}{{end}}'

1. Запишите используемые порты, network_mode, hostname и переменные окружения. Если контейнер запускается через Compose, сохраните актуальный docker-compose.yml и файл .env.

2. Завершите активные вызовы и запланируйте техническое окно.

Обновление контейнера, запущенного командой docker run

Загрузка нового image

Для последней стабильной версии выполните:

sudo docker pull ghcr.io/mikopbx/mikopbx:latest

Если используется фиксированный тег, укажите тот же registry и тег нужной версии вместо latest.

Остановка и замена контейнера

1. Остановите контейнер:

sudo docker stop mikopbx

1. Создайте консистентную резервную копию /cf, пока контейнер остановлен. Для bind mount из примера выше можно выполнить:

sudo tar -C /var/spool/mikopbx -czf mikopbx-cf-before-update.tar.gz cf

Помимо /cf, новую версию стоит подстраховать бэкапом базы CDR — она лежит в /storage и при первом старте тоже может быть мигрирована. В /cf находится только mikopbx.db (настройки), а история звонков — это отдельная cdr.db (и recording_storage.db) в /storage/usbdisk1/mikopbx/astlogs/asterisk/.

Бэкап делается на остановленном контейнере (как и для /cf), чтобы база была в согласованном состоянии:

sudo docker stop mikopbx# бэкап /cf (настройки)sudo tar -C /var/spool/mikopbx -czf mikopbx-cf-before-update.tar.gz cf# бэкап CDR + метаданных записейsudo tar -C /var/spool/mikopbx/storage/usbdisk1/mikopbx \  -czf mikopbx-cdr-before-update.tar.gz astlogs/asterisk

При откате восстанавливайте оба архива: сначала /cf, затем CDR - иначе история звонков и привязка записей к звонкам могут рассинхронизироваться с настройками.

1. Переименуйте старый контейнер вместо немедленного удаления:

sudo docker rename mikopbx mikopbx-before-update

1. Запустите новый контейнер с теми же параметрами. Пример для установки с host network и bind mounts:

sudo docker run --net=host --name mikopbx --hostname mikopbx \
  -v /var/spool/mikopbx/cf:/cf \
  -v /var/spool/mikopbx/storage:/storage \
  -e SSH_PORT=23 \
  -e ID_WWW_USER="$(id -u www-user)" \
  -e ID_WWW_GROUP="$(id -g www-user)" \
  -it -d --restart always ghcr.io/mikopbx/mikopbx:latest

Пример нельзя копировать без проверки. Повторите все параметры именно вашей прежней установки: тип сети, volumes, порты, hostname, capabilities и переменные окружения.

1. Следите за запуском:

sudo docker logs -f mikopbx

Для выхода из просмотра логов нажмите Ctrl+C — контейнер продолжит работу.

Обновление с Docker Compose

1. Перейдите в каталог с docker-compose.yml.

2. Если идентификаторы пользователя передаются через окружение, задайте их так же, как при первом запуске:

export ID_WWW_USER=$(id -u www-user)
export ID_WWW_GROUP=$(id -g www-user)

1. Загрузите новый image:

sudo docker compose pull

1. Пересоздайте контейнер:

sudo docker compose up -d

1. Проверьте состояние и логи:

sudo docker compose ps
sudo docker compose logs -f mikopbx

Docker Compose пересоздаст контейнер, но сохранит bind mounts и именованные volumes, указанные в docker-compose.yml.

Проверка после обновления

1. Убедитесь, что контейнер работает:

sudo docker ps --filter name=mikopbx

1. Откройте web-интерфейс и проверьте версию MikoPBX.

2. Проверьте наличие настроек и записей разговоров.

3. Убедитесь, что телефоны и SIP-провайдеры зарегистрировались.

4. Выполните входящий и исходящий тестовые звонки.

5. Проверьте публикацию web-, SIP- и RTP-портов, если используется bridge network.

Откат

Если новый контейнер не запускается:

1. Сохраните его логи:

sudo docker logs mikopbx > mikopbx-update-error.log 2>&1

1. Остановите и переименуйте новый контейнер:

sudo docker stop mikopbx
sudo docker rename mikopbx mikopbx-failed-update

1. Восстановите резервную копию /cf, созданную до обновления. Способ восстановления зависит от того, используется bind mount, именованный volume или snapshot системы хранения.

2. Верните прежнее имя старому контейнеру и запустите его:

sudo docker rename mikopbx-before-update mikopbx
sudo docker start mikopbx

После первого запуска новая версия могла обновить базу данных в /cf. Поэтому надёжный откат должен опираться не только на старый container image, но и на резервную копию /cf, созданную до обновления.

Для отката установки Docker Compose укажите в docker-compose.yml предыдущий тег image, восстановите предыдущее состояние /cf и снова выполните:

sudo docker compose up -d

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

sudo docker rm mikopbx-before-update