Instalēšana no konteineriem

Pārskats

Šajā lapā ir aprakstīts, kā izvietot Zabbix, izmantojot Docker vai Docker Compose.

Docker Compose ir ātrākais veids, kā izvietot Zabbix. Tas nolasa konfigurācijas failu un automātiski palaiž visus konteinerus, kas veido pilnīgu Zabbix iestatījumu, pareizajā secībā.

Docker (manuāla izvietošana) nodrošina to pašu rezultātu, izvietojot katru komponentu soli pa solim, kas var būt piemēroti lietotājiem, kuri jau pārvalda esošu Docker vidi.

Priekšnosacījumi

Pirms sākat, pārliecinieties, ka Docker ir instalēts jūsu sistēmā. Ja tas nav instalēts, sekojiet Docker instalēšanas ceļvedim.

Dažiem Zabbix komponentiem ir nepieciešams, lai uz hosta, kurā darbojas Docker, būtu atvērti noteikti porti (piemēram, 10051/TCP Zabbix serverim, 162/UDP SNMP slazdiem). Pilnu Zabbix komponentu izmantoto portu sarakstu skatiet sadaļā Prasības. Zabbix serverim un aģentam noklusējuma portu var mainīt, attiecīgajā konteinerā iestatot vides mainīgo ZBX_LISTENPORT.

Pieejamie Docker attēli

Zabbix nodrošina Docker attēlu katram Zabbix komponentam, un tie visi ir publicēti Docker Hub. Katrs attēls tiek izmantots, lai izveidotu konteineru, kurā darbojas attiecīgais komponents.

Visi Zabbix komponentu attēli Docker Hub tiek automātiski pārbūvēti, kad tiek atjaunināti to bāzes attēli.

Attēlu tagi

Katrs attēls atbalsta tagus, lai atlasītu bāzes operētājsistēmu un Zabbix versiju:

zabbix/<image>:<os>-<version>

Atbalstītās <os> vērtības:

• alpine - Alpine Linux
• ubuntu - Ubuntu
• ol - Oracle Linux
• ltsc2019 - Windows 10 LTSC 2019 (tikai Zabbix aģents)
• ltsc2022 - Windows 11 LTSC 2022 (tikai Zabbix aģents)

Atbalstītās <version> vērtības:

• latest - jaunākā stabilā versija Alpine Linux
• <os>-latest - jaunākā stabilā versija izvēlētajā OS
• <os>-trunk - jaunākais izstrādes (nightly) būvējums izvēlētajā OS
• <os>-X.X-latest - jaunākais konkrētas galvenās versijas mazākais laidiens izvēlētajā OS
• <os>-X.X.* - konkrēta mazākā versija izvēlētajā OS

Piemēri:

# Jaunākais stabilais Zabbix starpniekserveris (SQLite3) Alpine Linux:
docker pull zabbix/zabbix-proxy-sqlite3:latest

# Jaunākais stabilais Zabbix starpniekserveris (SQLite3) Ubuntu:
docker pull zabbix/zabbix-proxy-sqlite3:ubuntu-latest

# Jaunākais Zabbix serveris (MySQL) izstrādes (nightly) būvējums Ubuntu:
docker pull zabbix/zabbix-server-mysql:ubuntu-trunk

# Jaunākais Zabbix servera (MySQL) 8.0 mazākais laidiens Alpine Linux:
docker pull zabbix/zabbix-server-mysql:alpine-8.0-latest

# Zabbix servera (MySQL) versija 8.0.1 Alpine Linux:
docker pull zabbix/zabbix-server-mysql:alpine-8.0.1

Docker Compose

Docker Compose ir ātrākais veids, kā izvietot Zabbix. Tas nolasa konfigurācijas failu (Compose failu) un pārvalda visu iestatīšanu — lejupielādē Docker attēlus, izveido iekšējo tīklu starp konteineriem, iestata krātuvi, inicializē datubāzi un palaiž visu pareizajā secībā.

