Installation aus Containern

Überblick

Dieser Abschnitt beschreibt, wie Zabbix mit Docker oder Docker Compose bereitgestellt wird.

Zabbix stellt offiziell Folgendes bereit:

• Separate Docker-Images für jede Zabbix-Komponente, die als portable und eigenständige Container ausgeführt werden.
• Compose-Dateien zum Definieren und Ausführen von Zabbix-Komponenten mit mehreren Containern in Docker.

Quelldateien

Die Dockerfile-Quellen werden im Zabbix-offiziellen Repository auf GitHub gespeichert. Dort können Sie die neuesten Dateiänderungen verfolgen oder das Projekt forken, um Ihre eigenen Images zu erstellen.

Docker

Zabbix stellt Images bereit, die auf einer Vielzahl von Basis-OS-Images basieren. Um die Liste der unterstützten Basis-Betriebssystem-Images für eine bestimmte Zabbix-Komponente zu erhalten, siehe die Beschreibung der Komponente in Docker Hub. Alle Zabbix-Images sind so konfiguriert, dass die neuesten Images neu erstellt werden, wenn Basis-Images aktualisiert werden.

Installation

Um ein Zabbix-Komponenten-Image zu erhalten, führen Sie Folgendes aus:

docker pull zabbix/zabbix-server-mysql

Ersetzen Sie zabbix/zabbix-server-mysql durch den Namen des erforderlichen Docker-Repositorys.

Dieser Befehl lädt die neueste stabile Version der Zabbix-Komponente herunter, die auf dem Alpine-Linux-OS basiert. Sie können Tags an den Repository-Namen anhängen, um ein Image zu erhalten, das auf einem anderen Betriebssystem basiert oder einer bestimmten Zabbix-Haupt- oder Nebenversion entspricht.

Die folgenden Repositorys sind in Docker Hub verfügbar:

Tags

Offizielle Zabbix-Komponenten-Images können die folgenden Tags enthalten:

Erstkonfiguration

Nach dem Herunterladen der Images starten Sie die Container, indem Sie den Befehl docker run ausführen, gefolgt von zusätzlichen Argumenten zur Angabe der erforderlichen Umgebungsvariablen und/oder Mount-Punkte. Einige Konfigurationsbeispiele werden unten bereitgestellt.

Umgebungsvariablen

Alle Images der Zabbix-Komponenten stellen Umgebungsvariablen zur Steuerung der Konfiguration bereit. Unterstützte Umgebungsvariablen sind im Komponenten-Repository aufgeführt.

Diese Umgebungsvariablen sind Optionen aus den Zabbix-Konfigurationsdateien, jedoch mit einer anderen Benennungsmethode. Zum Beispiel entspricht ZBX_LOGSLOWQUERIES dem Wert LogSlowQueries aus den Konfigurationsdateien von Zabbix Server oder Zabbix Proxy.

Die folgenden Umgebungsvariablen sind spezifisch für Docker-Komponenten und existieren nicht in den Zabbix-Konfigurationsdateien:

Volumes

Die Images ermöglichen das Einhängen von Volumes unter Verwendung der folgenden Einhängepunkte:

Weitere Informationen finden Sie in den offiziellen Zabbix-Repositories auf Docker Hub.

Beispiele

Beispiel 1

Das Beispiel zeigt, wie Zabbix Server mit Unterstützung für eine MySQL-Datenbank, einer auf dem Nginx-Webserver basierenden Zabbix-Weboberfläche und dem Zabbix Java gateway ausgeführt wird.

1. Erstellen Sie ein Netzwerk, das für Zabbix-Komponenten-Container vorgesehen ist:

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

2. Starten Sie eine leere MySQL-Server-Instanz:

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. Starten Sie eine Zabbix Java gateway-Instanz:

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

4. Starten Sie eine Zabbix-Server-Instanz und verknüpfen Sie diese mit der erstellten MySQL-Server-Instanz:

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. Starten Sie die Zabbix-Weboberfläche und verknüpfen Sie diese mit den erstellten MySQL-Server- und Zabbix-Server-Instanzen:

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

