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

Обзор

В этом разделе описывается, как развернуть Zabbix с помощью Docker или Docker Compose.

Zabbix официально предоставляет:

• Отдельные Docker-образы для каждого компонента Zabbix, чтобы запускать их как переносимые и самодостаточные контейнеры.
• Файлы Compose для определения и запуска многоконтейнерных компонентов Zabbix в Docker.

Исходные файлы

Исходные файлы Dockerfile хранятся в официальном репозитории Zabbix на GitHub, где вы можете отслеживать последние изменения файлов или создать форк проекта, чтобы собирать собственные образы.

Docker

Zabbix предоставляет образы на основе различных базовых образов ОС. Чтобы получить список поддерживаемых образов базовых операционных систем для конкретного компонента Zabbix, смотрите описание компонента в Docker Hub. Все образы Zabbix настроены на пересборку последних образов при обновлении базовых образов.

Установка

Чтобы получить образ компонента Zabbix, выполните:

docker pull zabbix/zabbix-server-mysql

Замените zabbix/zabbix-server-mysql именем требуемого docker-репозитория.

Эта команда загрузит последнюю стабильную версию компонента Zabbix на основе ОС Alpine Linux. Вы можете добавить теги к имени репозитория, чтобы получить образ на основе другой операционной системы или конкретной основной либо промежуточной версии Zabbix.

В Docker Hub доступны следующие репозитории:

Теги

Официальные образы компонентов Zabbix могут содержать следующие теги:

Начальная настройка

После загрузки образов запустите контейнеры, выполнив команду docker run с дополнительными аргументами для указания необходимых переменных окружения и/или точек монтирования. Ниже приведены некоторые примеры настройки.

Переменные окружения

Все образы компонентов Zabbix предоставляют переменные окружения для управления конфигурацией. Поддерживаемые переменные окружения перечислены в репозитории компонентов.

Эти переменные окружения являются параметрами из файлов конфигурации Zabbix, но используют другой способ именования. Например, ZBX_LOGSLOWQUERIES эквивалентен LogSlowQueries из файлов конфигурации Zabbix сервера или Zabbix прокси.

Следующие переменные окружения относятся только к компонентам Docker и отсутствуют в файлах конфигурации Zabbix:

Тома

Образы позволяют монтировать тома, используя следующие точки монтирования:

Для получения дополнительной информации см. официальные репозитории Zabbix в Docker Hub.

Примеры

Пример 1

В этом примере показано, как запустить сервер Zabbix с поддержкой базы данных MySQL, веб-интерфейс Zabbix на базе веб-сервера Nginx и Zabbix Java gateway.

1. Создайте сеть, выделенную для контейнеров компонентов Zabbix:

docker network create --subnet 172.20.0.0/16 --ip-range 172.20.240.0/20 zabbix-net

2. Запустите пустой экземпляр сервера MySQL:

docker run --name mysql-server -t \
    -e MYSQL_DATABASE="zabbix" \
    -e MYSQL_USER="zabbix" \
    -e MYSQL_PASSWORD="zabbix_pwd" \
    -e MYSQL_ROOT_PASSWORD="root_pwd" \
    --network=zabbix-net \
    --restart unless-stopped \
    -d mysql:8.4-oracle \
    --character-set-server=utf8 --collation-server=utf8_bin \
    --default-authentication-plugin=caching_sha2_password

3. Запустите экземпляр Zabbix Java gateway:

docker run --name zabbix-java-gateway -t \
    --network=zabbix-net \
    --restart unless-stopped \
    -d zabbix/zabbix-java-gateway:alpine-8.0-latest

4. Запустите экземпляр сервера Zabbix и свяжите его с созданным экземпляром сервера MySQL:

docker run --name zabbix-server-mysql -t \
    -e DB_SERVER_HOST="mysql-server" \
    -e MYSQL_DATABASE="zabbix" \
    -e MYSQL_USER="zabbix" \
    -e MYSQL_PASSWORD="zabbix_pwd" \
    -e MYSQL_ROOT_PASSWORD="root_pwd" \
    -e ZBX_JAVAGATEWAY="zabbix-java-gateway" \
    --network=zabbix-net \
    -p 10051:10051 \
    --restart unless-stopped \
    -d zabbix/zabbix-server-mysql:alpine-8.0-latest

