Instalacja z kontenerów

Przegląd

Ta sekcja opisuje, jak wdrożyć Zabbix za pomocą Docker lub Docker Compose.

Zabbix oficjalnie udostępnia:

• Oddzielne obrazy Docker dla każdego komponentu Zabbix, umożliwiające ich uruchamianie jako przenośnych i samowystarczalnych kontenerów.
• Pliki Compose do definiowania i uruchamiania wielokontenerowych komponentów Zabbix w Docker.

Pliki źródłowe

Pliki źródłowe Dockerfile są przechowywane w oficjalnym repozytorium Zabbix na GitHubie, gdzie można śledzić najnowsze zmiany w plikach lub sforkować projekt, aby tworzyć własne obrazy.

Docker

Zabbix udostępnia obrazy oparte na różnych bazowych obrazach systemów operacyjnych. Aby uzyskać listę obsługiwanych bazowych obrazów systemów operacyjnych dla określonego komponentu Zabbix, zobacz opis komponentu w Docker Hub. Wszystkie obrazy Zabbix są skonfigurowane tak, aby przebudowywać najnowsze obrazy, jeśli obrazy bazowe zostaną zaktualizowane.

Instalacja

Aby pobrać obraz komponentu Zabbix, uruchom:

docker pull zabbix/zabbix-server-mysql

Zastąp zabbix/zabbix-server-mysql nazwą wymaganego repozytorium dockera.

To polecenie pobierze najnowszą stabilną wersję komponentu Zabbix opartą na systemie operacyjnym Alpine Linux. Możesz dodać tagi do nazwy repozytorium, aby uzyskać obraz oparty na innym systemie operacyjnym lub obraz określonej głównej albo pobocznej wersji Zabbix.

W Docker Hub dostępne są następujące repozytoria:

Tagi

Oficjalne obrazy komponentów Zabbix mogą zawierać następujące tagi:

Konfiguracja początkowa

Po pobraniu obrazów uruchom kontenery, wykonując polecenie docker run, a następnie podając dodatkowe argumenty określające wymagane zmienne środowiskowe i/lub punkty montowania. Poniżej przedstawiono kilka przykładów konfiguracji.

Zmienne środowiskowe

Wszystkie obrazy komponentów Zabbix udostępniają zmienne środowiskowe do sterowania konfiguracją. Obsługiwane zmienne środowiskowe są wymienione w repozytorium komponentu.

Te zmienne środowiskowe są odpowiednikami opcji z plików konfiguracyjnych Zabbix, ale mają inną metodę nazewnictwa. Na przykład ZBX_LOGSLOWQUERIES jest odpowiednikiem LogSlowQueries z plików konfiguracyjnych Zabbix serwer lub Zabbix proxy.

Następujące zmienne środowiskowe są specyficzne dla komponentów Docker i nie występują w plikach konfiguracyjnych Zabbix:

Woluminy

Obrazy umożliwiają montowanie woluminów przy użyciu następujących punktów montowania:

Aby uzyskać dodatkowe informacje, zobacz oficjalne repozytoria Zabbix w Docker Hub.

Przykłady

Przykład 1

Ten przykład pokazuje, jak uruchomić serwer Zabbix z obsługą bazy danych MySQL, interfejs webowy Zabbix oparty na serwerze webowym Nginx oraz Zabbix Java gateway.

1. Utwórz sieć przeznaczoną dla kontenerów komponentów Zabbix:

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

2. Uruchom pustą instancję serwera 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. Uruchom instancję 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. Uruchom instancję serwera Zabbix i połącz ją z utworzoną instancją serwera 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-8.0-latest

5. Uruchom interfejs webowy Zabbix i połącz tę instancję z utworzonymi instancjami serwera MySQL i serwera 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-8.0-latest

Przykład 2

Ten przykład pokazuje, jak uruchomić serwer Zabbix z obsługą bazy danych PostgreSQL, interfejs webowy Zabbix oparty na serwerze webowym Nginx oraz funkcję pułapek SNMP.

1. Utwórz sieć przeznaczoną dla kontenerów komponentów Zabbix:

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

2. Uruchom pustą instancję serwera 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. Uruchom instancję 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. Uruchom instancję serwera Zabbix i połącz ją z utworzoną instancją serwera 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-8.0-latest

5. Uruchom interfejs webowy Zabbix i połącz tę instancję z utworzonymi instancjami serwera PostgreSQL i serwera 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-8.0-latest

Przykład 3

Ten przykład pokazuje, jak uruchomić serwer Zabbix z obsługą bazy danych MySQL, interfejs webowy Zabbix oparty na serwerze webowym Nginx oraz Zabbix Java gateway przy użyciu podman w systemie Red Hat 8.

1. Utwórz nowy pod o nazwie zabbix i udostępnionych portach (interfejs webowy, trapper serwera Zabbix):

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

2. (opcjonalnie) Uruchom kontener Zabbix agent w podzie 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. Utwórz katalog ./mysql/ na hoście i uruchom serwer Oracle MySQL 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. Uruchom kontener serwera 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-74

5. Uruchom kontener 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. Uruchom kontener interfejsu webowego 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

Alternatywnie Zabbix można zainstalować przy użyciu wtyczki Docker Compose. Pliki Compose do definiowania i uruchamiania wielokontenerowych komponentów Zabbix są dostępne w oficjalnym repozytorium Zabbix Docker w serwisie GitHub.

Te pliki Compose zostały dodane jako przykłady; są rozbudowane. Na przykład zawierają proxy z obsługą zarówno MySQL, jak i SQLite3.

Aby uzyskać pliki Docker Compose udostępniane przez Zabbix, sklonuj repozytorium:

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

Przełącz się na wymaganą wersję:

git checkout 8.0

Skonfiguruj pliki Compose oraz utwórz i uruchom kontenery:

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

Zastąp docker-compose_v3_alpine_mysql_latest.yaml w powyższym poleceniu wymaganym plikiem konfiguracyjnym.

Dostępne są następujące opcje:

Pamięć masowa

Pliki Compose są skonfigurowane tak, aby obsługiwać lokalną pamięć masową na maszynie hosta. Docker Compose utworzy katalog zbx_env w folderze z plikiem compose podczas uruchamiania komponentów Zabbix przy użyciu pliku compose. Katalog będzie zawierał tę samą strukturę, jak opisano w sekcji Volumes, oraz katalog do przechowywania bazy danych.

Dostępne są również wolumeny w trybie tylko do odczytu dla plików /etc/localtime i /etc/timezone.

Zmienne środowiskowe

Pliki zmiennych mają następującą strukturę nazewnictwa: .env_<typ komponentu> i znajdują się w katalogu env_vars. Szczegółowe informacje o nazewnictwie zmiennych i dostępnych opcjach wyboru można znaleźć w sekcji zmienne środowiskowe.

Przykłady

Przykład 1

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

Polecenie pobierze najnowsze obrazy Zabbix 8.0 dla każdego komponentu Zabbix i uruchomi je w trybie odłączonym.

Przykład 2

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

Polecenie pobierze obraz bazowy Ubuntu 24.04 (noble), a następnie zbuduje lokalnie komponenty Zabbix 8.0 i uruchomi je w trybie odłączonym.