Обновление из контейнеров
Обзор
В этом разделе описаны действия, необходимые для успешного обновления контейнеров Zabbix до версии 8.2.x.
Доступны отдельные наборы инструкций для:
Перед обновлением обязательно ознакомьтесь с соответствующими примечаниями к обновлению!
Перед началом обновления убедитесь, что пользователи имеют необходимые разрешения для базы данных, требуемые для выполнения обновления.
При обновлении с Zabbix 6.0 или более ранней версии во время обновления потребуется создать детерминированные триггеры.
Если для MySQL/MariaDB включено двоичное журналирование, это требует привилегий суперпользователя или установки переменной/параметра конфигурации log_bin_trust_function_creators = 1.
Инструкции по установке переменной см. в разделе Скрипты создания базы данных.
Обратите внимание: при выполнении из консоли переменная будет установлена только временно и сброшена после перезапуска Docker.
В этом случае оставьте службу SQL запущенной, остановите только службу zabbix-server, выполнив docker compose down zabbix-server, а затем запустите ее командой docker compose up -d zabbix-server.
Также можно задать эту переменную в файле конфигурации.
В зависимости от размера базы данных ее обновление до версии 8.2 может занять много времени.
Обновление образа компонента Zabbix
Эти инструкции предназначены для обновления образов Docker, используемых в качестве основы для контейнеров компонентов Zabbix.
В приведенных ниже шагах в качестве примера используется прокси Zabbix.
Замените zabbix-proxy-sqlite3 именем контейнера вашего компонента.
1. Проверьте все контейнеры, чтобы определить их имена и текущие версии образов:
docker ps -a
# CONTAINER ID IMAGE (...) NAMES
# 5a0c2e3d02b4 zabbix/zabbix-proxy-sqlite3:alpine-8.2-latest (...) zabbix-proxy-sqlite3
2. Загрузите новую версию образа:
docker pull zabbix/zabbix-proxy-sqlite3:alpine-8.2-latest
3. Остановите контейнер компонента Zabbix:
docker stop zabbix-proxy-sqlite3
4. Удалите контейнер компонента Zabbix:
Перед продолжением обязательно запишите все флаги конфигурации и подключения томов, использованные в исходной команде docker run, поскольку они потребуются для повторного создания контейнера.
docker rm zabbix-proxy-sqlite3
5. Запустите новый контейнер с использованием обновленного образа:
docker run --name zabbix-proxy-sqlite3 \
-e ZBX_SERVER_HOST=192.0.2.1 \
-e ZBX_PROXYMODE=0 \
-e ZBX_HOSTNAME=zabbix-proxy-sqlite3 \
-v zabbix-proxy-data:/var/lib/zabbix/db_data \
--init \
-d \
zabbix/zabbix-proxy-sqlite3:alpine-8.2-latest
Дополнительную информацию о запуске контейнеров Zabbix см. в разделе Docker (ручное развертывание).
6. Убедитесь, что обновление выполнено успешно, проверив журналы контейнера:
docker logs -f zabbix-proxy-sqlite3
Обновление файла Docker Compose
Эти инструкции предназначены для обновления файлов Docker Compose, используемых для развертывания компонентов Zabbix. Следуйте этим инструкциям, если вы установили Zabbix с помощью Docker Compose.
1. Проверьте все контейнеры, чтобы определить их имена и текущие версии образов:
docker ps -a
# CONTAINER ID IMAGE (...) NAMES
# d095f486deef zabbix/zabbix-server-mysql:alpine-8.0-latest (...) zabbix-docker-zabbix-server-1
# 70627d833da0 zabbix/zabbix-web-nginx-mysql:alpine-8.0-latest (...) zabbix-docker-zabbix-web-nginx-mysql-1
# aaaa664cc185 zabbix/zabbix-server-mysql:alpine-8.0-latest (...) zabbix-docker-server-db-init-1
# 9ab3e77492ff mysql:8.0-oracle (...) zabbix-docker-mysql-server-1
2. Перейдите в репозиторий Zabbix Docker, который вы ранее клонировали, загрузите последние обновления и переключитесь на ветку 8.2:
Если вы изменяли .env, compose.yaml или другие файлы в локальном репозитории, команда git pull может перезаписать их.
Перед выполнением этого шага создайте резервную копию всех локальных изменений.
cd zabbix-docker
git pull
git checkout 8.2
3. Разверните компоненты Zabbix с помощью обновленного файла Docker Compose:
# С MySQL в качестве базы данных:
docker compose -f ./compose.yaml up -d
# С PostgreSQL в качестве базы данных:
docker compose -f ./compose_pgsql.yaml up -d
После пересоздания и запуска всех контейнеров может пройти 1–3 минуты, прежде чем сбор данных возобновится. Дополнительную информацию о запуске контейнеров Zabbix см. в разделе Docker Compose.
4. Убедитесь, что обновление выполнено успешно, проверив журналы контейнера (замените zabbix-docker-zabbix-server-1 именем контейнера компонента):
docker logs -f zabbix-docker-zabbix-server-1