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 с поддержкой MySQL базы данных и Nginx веб-сервером - zabbix/zabbix-appliance
• 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-4.2-latest - последняя минорная версия Zabbix 4.2 компоненты на основе образа Alpine Linux
• ubuntu-4.2-latest - последняя минорная версия Zabbix 4.2 компоненты на основе образа Ubuntu
• alpine-4.2.* - различные минорные версии Zabbix 4.2 компоненты на основе образа Alpine Linux, где * - минорная версия Zabbix компоненты
• ubuntu-4.2.* - различные минорные версии Zabbix 4.2 компоненты на основе образа Ubuntu, где * - минорная версия Zabbix компоненты

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

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

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

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

Тома

Образы позволяют использовать некоторые точки монтирования. Такие точки монтирования различны и зависят от типа Zabbix компонента:

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

Примеры использования

** Пример 1 **

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

# docker run --name zabbix-appliance -t \
             -p 10051:10051 \
             -p 80:80 \
             --restart unless-stopped \
             -d zabbix/zabbix-appliance:latest

** Пример 2 **

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

1. Запустите пустой экземпляр 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" \
             -d mysql:5.7 \
             --restart unless-stopped \
             --character-set-server=utf8 --collation-server=utf8_bin

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

# docker run --name zabbix-java-gateway -t \
             --restart unless-stopped \
             -d zabbix/zabbix-java-gateway:latest

3. Запустите экземпляр 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" \
             --link mysql-server:mysql \
             --link zabbix-java-gateway:zabbix-java-gateway \
             -p 10051:10051 \
             --restart unless-stopped \
             -d zabbix/zabbix-server-mysql:latest

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

# docker run --name zabbix-web-nginx-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" \
             --link mysql-server:mysql \
             --link zabbix-server-mysql:zabbix-server \
             -p 80:80 \
             --restart unless-stopped \
             -d zabbix/zabbix-web-nginx-mysql:latest

** Пример 3 **

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

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

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

2. Запустите экземпляр 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 \
             -p 162:162/udp \
             --restart unless-stopped \
             -d zabbix/zabbix-snmptraps:latest

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

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

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

# docker run --name zabbix-web-nginx-pgsql -t \
             -e DB_SERVER_HOST="postgres-server" \
             -e POSTGRES_USER="zabbix" \
             -e POSTGRES_PASSWORD="zabbix" \
             -e POSTGRES_DB="zabbix_pwd" \
             --link postgres-server:postgres \
             --link zabbix-server-pgsql:zabbix-server \
             -p 443:443 \
             -v /etc/ssl/nginx:/etc/ssl/nginx:ro \
             --restart unless-stopped \
             -d zabbix/zabbix-web-nginx-pgsql:latest

Docker Compose

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

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

Хранилище

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

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

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

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

Примеры

** Пример 1 **

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

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

** Пример 2 **

# docker-compose -f ./docker-compose_v3_ubuntu_mysql_local.yaml up -d

Эта команда загрузит базовый образ Ubuntu 14.04, затем соберет Zabbix 4.2 компоненты локально и запустит их в detach режиме.