Beispiel 2

Das Beispiel zeigt, wie Zabbix Server mit Unterstützung für eine PostgreSQL-Datenbank, einer auf dem Nginx-Webserver basierenden Zabbix-Weboberfläche und der SNMP-Trap-Funktion ausgeführt wird.

1. Erstellen Sie ein Netzwerk, das für Zabbix-Komponenten-Container vorgesehen ist:

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

2. Starten Sie eine leere PostgreSQL-Server-Instanz:

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. Starten Sie eine Zabbix-snmptraps-Instanz:

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. Starten Sie eine Zabbix-Server-Instanz und verknüpfen Sie diese mit der erstellten PostgreSQL-Server-Instanz:

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. Starten Sie die Zabbix-Weboberfläche und verknüpfen Sie diese mit den erstellten PostgreSQL-Server- und Zabbix-Server-Instanzen:

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

Beispiel 3

Das Beispiel zeigt, wie Zabbix Server mit Unterstützung für eine MySQL-Datenbank, einer auf dem Nginx-Webserver basierenden Zabbix-Weboberfläche und dem Zabbix Java gateway unter Verwendung von podman auf Red Hat 8 ausgeführt wird.

1. Erstellen Sie einen neuen Pod mit dem Namen zabbix und freigegebenen Ports (Weboberfläche, Zabbix-Server-Trapper):

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

2. (optional) Starten Sie den Zabbix-Agent-Container im 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. Erstellen Sie auf dem Host das Verzeichnis ./mysql/ und starten Sie 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. Starten Sie den Zabbix-Server-Container:

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. Starten Sie den Zabbix Java Gateway-Container:

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

6. Starten Sie den Zabbix-Weboberflächen-Container:

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

Alternativ kann Zabbix mit dem Docker-Compose-Plugin installiert werden. Compose-Dateien zum Definieren und Ausführen von Zabbix-Komponenten mit mehreren Containern sind im offiziellen Zabbix-Docker-Repository auf GitHub verfügbar.

Diese Compose-Dateien werden als Beispiele hinzugefügt; sie sind überladen. Sie enthalten zum Beispiel Proxys mit Unterstützung sowohl für MySQL als auch für SQLite3.

Um die von Zabbix bereitgestellten Docker-Compose-Dateien zu erhalten, klonen Sie das Repository:

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

Wechseln Sie zur erforderlichen Version:

git checkout 8.0

Konfigurieren Sie die Compose-Dateien und erstellen und starten Sie die Container:

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

Ersetzen Sie docker-compose_v3_alpine_mysql_latest.yaml im obigen Befehl durch die erforderliche Konfigurationsdatei.

Die folgenden Optionen sind verfügbar:

Speicher

Compose-Dateien sind so konfiguriert, dass sie lokalen Speicher auf einem Host-Rechner unterstützen. Docker Compose erstellt ein Verzeichnis zbx_env in dem Ordner mit der Compose-Datei, wenn Sie Zabbix-Komponenten mit der Compose-Datei ausführen. Das Verzeichnis enthält dieselbe Struktur wie im Abschnitt Volumes beschrieben sowie ein Verzeichnis für die Datenbankspeicherung.

Es gibt außerdem Volumes im Nur-Lese-Modus für die Dateien /etc/localtime und /etc/timezone.

Umgebungsvariablen

Die Variablendateien haben die folgende Namensstruktur: .env_<Typ der Komponente> und befinden sich im Verzeichnis env_vars directory. Siehe Umgebungsvariablen für Details zur Benennung der Variablen und zur verfügbaren Auswahl.

Beispiele

Beispiel 1

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

Der Befehl lädt die neuesten Zabbix-8.0-Images für jede Zabbix-Komponente herunter und startet sie im Detached-Modus.

Beispiel 2

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

Der Befehl lädt das Basis-Image Ubuntu 24.04 (noble) herunter, erstellt dann die Zabbix-8.0-Komponenten lokal und startet sie im Detached-Modus.