5. Запустите веб-интерфейс Zabbix и свяжите его с созданными экземплярами сервера MySQL и сервера Zabbix:

docker run --name zabbix-web-nginx-mysql -t \
    -e ZBX_SERVER_HOST="zabbix-server-mysql" \
    -e DB_SERVER_HOST="mysql-server" \
    -e MYSQL_DATABASE="zabbix" \
    -e MYSQL_USER="zabbix" \
    -e MYSQL_PASSWORD="zabbix_pwd" \
    -e MYSQL_ROOT_PASSWORD="root_pwd" \
    --network=zabbix-net \
    -p 80:8080 \
    --restart unless-stopped \
    -d zabbix/zabbix-web-nginx-mysql:alpine-8.0-latest

Пример 2

В этом примере показано, как запустить сервер Zabbix с поддержкой базы данных PostgreSQL, веб-интерфейс Zabbix на базе веб-сервера Nginx и функцией SNMP trap.

1. Создайте сеть, выделенную для контейнеров компонентов Zabbix:

docker network create --subnet 172.20.0.0/16 --ip-range 172.20.240.0/20 zabbix-net

2. Запустите пустой экземпляр сервера PostgreSQL:

docker run --name postgres-server -t \
      -e POSTGRES_USER="zabbix" \
      -e POSTGRES_PASSWORD="zabbix_pwd" \
      -e POSTGRES_DB="zabbix" \
      --network=zabbix-net \
      --restart unless-stopped \
      -d postgres:latest

3. Запустите экземпляр Zabbix snmptraps:

docker run --name zabbix-snmptraps -t \
    -v /zbx_instance/snmptraps:/var/lib/zabbix/snmptraps:rw \
    -v /var/lib/zabbix/mibs:/usr/share/snmp/mibs:ro \
    --network=zabbix-net \
    -p 162:1162/udp \
    --restart unless-stopped \
    -d zabbix/zabbix-snmptraps:alpine-8.0-latest

4. Запустите экземпляр сервера Zabbix и свяжите его с созданным экземпляром сервера PostgreSQL:

docker run --name zabbix-server-pgsql -t \
    -e DB_SERVER_HOST="postgres-server" \
    -e POSTGRES_USER="zabbix" \
    -e POSTGRES_PASSWORD="zabbix_pwd" \
    -e POSTGRES_DB="zabbix" \
    -e ZBX_ENABLE_SNMP_TRAPS="true" \
    --network=zabbix-net \
    -p 10051:10051 \
    --volumes-from zabbix-snmptraps \
    --restart unless-stopped \
    -d zabbix/zabbix-server-pgsql:alpine-8.0-latest

5. Запустите веб-интерфейс Zabbix и свяжите его с созданными экземплярами сервера PostgreSQL и сервера Zabbix:

docker run --name zabbix-web-nginx-pgsql -t \
    -e ZBX_SERVER_HOST="zabbix-server-pgsql" \
    -e DB_SERVER_HOST="postgres-server" \
    -e POSTGRES_USER="zabbix" \
    -e POSTGRES_PASSWORD="zabbix_pwd" \
    -e POSTGRES_DB="zabbix" \
    --network=zabbix-net \
    -p 443:8443 \
    -p 80:8080 \
    -v /etc/ssl/nginx:/etc/ssl/nginx:ro \
    --restart unless-stopped \
    -d zabbix/zabbix-web-nginx-pgsql:alpine-8.0-latest

Пример 3

В этом примере показано, как запустить сервер Zabbix с поддержкой базы данных MySQL, веб-интерфейс Zabbix на базе веб-сервера Nginx и Zabbix Java gateway с использованием podman в Red Hat 8.

1. Создайте новый pod с именем zabbix и открытыми портами (веб-интерфейс, trapper сервера Zabbix):

podman pod create --name zabbix -p 80:8080 -p 10051:10051

2. (необязательно) Запустите контейнер агента Zabbix в расположении pod zabbix:

podman run --name zabbix-agent \
  -e ZBX_SERVER_HOST="127.0.0.1,localhost" \
  --restart=always \
  --pod=zabbix \
  -d registry.connect.redhat.com/zabbix/zabbix-agent-74:latest

