Instalēšana no konteineriem

Pārskats

Šajā sadaļā ir aprakstīts, kā izvietot Zabbix ar Docker vai Docker Compose.

Zabbix oficiāli nodrošina:

• Atsevišķus Docker attēlus katram Zabbix komponentam, lai tos darbinātu kā pārnēsājamus un pašpietiekamus konteinerus.
• Compose failus vairāku konteineru Zabbix komponentu definēšanai un darbināšanai Docker vidē.

Avota faili

Docker failu avoti tiek glabāti Zabbix oficiālajā repozitorijā GitHub vietnē, kur varat sekot jaunākajām failu izmaiņām vai atzarot projektu, lai izveidotu savus attēlus.

Docker

Zabbix nodrošina attēlus, kuru pamatā ir dažādi OS bāzes attēli. Lai iegūtu konkrēta Zabbix komponenta atbalstīto bāzes operētājsistēmas attēlu sarakstu, skatiet komponenta aprakstu Docker Hub. Visi Zabbix attēli ir konfigurēti tā, lai pārbūvētu jaunākos attēlus, ja tiek atjaunināti bāzes attēli.

Instalēšana

Lai iegūtu Zabbix komponenta attēlu, izpildiet:

docker pull zabbix/zabbix-server-mysql

Aizstājiet zabbix/zabbix-server-mysql ar nepieciešamās Docker repozitorija nosaukumu.

Šī komanda lejupielādēs jaunāko stabilo Zabbix komponenta versiju, kuras pamatā ir Alpine Linux OS. Varat pievienot tagus repozitorija nosaukumam, lai iegūtu attēlu, kura pamatā ir cita operētājsistēma, vai konkrētas Zabbix galvenās vai mazākās versijas attēlu.

Docker Hub ir pieejami šādi repozitoriji:

Tagi

Oficiālie Zabbix komponentu attēli var saturēt šādus tagus:

Sākotnējā konfigurācija

Pēc attēlu lejupielādes palaidiet konteinerus, izpildot komandu docker run, kam seko papildu argumenti, lai norādītu nepieciešamos vides mainīgos un/vai montēšanas punktus. Tālāk ir sniegti daži konfigurācijas piemēri.

Vides mainīgie

Visi Zabbix komponentu attēli nodrošina vides mainīgos konfigurācijas pārvaldībai. Atbalstītie vides mainīgie ir uzskaitīti komponenta repozitorijā.

Šie vides mainīgie ir opcijas no Zabbix konfigurācijas failiem, bet ar atšķirīgu nosaukumu veidošanas metodi. Piemēram, ZBX_LOGSLOWQUERIES atbilst LogSlowQueries no Zabbix serveris vai Zabbix starpniekserveris konfigurācijas failiem.

Tālāk norādītie vides mainīgie ir specifiski Docker komponentiem un nepastāv Zabbix konfigurācijas failos:

Sējumi

Attēli ļauj piemontēt sējumus, izmantojot šādus montēšanas punktus:

Papildu informāciju skatiet oficiālajās Zabbix repozitorijās Docker Hub.

Piemēri

1. piemērs

Šis piemērs parāda, kā palaist Zabbix serveris ar MySQL datubāzes atbalstu, Zabbix tīmekļa lietotāja saskarne, kas balstīta uz Nginx tīmekļa serveri, un Zabbix Java gateway.

1. Izveidojiet tīklu, kas paredzēts Zabbix komponentu konteineriem:

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

2. Palaidiet tukšu MySQL servera instanci:

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. Palaidiet Zabbix Java gateway instanci:

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

4. Palaidiet Zabbix servera instanci un sasaistiet to ar izveidoto MySQL servera instanci:

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. Palaidiet Zabbix tīmekļa lietotāja saskarne un sasaistiet to ar izveidotajām MySQL servera un Zabbix servera instancēm:

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. piemērs

Šis piemērs parāda, kā palaist Zabbix serveris ar PostgreSQL datubāzes atbalstu, Zabbix tīmekļa lietotāja saskarne, kas balstīta uz Nginx tīmekļa serveri, un SNMP trap funkcionalitāti.

1. Izveidojiet tīklu, kas paredzēts Zabbix komponentu konteineriem:

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

2. Palaidiet tukšu PostgreSQL servera instanci:

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. Palaidiet Zabbix snmptraps instanci:

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. Palaidiet Zabbix servera instanci un sasaistiet to ar izveidoto PostgreSQL servera instanci:

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. Palaidiet Zabbix tīmekļa lietotāja saskarne un sasaistiet to ar izveidotajām PostgreSQL servera un Zabbix servera instancēm:

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. piemērs

Šis piemērs parāda, kā palaist Zabbix serveris ar MySQL datubāzes atbalstu, Zabbix tīmekļa lietotāja saskarne, kas balstīta uz Nginx tīmekļa serveri, un Zabbix Java gateway, izmantojot podman Red Hat 8 vidē.

1. Izveidojiet jaunu pod ar nosaukumu zabbix un atvērtajiem portiem (tīmekļa lietotāja saskarne, Zabbix servera trapper):

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

2. (neobligāti) Palaidiet Zabbix aģents konteineru zabbix pod atrašanās vietā:

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. Izveidojiet ./mysql/ direktoriju hostā un palaidiet Oracle MySQL serveri 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. Palaidiet Zabbix servera konteineru:

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. Palaidiet Zabbix Java Gateway konteineru:

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

6. Palaidiet Zabbix tīmekļa lietotāja saskarne konteineru:

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

Alternatīvi, Zabbix var instalēt, izmantojot Docker Compose spraudni. Compose faili vairāku konteineru Zabbix komponentu definēšanai un palaišanai ir pieejami oficiālajā Zabbix Docker repozitorijā GitHub.

Šie compose faili ir pievienoti kā piemēri; tie ir pārslogoti. Piemēram, tie satur starpniekserverus ar gan MySQL, gan SQLite3 atbalstu.

Lai iegūtu Zabbix nodrošinātos Docker compose failus, klonējiet repozitoriju:

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

Pārslēdzieties uz nepieciešamo versiju:

git checkout 8.0

Izmantojiet compose konfigurācijas failus, lai izveidotu un palaistu konteinerus:

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

Aizstājiet docker-compose_v3_alpine_mysql_latest.yaml iepriekš norādītajā komandā ar nepieciešamo konfigurācijas failu.

Ir pieejamas šādas opcijas:

Krātuve

Compose faili ir konfigurēti tā, lai atbalstītu lokālo krātuvi hosts datorā. Docker Compose izveidos zbx_env direktoriju mapē ar compose failu, kad palaidīsiet Zabbix komponentus, izmantojot compose failu. Direktorijā būs tā pati struktūra, kas aprakstīta sadaļā Volumes, kā arī direktorijs datubāzes glabāšanai.

Ir arī sējumi tikai lasīšanas režīmā failiem /etc/localtime un /etc/timezone.

Vides mainīgie

Mainīgo failiem ir šāda nosaukumu struktūra: .env_<komponenta tips>, un tie atrodas env_vars direktorijā. Skatiet vides mainīgos, lai iegūtu sīkāku informāciju par mainīgo nosaukumiem un pieejamo izvēli.

Piemēri

1. piemērs

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

Komanda lejupielādēs jaunākos Zabbix 8.0 attēlus katram Zabbix komponentam un palaidīs tos atvienotajā režīmā.

2. piemērs

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

Komanda lejupielādēs bāzes attēlu Ubuntu 24.04 (noble), pēc tam lokāli izveidos Zabbix 8.0 komponentus un palaidīs tos atvienotajā režīmā.