oficiālā Zabbix Dockerfiles repozitorijs nodrošina lietošanai gatavus Docker Compose failus un uz .env balstītu konfigurācijas sistēmu ar atbalstu dažādām operētājsistēmām, datubāzu aizmugursistēmām un Zabbix komponentu konfigurācijai.

1. Klonējiet repozitoriju, pārejiet uz to un pārslēdzieties uz versiju 8.0:

git clone https://github.com/zabbix/zabbix-docker.git
cd zabbix-docker
git checkout 8.0

2. (Neobligāti) Pielāgojiet izvietošanu ar vides mainīgajiem. Šo soli var izlaist noklusējuma iestatīšanai.

3. Izvietojiet noklusējuma Zabbix iestatījumu:

# Ar MySQL kā datubāzi:
docker compose -f ./compose.yaml up -d

# Ar PostgreSQL kā datubāzi:
docker compose -f ./compose_pgsql.yaml up -d

Tas palaiž Zabbix serveri, tīmekļa saskarni (darbojas uz Nginx) un datubāzes aizmugursistēmu (MySQL vai PostgreSQL), katru savā konteinerā uz Alpine Linux (pēc noklusējuma). Kad konteineri ir palaisti un darbojas (parasti 1–3 minūšu laikā), tiek palaists Zabbix serveris, un tīmekļa saskarne ir pieejama vietnē http://localhost.

Varat pārbaudīt, vai viss darbojas, ar šādu komandu:

docker compose ps

Visiem konteineriem jābūt ar statusu running. Ja kādam ir statuss exited, pārbaudiet tā žurnālus (docker logs <container-name>).

Vides mainīgie

Gan Docker Compose darbību, gan Zabbix komponentu konfigurāciju var pielāgot, izmantojot vides mainīgos.

Compose līmeņa mainīgie (definēti .env failā) nosaka, kuri Docker attēli, porti un tīkla IP diapazoni tiek izmantoti. Šos mainīgos var izmantot tieši pirms docker compose komandas vai rediģēt .env failu.

Piemēram, šī komanda izvērš pilnu vairāku konteineru Zabbix iestatījumu, izmantojot uz Ubuntu balstītu attēlu (noklusējuma Alpine Linux vietā) un publicējot tīmekļa saskarni caur Nginx pielāgotos HTTP (8282) un HTTPS (8443) portos:

OS=ubuntu \
ZABBIX_WEB_NGINX_HTTP_PORT=8282 \
ZABBIX_WEB_NGINX_HTTPS_PORT=8443 \
docker compose -f ./compose.yaml up -d

Komponentu līmeņa mainīgie (definēti env_vars/.env_<component> failos) nosaka Zabbix komponentu konfigurāciju. Pirms docker compose komandas palaišanas rediģējiet atbilstošo .env_<component> failu.

Piemēram, varat pielāgot Zabbix servera pasīvo aptaujātāju skaitu un kešatmiņas iestatījumus, kā arī konfigurēt tīmekļa saskarnes laika joslu, rediģējot šādus mainīgos:

# env_vars/.env_srv
ZBX_STARTPOLLERS=20
ZBX_CACHESIZE=64M
ZBX_HISTORYCACHESIZE=32M

# env_vars/.env_web
PHP_TZ=Europe/Paris

Sējumi

Docker Compose glabā pastāvīgos datus zbx_env/ direktorijā, kas tiek izveidota līdzās Compose failam. Šī direktorija saglabā komponentu datus starp konteineru restartēšanām un atjauninājumiem.

zbx_env/ saturs ir iepriekš noteikts katra komponenta attēlam. Piemēram:

• zbx_env/etc/ - izmanto Zabbix tīmekļa saskarnes konteiners
• zbx_env/usr/ un zbx_env/var/ - izmanto Zabbix servera konteiners