3. Создайте каталог ./mysql/ на узле сети и запустите сервер Oracle MySQL 8.4:

podman run --name mysql-server -t \
    -e MYSQL_DATABASE="zabbix" \
    -e MYSQL_USER="zabbix" \
    -e MYSQL_PASSWORD="zabbix_pwd" \
    -e MYSQL_ROOT_PASSWORD="root_pwd" \
    -v ./mysql/:/var/lib/mysql/:Z \
    --restart=always \
    --pod=zabbix \
    -d mysql:8.4 \
    --character-set-server=utf8 --collation-server=utf8_bin \
    --default-authentication-plugin=caching_sha2_password

4. Запустите контейнер сервера Zabbix:

podman run --name zabbix-server-mysql -t \
                -e DB_SERVER_HOST="127.0.0.1" \
                -e MYSQL_DATABASE="zabbix" \
                -e MYSQL_USER="zabbix" \
                -e MYSQL_PASSWORD="zabbix_pwd" \
                -e MYSQL_ROOT_PASSWORD="root_pwd" \
                -e ZBX_JAVAGATEWAY="127.0.0.1" \
                --restart=always \
                --pod=zabbix \
                -d registry.connect.redhat.com/zabbix/zabbix-server-mysql-74

5. Запустите контейнер Zabbix Java Gateway:

podman run --name zabbix-java-gateway -t \
    --restart=always \
    --pod=zabbix \
    -d registry.connect.redhat.com/zabbix/zabbix-java-gateway-74

6. Запустите контейнер веб-интерфейса Zabbix:

podman run --name zabbix-web-mysql -t \
                -e ZBX_SERVER_HOST="127.0.0.1" \
                -e DB_SERVER_HOST="127.0.0.1" \
                -e MYSQL_DATABASE="zabbix" \
                -e MYSQL_USER="zabbix" \
                -e MYSQL_PASSWORD="zabbix_pwd" \
                -e MYSQL_ROOT_PASSWORD="root_pwd" \
                --restart=always \
                --pod=zabbix \
                -d registry.connect.redhat.com/zabbix/zabbix-web-mysql-74

Docker Compose

В качестве альтернативы Zabbix можно установить с помощью плагина Docker Compose. Файлы Compose для определения и запуска многоконтейнерных компонентов Zabbix доступны в официальном репозитории Zabbix Docker на GitHub.

Эти compose-файлы добавлены в качестве примеров; они перегружены. Например, они содержат прокси с поддержкой как MySQL, так и SQLite3.

Чтобы получить Docker compose-файлы, предоставляемые Zabbix, клонируйте репозиторий:

git clone https://github.com/zabbix/zabbix-docker.git

Переключитесь на требуемую версию:

git checkout 8.0

Настройте compose-файлы и создайте и запустите контейнеры:

docker compose -f ./docker-compose_v3_alpine_mysql_latest.yaml up

Замените docker-compose_v3_alpine_mysql_latest.yaml в приведенной выше команде на требуемый файл конфигурации.

Доступны следующие варианты:

Хранилище

Файлы Compose настроены для поддержки локального хранения на машине узла сети. Docker Compose создаст каталог zbx_env в папке с compose-файлом, когда вы запустите компоненты Zabbix с использованием compose-файла. Каталог будет содержать ту же структуру, что описана в разделе Volumes, а также каталог для хранения базы данных.

Также имеются тома в режиме только для чтения для файлов /etc/localtime и /etc/timezone.

Переменные окружения

Файлы переменных имеют следующую структуру именования: .env_<type of component> и расположены в каталоге env_vars. Подробные сведения о правилах именования переменных и доступных вариантах выбора см. в разделе переменные окружения.

Примеры

Пример 1

git checkout 8.0
docker compose -f ./docker-compose_v3_alpine_mysql_latest.yaml up -d

Команда загрузит последние образы Zabbix 8.0 для каждого компонента Zabbix и запустит их в фоновом режиме.

Пример 2

git checkout 8.0
docker compose -f ./docker-compose_v3_ubuntu_mysql_local.yaml up -d

Команда загрузит базовый образ Ubuntu 24.04 (noble), затем локально соберёт компоненты Zabbix 8.0 и запустит их в фоновом режиме.