Installazione da container

Panoramica

Questa sezione descrive come distribuire Zabbix con Docker o Docker Compose.

Zabbix fornisce ufficialmente:

• Immagini Docker separate per ciascun componente di Zabbix, da eseguire come container portabili e autosufficienti.
• File Compose per definire ed eseguire componenti Zabbix multi-container in Docker.

File sorgente

I sorgenti dei file Docker sono archiviati nel repository ufficiale di Zabbix su GitHub, dove è possibile seguire le ultime modifiche ai file o fare un fork del progetto per creare le proprie immagini.

Docker

Zabbix fornisce immagini basate su una varietà di immagini OS di base. Per ottenere l'elenco delle immagini del sistema operativo di base supportate per uno specifico componente Zabbix, vedere la descrizione del componente in Docker Hub. Tutte le immagini Zabbix sono configurate per ricostruire le immagini più recenti se le immagini di base vengono aggiornate.

Installazione

Per ottenere l'immagine del componente Zabbix, eseguire:

docker pull zabbix/zabbix-server-mysql

Sostituire zabbix/zabbix-server-mysql con il nome del repository docker richiesto.

Questo comando scaricherà l'ultima versione stabile del componente Zabbix basata sul sistema operativo Alpine Linux. È possibile aggiungere dei tag al nome del repository per ottenere un'immagine basata su un altro sistema operativo oppure su una specifica versione major o minor di Zabbix.

I seguenti repository sono disponibili in Docker Hub:

Tag

Le immagini ufficiali dei componenti Zabbix possono contenere i seguenti tag:

Configurazione iniziale

Dopo aver scaricato le immagini, avviare i container eseguendo il comando docker run seguito da argomenti aggiuntivi per specificare le variabili d'ambiente e/o i punti di mount richiesti. Di seguito sono riportati alcuni esempi di configurazione.

Variabili d'ambiente

Tutte le immagini dei componenti Zabbix forniscono variabili d'ambiente per controllare la configurazione. Le variabili d'ambiente supportate sono elencate nel repository del componente.

Queste variabili d'ambiente corrispondono alle opzioni dei file di configurazione di Zabbix, ma con un metodo di denominazione diverso. Ad esempio, ZBX_LOGSLOWQUERIES equivale a LogSlowQueries nei file di configurazione di Zabbix server o Zabbix proxy.

Le seguenti variabili d'ambiente sono specifiche dei componenti Docker e non esistono nei file di configurazione di Zabbix:

Volumi

Le immagini consentono di montare volumi utilizzando i seguenti punti di mount:

Per ulteriori informazioni, vedere i repository ufficiali di Zabbix su Docker Hub.

Esempi

Esempio 1

L'esempio mostra come eseguire Zabbix server con supporto per il database MySQL, l'interfaccia web di Zabbix basata sul web server Nginx e Zabbix Java gateway.

1. Creare una rete dedicata ai container dei componenti Zabbix:

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

2. Avviare un'istanza vuota di server 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.4-oracle \
    --character-set-server=utf8 --collation-server=utf8_bin \
    --default-authentication-plugin=caching_sha2_password

3. Avviare un'istanza di Zabbix Java gateway:

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

4. Avviare un'istanza di Zabbix server e collegarla all'istanza di server MySQL creata:

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. Avviare l'interfaccia web di Zabbix e collegarla alle istanze create di server MySQL e Zabbix server:

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

Esempio 2

L'esempio mostra come eseguire Zabbix server con supporto per il database PostgreSQL, l'interfaccia web di Zabbix basata sul web server Nginx e la funzionalità SNMP trap.

1. Creare una rete dedicata ai container dei componenti Zabbix:

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

2. Avviare un'istanza vuota di server 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. Avviare un'istanza di 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-8.0-latest

4. Avviare un'istanza di Zabbix server e collegarla all'istanza di server PostgreSQL creata:

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. Avviare l'interfaccia web di Zabbix e collegarla alle istanze create di server PostgreSQL e Zabbix server:

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

Esempio 3

L'esempio mostra come eseguire Zabbix server con supporto per il database MySQL, l'interfaccia web di Zabbix basata sul web server Nginx e Zabbix Java gateway utilizzando podman su Red Hat 8.

1. Creare un nuovo pod con nome zabbix e porte esposte (interfaccia web, trapper di Zabbix server):

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

2. (opzionale) Avviare il container di Zabbix agent nella posizione del pod 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-74:latest

3. Creare la directory ./mysql/ sull'host e avviare Oracle MySQL server 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. Avviare il container di Zabbix server:

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. Avviare il container di Zabbix Java Gateway:

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

6. Avviare il container dell'interfaccia web di 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-74

Docker Compose

In alternativa, Zabbix può essere installato utilizzando il plugin Docker Compose. I file Compose per definire ed eseguire componenti Zabbix multi-container sono disponibili nel repository Docker ufficiale di Zabbix su GitHub.

Questi file Compose sono aggiunti come esempi; sono sovraccarichi. Ad esempio, contengono proxy con supporto sia per MySQL che per SQLite3.

Per ottenere i file Docker Compose forniti da Zabbix, clonare il repository:

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

Passare alla versione richiesta:

git checkout 8.0

Configurare i file Compose e creare e avviare i container:

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

Sostituire docker-compose_v3_alpine_mysql_latest.yaml nel comando sopra con il file di configurazione richiesto.

Sono disponibili le seguenti opzioni:

Archiviazione

I file Compose sono configurati per supportare l'archiviazione locale su una macchina host. Docker Compose creerà una directory zbx_env nella cartella contenente il file compose quando si eseguono i componenti Zabbix utilizzando il file compose. La directory conterrà la stessa struttura descritta nella sezione Volumes e una directory per l'archiviazione del database.

Sono inoltre presenti volumi in modalità di sola lettura per i file /etc/localtime e /etc/timezone.

Variabili d'ambiente

I file delle variabili hanno la seguente struttura di denominazione: .env_<type of component> e si trovano nella directory env_vars. Per i dettagli sulla denominazione delle variabili e sulla selezione disponibile, vedere variabili d'ambiente.

Esempi

Esempio 1

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

Il comando scaricherà le immagini Zabbix 8.0 più recenti per ciascun componente Zabbix e le eseguirà in modalità detach.

Esempio 2

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

Il comando scaricherà l'immagine di base Ubuntu 24.04 (noble), quindi compilerà localmente i componenti Zabbix 8.0 e li eseguirà in modalità detach.