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

Преглед

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

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

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

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

Изворне Docker датотеке се чувају у 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 конфигурационим датотекама:

Volumes

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

За додатне информације погледајте Zabbix званична спремишта у Docker-у Hub.

Примери

Пример 1

Пример показује како да покренете Zabbix сервер са подршком за MySQL базу података, Zabbix веб интерфејсом заснованим на Nginx веб серверу и Zabbix Java мрежном пролазу.

1. Креирајте мрежу посвећену контејнерима Zabbix компоненти:

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

2. Покрените празну инстанцу МySQL сервера

 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 мрежног пролаза

 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 сервера

 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 серверa и 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 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-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 веб интерфејсом заснованим на Ngnix веб серверу и Zabbix Java gateway користећи podman на Red Hat 8.

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

 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. Композиције датотека за дефинисање и покретање Zabbix компоненти са више контејнера су доступно у званичном Zabbix Docker репозиторијум ) на GitHub-у.

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

Да бисте добили датотеке за састављање Docker-а које обезбеђује Zabbix, клонирајте спремиште:

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

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

git checkout 7.0

Саставите конфигурационе датотеке и креирајте и покрените контејнере:

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

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

Пример 2

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

Команда ће преузети основну слику Ubuntu 22.04 (jammy), затим локално компајлирати Zabbix 7.0 компоненте и покренути их у detach режиму.