5 Инсталација из контејнера

Преглед

Овај одељак описује како се имплементира Zabbix помоћу Docker или Docker Compose.

Zabbix званично пружа:

• Одвојене Docker слике за сваку Zabbix компоненту да би се покретале као преносиве и самодовољне контејнере.
• Compose датотеке за дефинисање и покретање вишеконтејнерских Zabbix компоненти у Docker-у.

Изворне датотеке

Изворне Docker датотеке се чувају у Zabbix званичном репозиторијуму на GitHub-у, где можете да пратите најновије измене датотека или да направите своје слике.

Докер

Zabbix пружа слике засноване на различитим основним OS сликама. Да бисте добили листу подржаних основних слика оперативног система за одређену Zabbix компоненту, погледајте опис компоненте у Docker Hub. Све Zabbix слике су конфигурисане да поново изграде најновије слике ако се основне слике ажурирају.

Инсталација

Да бисте добили слику Zabbix компоненте, покрените:

docker pull zabbix/zabbix-server-mysql

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

Ова команда ће преузети најновију стабилну верзију Zabbix компоненте засновану на Alpine Linux оперативном систему. Можете додати tags имену репозиторијума да бисте добили слику засновану на другом оперативном систему или на одређеној главној или споредној верзији Zabbix.

Следећи репозиторијуми су доступни у Docker Hub:

Ознаке

Званичне слике Zabbix компоненти могу да садрже следеће ознаке:

Почетна конфигурација

Након преузимања слика, покрените контејнере извршавањем команде docker run, након чега следе додатни аргументи за навођење потребних променљивих окружења и/или тачака монтирања. Неки примери конфигурације су дати у наставку.

Променљиве окружења

Све слике Zabbix компоненти пружају променљиве окружења за контролу конфигурације. Подржане променљиве окружења су наведене у репозиторијуму компоненти.

Ове променљиве окружења су опције из Zabbix конфигурационих датотека, али са различитим начином именовања. На пример, ZBX_LOGSLOWQUERIES је једнако LogSlowQueries из Zabbix server или Zabbix proxy конфигурационих датотека.

Следеће променљиве окружења су специфичне за Docker компоненте и не постоје у Zabbix конфигурационим датотекама:

Volumes

Слике омогућавају монтирање томова користећи следеће тачке монтирања:

За додатне информације, погледајте званичне 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-oracle \
             --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-7.0-latest

4. Покрените инстанцу Zabbix сервера и повежите инстанцу са креираном MySQL server инстанца

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-7.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-7.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-7.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-7.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-7.0-latest

Пример 3

Пример показује како покренути Zabbix сервер са подршком за MySQL базу података, Zabbix веб интерфејс базиран на Nginx веб серверу и Zabbix Java gateway-у користећи podman на Red Hat 8.

1. Направите нови под са именом zabbix и изложеним портовима (веб-интерфејс, Zabbix server trapper):

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

2. (опционо) Покрените контејнер Zabbix агента на локацији под-а 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-70: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-70

5. Покрените Zabbix Java Gateway контејнер:

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

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

Docker Compose

Алтернативно, Zabbix се може инсталирати помоћу Docker Compose додатка. Compose датотеке за дефинисање и покретање Zabbix компоненти са више контејнера су доступне у званичном Zabbix Docker репозиторијуму на GitHub-у.

Ове датотеке за компоновање су додате као примери; оне су преоптерећене. На пример, садрже проксије са подршком за MySQL и SQLite3.

Да бисте добили Docker compose датотеке које пружа Zabbix, клонирајте репозиторијум:

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

Пређите на потребну верзију:

git checkout 7.4

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 7.4 docker compose -f ./docker-compose_v3_alpine_mysql_latest.yaml up -d

Команда ће преузети најновије Zabbix 7.4 слике за сваку Zabbix компоненту и покренути их у режиму одвајања.

Пример 2

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

Команда ће преузети основну слику Ubuntu 24.04 (noble), затим локално изградити Zabbix 7.4 компоненте и покренути их у режиму одвајања.