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

Docker

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

Компоненты Zabbix поставляются с поддержкой баз данных MySQL и PostgreSQL, веб-серверов Apache2 и Nginx. Эти образы разделены на несколько отдельных образов.

Базовые образы Docker

Компоненты Zabbix поставляются на основе образов Ubuntu, Alpine Linux и CentOS:

Все образы сконфигурированы на пересоздание в случае, если базовые образы были обновлены.

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

Каждый может следить на изменениями в Docker файлах, используя официальный репозиторий Zabbix на github.com. Вы можете создавать ответвления от проекта или свои собственные образы на основе официальных Docker файлов.

Структура

Все компоненты Zabbix доступны в следующих Docker репозиториях:

• Zabbix агент — zabbix/zabbix-agent
• Zabbix сервер
  • Zabbix сервер с поддержкой базы данных MySQL — zabbix/zabbix-server-mysql
  • Zabbix сервер с поддержкой базы данных PostgreSQL — zabbix/zabbix-server-pgsql
• Веб-интерфейс Zabbix
  • Веб-интерфейс Zabbix на основе веб-сервера Apache2 с поддержкой базы данных MySQL — zabbix/zabbix-web-apache-mysql
  • Веб-интерфейс Zabbix на основе веб-сервера Apache2 с поддержкой базы данных PostgreSQL — zabbix/zabbix-web-apache-pgsql
  • Веб-интерфейс Zabbix на основе веб-сервера Nginx с поддержкой базы данных MySQL — zabbix/zabbix-web-nginx-mysql
  • Веб-интерфейс Zabbix на основе веб-сервера Nginx с поддержкой базы данных PostgreSQL — zabbix/zabbix-web-nginx-pgsql
• Zabbix прокси
  • Zabbix прокси с поддержкой базы данных SQLite3 — zabbix/zabbix-proxy-sqlite3
  • Zabbix прокси с поддержкой базы данных MySQL — zabbix/zabbix-proxy-mysql
• Zabbix Java Gateway — zabbix/zabbix-java-gateway

Дополнительно имеется поддержка SNMP трапов. Поставляется как дополнительный репозиторий (zabbix/zabbix-snmptraps) только на основе Ubuntu Trusty. Его можно привязать к Zabbix серверу и Zabbix прокси.

Версии

Каждый репозиторий компонентов Zabbix содержит следующие тэги:

• latest — последняя стабильная версия компонента Zabbix на основе образа Alpine Linux
• alpine-latest — последняя стабильная версия компонента Zabbix на основе образа Alpine Linux
• ubuntu-latest — последняя стабильная версия компонента Zabbix на основе образа Ubuntu
• alpine-6.0-latest — последняя минорная версия компонента Zabbix 6.0 на основе образа Alpine Linux
• ubuntu-6.0-latest — последняя минорная версия компонента Zabbix 6.0 на основе образа Ubuntu
• alpine-6.0.* — различные минорные версии компонента Zabbix 6.0 на основе образа Alpine Linux, где * минорная версия компонента Zabbix
• ubuntu-6.0.* — различные минорные версии компонента Zabbix 6.0 на основе образа Ubuntu, где * минорная версия компонента Zabbix

Использование

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

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

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

Тома

Образы позволяют использовать некоторые точки монтирования. Данные точки монтирования имеют отличия и зависят от типа 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.0 \
             --character-set-server=utf8 --collation-server=utf8_bin \
             --default-authentication-plugin=mysql_native_password

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

docker run --name zabbix-java-gateway -t \
             --network=zabbix-net \
             --restart unless-stopped \
             -d zabbix/zabbix-java-gateway:alpine-6.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-6.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-6.0-latest

Пример 2

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

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-6.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-6.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-6.0-latest

Пример 3

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

1. Создайте новую капсулу (pod) с именем zabbix и откройте порты (веб-интерфейс, траппер 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-60:latest

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

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.0 \
             --character-set-server=utf8 --collation-server=utf8_bin \
             --default-authentication-plugin=mysql_native_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-60

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

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

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-60

Docker Compose

Zabbix также поставляет файлы конфигурации для определения и запуска нескольких контейнеров с Zabbix компонентами в Docker. Данные файлы конфигурации доступны в официальном Zabbix docker репозитории на github.com: https://github.com/zabbix/zabbix-docker. Эти файлы конфигурации добавлены в качестве примера и перегружены. Например, в них содержится прокси с поддержкой MySQL и SQLite3.

Имеется несколько различных версий файлов конфигурации:

Хранилище

Файлы конфигурации Compose сконфигурированы для поддержки локального хранилища на узле. Docker Compose создаст директорию zbx_env в директории с файлом конфигурации compose, когда вы запустите компоненты Zabbix с его помощью. Директория будет содержать структуру, описанную в разделе Тома выше и директорию для хранения базы данных.

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

Файлы окружения

В той же директории с файлами конфигурации compose на github.com вы можете найти файлы с переменными окружения по умолчанию для каждого компонента из файлов конфигурации compose. Эти файлы окружения называются приблизительно так: .env_<тип компоненты>.

Примеры

Пример 1

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

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

Пример 2

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

Эта команда загрузит образ на основе Ubuntu 20.04 (focal), затем локально соберёт компоненты Zabbix 6.0 и запустит их в detach режиме.