Papildinformāciju par katru sējumu skatiet sadaļā Allowed volumes katra komponenta Docker attēla aprakstā Docker Hub.

Makefile

Zabbix Dockerfiles repozitorijs nodrošina arī Makefile kā saīsni biežāk izmantotajiem Docker Compose uzdevumiem. Tā vietā, lai izmantotu pilno docker compose komandu, varat izmantot īsākas make komandas (izpildiet make help, lai skatītu pieejamās opcijas):

# Noklusējuma izvietojums (Zabbix serveris, tīmekļa saskarne, MySQL, viss uz Alpine Linux)
make up

# Pielāgots izvietojums (Zabbix serveris, tīmekļa saskarne ar pielāgotiem Nginx portiem, PostgreSQL, viss uz Ubuntu)
make up \
  OS=ubuntu \
  DB=pgsql \
  ZABBIX_WEB_NGINX_HTTP_PORT=8282 \
  ZABBIX_WEB_NGINX_HTTPS_PORT=8443

Pēc noklusējuma make up palaiž tikai minimālu pakalpojumu kopu (Zabbix serveri, tīmekļa saskarni un datubāzi). Tas uztur iestatīšanu vieglu un novērš tādu komponentu palaišanu, kas var nebūt nepieciešami. Lai iekļautu papildu komponentus, varat izmantot šādus Compose profilus:

# Noklusējuma izvietojums + Zabbix aģents, Java gateway, tīmekļa pakalpojums un SNMP slazdi:
make up COMPOSE_PROFILES=full

# COMPOSE_PROFILES=full + Zabbix starpniekserveris (MySQL un SQLite3):
make up COMPOSE_PROFILES=all

Docker (manuāla izvietošana)

Izmantojiet manuālu izvietošanu, ja vēlaties izvietot Zabbix soli pa solim, palaist atsevišķus komponentus, integrēt tos esošajā vidē vai izmantot alternatīvu konteineru izpildlaiku, piemēram, Podman.

Piemēram, lai izvietotu Zabbix starpniekserveri, izpildiet šādu komandu:

docker run --name zabbix-proxy-sqlite3 \
  -e ZBX_SERVER_HOST=192.0.2.0 \
  -e ZBX_PROXYMODE=0 \
  -e ZBX_HOSTNAME=zabbix-proxy-sqlite3 \
  -v zabbix-proxy-data:/var/lib/zabbix/db_data \
  --init \
  -d \
  zabbix/zabbix-proxy-sqlite3:alpine-8.0-latest

Šī komanda:

• Lejupielādē zabbix/zabbix-proxy-sqlite3:alpine-8.0-latest Docker attēlu.

• Izveido un palaiž zabbix-proxy-sqlite3 konteineru, pamatojoties uz Docker attēlu (ar karodziņiem --init un -d).

• Konfigurē Zabbix starpniekservera parametru Server, izmantojot vides mainīgo ZBX_SERVER_HOST. Šis parametrs norāda Zabbix servera IP adresi, no kura starpniekserveris saņems konfigurācijas datus un uz kuru tas nosūtīs savāktos datus. Ņemiet vērā, ka citi aktīvā starpniekservera darbībai nepieciešamie mainīgie izmanto noklusējuma vērtības un tos var izlaist.

• Savieno Docker pārvaldītu glabāšanas vietu (piemēram, /var/lib/docker/volumes/zabbix-proxy-data/) ar konteinera direktoriju /var/lib/zabbix, lai Zabbix starpniekservera dati tiktu glabāti pastāvīgi, pat ja konteiners tiek noņemts.

Pēc Zabbix starpniekservera konteinera izvietošanas varat turpināt, pievienojot starpniekserveri savā Zabbix lietotāja saskarne un konfigurējot hostus, kurus uzraudzīs šis starpniekserveris.

Tālāk sniegtie piemēri aptver vēl trīs izvietošanas scenārijus:

• Zabbix serveris (MySQL) ar Java gateway
• Zabbix serveris (PostgreSQL) ar SNMP slazdiem
• Zabbix serveris (MySQL) ar Java gateway uz RHEL 8

Vairāk piemēru skatiet katra komponenta Docker attēla aprakstā Docker Hub.

Izvietojiet Zabbix serveri (MySQL) ar Java gateway

1. Izveidojiet atsevišķu Docker tīklu, lai visi Zabbix komponentu konteineri varētu sasniegt cits citu pēc konteinera nosaukuma:

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

2. Palaidiet tukšu MySQL servera konteineri (aizstājiet zabbix_pwd un root_pwd ar drošām parolēm):

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 \
  --innodb-default-row-format=dynamic \
  --innodb-strict-mode=OFF

3. Palaidiet Zabbix Java gateway konteineri:

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 konteineri un sasaistiet to ar MySQL servera konteineri (aizstājiet zabbix_pwd un root_pwd ar tām pašām parolēm, kas izmantotas 2. darbībā):

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 saskarnes konteineri un sasaistiet to ar Zabbix servera un MySQL servera konteineriem (aizstājiet zabbix_pwd un root_pwd ar tām pašām parolēm, kas izmantotas 2. darbībā):

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

Pēc tam, kad konteineri ir palaisti un darbojas (parasti 1–3 minūšu laikā), Zabbix serveris ir startēts un tīmekļa saskarne ir pieejama vietnē http://localhost.

Izvietojiet Zabbix serveri (PostgreSQL) ar SNMP slazdiem

1. Izveidojiet atsevišķu Docker tīklu, lai visi Zabbix komponentu konteineri varētu sasniegt cits citu pēc konteinera nosaukuma:

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

2. Palaidiet tukšu PostgreSQL servera konteineri (aizstājiet zabbix_pwd ar drošu paroli):

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 SNMP slazdu konteineri:

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 konteineri, sasaistiet to ar PostgreSQL servera konteineri un SNMP slazdu konteineri (aizstājiet zabbix_pwd ar to pašu paroli, kas izmantota 2. darbībā):

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 saskarnes konteineri un sasaistiet to ar Zabbix servera un PostgreSQL servera konteineriem (aizstājiet zabbix_pwd ar to pašu paroli, kas izmantota 2. darbībā):

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

Pēc tam, kad konteineri ir palaisti un darbojas (parasti 1–3 minūšu laikā), Zabbix serveris ir startēts un tīmekļa saskarne ir pieejama vietnē http://localhost.

Izvietojiet Zabbix serveri (MySQL) ar Java gateway uz RHEL 8

Red Hat Enterprise Linux 8 vidē ieteicamā konteineru izpildlaika vide ir Podman, nevis Docker. Podman darbojas līdzīgi kā Docker, taču tam nav nepieciešams fona serviss, kas darbojas kā root, tāpēc tas ir piemērotāks Red Hat vidēm.

1. Izveidojiet jaunu pod ar nosaukumu zabbix un atvērtajiem portiem Zabbix tīmekļa saskarnei un Zabbix servera trapperim:

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

2. (Neobligāti) Palaidiet Zabbix aģenta konteineri 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-80:latest

3. Izveidojiet ./mysql/ direktoriju RHEL hostā:

mkdir -p ./mysql

4. Palaidiet tukšu MySQL servera konteineri (aizstājiet zabbix_pwd un root_pwd ar drošām parolēm):

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 \
  --innodb-default-row-format=dynamic \
  --innodb-strict-mode=OFF

5. Palaidiet Zabbix Java gateway konteineri:

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

6. Palaidiet Zabbix servera konteineri (aizstājiet zabbix_pwd un root_pwd ar tām pašām parolēm, kas izmantotas 4. darbībā):

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

7. Palaidiet Zabbix tīmekļa saskarnes konteineri (aizstājiet zabbix_pwd un root_pwd ar tām pašām parolēm, kas izmantotas 4. darbībā):

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