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

Обзор

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

Обновление образа компонента Zabbix

Эти инструкции описывают обновление Docker-образов, используемых в качестве основы для контейнеров компонентов Zabbix.

В приведенных ниже шагах в качестве примера используется прокси Zabbix. Замените zabbix-proxy-sqlite3 на имя контейнера вашего компонента.

1. Проверьте все контейнеры, чтобы определить их имена и текущие версии образов:

docker ps -a

# CONTAINER ID   IMAGE                                           (...) NAMES
# 5a0c2e3d02b4   zabbix/zabbix-proxy-sqlite3:alpine-7.4-latest   (...) zabbix-proxy-sqlite3

2. Загрузите новую версию образа:

docker pull zabbix/zabbix-proxy-sqlite3:alpine-8.0-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.0 \
  -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.0-latest

Дополнительную информацию о запуске контейнеров Zabbix см. в разделе Docker (manual deployment).

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-7.4-latest      (...) zabbix-docker-zabbix-server-1
# 70627d833da0   zabbix/zabbix-web-nginx-mysql:alpine-7.4-latest   (...) zabbix-docker-zabbix-web-nginx-mysql-1
# aaaa664cc185   zabbix/zabbix-server-mysql:alpine-7.4-latest      (...) zabbix-docker-server-db-init-1
# 9ab3e77492ff   mysql:8.0-oracle                                  (...) zabbix-docker-mysql-server-1

2. Перейдите в ранее клонированный репозиторий Zabbix Docker, получите последние обновления и переключитесь на ветку 8.0:

Если вы изменяли .env, compose.yaml или другие файлы в локальном репозитории, команда git pull может перезаписать их. Перед выполнением этого шага создайте резервную копию всех локальных изменений.

cd zabbix-docker
git pull
git checkout 8.0

3. Разверните компоненты Zabbix с помощью обновленного файла Docker Compose:

# With MySQL as the database:
docker compose -f ./compose.yaml up -d

# With PostgreSQL as the database:
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