Обновление из контейнеров

Обзор

В этом разделе описаны действия, необходимые для успешного обновления контейнеров 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