5 Instal·lació des de contenidors

Docker

Zabbix proporciona imatges Docker per a cada component Zabbix com a contenidors portàtils i autosuficients per accelerar el desplegament i el procediment d'actualització.

Els components Zabbix inclouen suport de bases de dades MySQL i PostgreSQL, compatibilitat amb el servidor web Apache2 i Nginx. Aquestes imatges són separades en diferents imatges.

Imatges base de Docker

Es proporcionen components Zabbix amb Ubuntu, Alpine Linux i CentOS:

Totes les imatges són configurades per reconstruir les darreres imatges si s'actualitzen les imatges base.

Font dels arxius Docker

Hom pot fer un seguiment dels canvis dels fitxers de Docker mitjançant el [repositori oficial] de Zabbix (https://github.com/zabbix/zabbix-docker) a github.com. Podeu bifurcar el projecte o crear les vostres pròpies imatges basades en els fitxers oficials de Docker.

Estructura

Tots els components de Zabbix són disponibles als següents repositoris Docker:

• Dispositiu Zabbix amb suport de bases de dades MySQL i servidor web Nginx - zabbix/zabbix-appliance
• Agent Zabbix - zabbix/zabbix-agent
• Servidor Zabbix
  • Servidor Zabbix amb suport de bases de dades MySQL - zabbix/zabbix-server-mysql
  • Servidor Zabbix amb suport de bases de dades PostgreSQL - zabbix/zabbix-server-pgsql
• Interfície web Zabbix
  • Interfície web Zabbix basada en el servidor web Apache2 amb suport de bases de dades MySQL - zabbix/zabbix-web-apache-mysql
  • Interfície web de Zabbix basada en el servidor web Apache2 amb suport de bases de dades PostgreSQL - zabbix/zabbix-web-apache-pgsql
  • Interfície web Zabbix basada en el servidor web Nginx amb suport de bases de dades MySQL - zabbix/zabbix-web-nginx-mysql
  • Interfície web Zabbix basada en el servidor web Nginx amb suport de bases de dades PostgreSQL - zabbix/zabbix-web-nginx-pgsql
• Proxy Zabbix
  • Proxy Zabbix amb suport de bases de dades SQLite3 - zabbix/zabbix-proxy-sqlite3
  • Proxy Zabbix amb suport de bases de dades MySQL - zabbix/zabbix-proxy-mysql
• Zabbix Java Gateway - zabbix/zabbix-java-gateway

A més, hi ha suport per a trampes SNMP. Es proporciona com a repositori addicional (zabbix/zabbix-snmptraps) basat només en Ubuntu Trusty. Es pot enllaçar al servidor Zabbix i al proxy Zabbix.

Versions

Cada repositori de components Zabbix conté les etiquetes següents:

• latest: la darrera versió estable d'un component Zabbix basat en la imatge Linux Alpine.
• alpine-latest: la darrera versió estable d'un component Zabbix basat en la imatge d'Alpine Linux.
• ubuntu-latest: la darrera versió estable d'un component Zabbix basat en la imatge d'Ubuntu
• alpine-6.0-latest: darrera versió menor d'un component Zabbix 6.0 basat en la imatge d'Alpine Linux
• ubuntu-6.0-latest - darrera versió menor d'un component Zabbix 6.0 basat en la imatge d'Ubuntu
• alpine-6.0.* - diverses versions menors d'un component Zabbix 6.0 basades en la imatge Alpine Linux, on * és la versió menor del component Zabbix
• ubuntu-6.0.* - diverses versions menors d'un component Zabbix 6.0 basades en la imatge Alpine Linux, on * és la versió menor del component Zabbix

Configuració inicial

Després de descarregar les imatges, inicieu els contenidors executant l'ordre docker run seguida d'arguments addicionals per especificar variables d'entorn (#environment-variables) i/o [punts de muntatge] (#volumes). Tot seguit teniu alguns exemples de configuració.

Variables d'entorn

Totes les imatges de components de Zabbix proporcionen variables d'entorn per controlar la configuració. Aquestes variables d'entorn s'enumeren a cada repositori de components. Aquestes variables d'entorn són opcions dels fitxers de configuració de Zabbix, però amb un mètode de denominació diferent. Per exemple, ZBX_LOGSLOWQUERIES és igual a LogSlowQueries dels fitxers de configuració del servidor Zabbix i dels proxys Zabbix.

Alguns components tenen variables d'entorn específiques, que no existeixen als fitxers de configuració oficials de Zabbix:

Volums

Les imatges permeten emprar determinats punts de muntatge. Aquests punts de muntatge són diferents i depenen del tipus de component Zabbix:

Per obtindre més informació, veieu els dipòsits oficials de Zabbix a Docker Hub.

Exemples

Exemple 1

L'exemple mostra com executar el servidor Zabbix amb suport de bases de dades MySQL, la interfície web Zabbix basada en el servidor web Nginx i la passarel·la Java Zabbix.

1. Creeu una xarxa dedicada als contenidors de components Zabbix:

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

2. Inicieu la instància del servidor MySQL buida

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.0 \
             --character-set-server=utf8 --collation-server=utf8_bin \
             --default-authentication-plugin=mysql_native_password

3. Inicieu la instància de passarel·la Java de Zabbix

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

4. Inicieu la instància del servidor Zabbix i enllaceu la instància amb la instància del servidor MySQL creada

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-6.0-latest

5. Inicieu la interfície web de Zabbix i enllaçeu la instància amb el servidor MySQL creat i les instàncies del servidor 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-6.0-latest

Exemple 2

L'exemple ensenya com executar el servidor Zabbix amb suport de bases de dades PostgreSQL, la interfície web Zabbix basada en el servidor web Nginx i la funció de trampa SNMP.

1. Creeu una xarxa dedicada als contenidors de components Zabbix:

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

2. Inicieu la instància del servidor PostgreSQL buida

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. Inicieu la instància 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-6.0-latest

4. Inicieu la instància del servidor Zabbix i enllaceu la instància amb la instància del servidor PostgreSQL creada

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-6.0-latest

5. Inicieu la interfície web de Zabbix i enllaceu la instància amb el servidor PostgreSQL creat i les instàncies del servidor 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-6.0-latest

Exemple 3

L'exemple mostra com executar el servidor Zabbix amb suport de bases de dades MySQL, basat en la interfície web de Zabbix al servidor web Nginx i a la passarel·la Zabbix Java emprant "podman" a Red Hat 8.

1. Creeu un pod nou amb el nom "zabbix" i els ports exposats (interfície web, trapper del servidor Zabbix):

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

2. (opcional) Inicieu el contenidor de l'agent Zabbix a la ubicació 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-50:latest

3. Creeu el directori ./mysql/ a l'equip i inicieu el servidor Oracle MySQL 8.0:

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.0 \
             --character-set-server=utf8 --collation-server=utf8_bin \
             --default-authentication-plugin=mysql_native_password

4. Inicieu el contenidor del servidor 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-60

5. Inicieu el contenidor Zabbix Java Gateway:

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

6. Inicieu el contenidor de la interfície web 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-60

Composició Docker

Zabbix també proporciona fitxers de composició per definir i executar components Zabbix multicontenidor a Docker. Aquests fitxers de redacció són disponibles al dipòsit oficial de docker de Zabbix a github.com: https://github.com/zabbix/zabbix-docker. Aquests fitxers de composició s'afegeixen com a exemples, es substitueixen. Per exemple, contenen proxys que admeten MySQL i SQLite3.

Hi ha diverses versions diferents dels fitxers de composició:

Emmagatzematge

Els fitxers de redacció són configurats per admetre l'emmagatzematge local a un equip. Docker Compose crearà un directori zbx_env a la carpeta amb el fitxer de composició quan executeu components Zabbix amb el fitxer de composició. El directori contindrà la mateixa estructura que la descrita anteriorment a la secció Volums i el directori per emmagatzemar la base de dades.

També hi ha volums de només lectura per als fitxers /etc/localtime i /etc/timezone.

Arxius d'entorn

Al mateix directori amb els fitxers de redacció a github.com, podeu trobar fitxers amb variables d'entorn predeterminades per a cada component del fitxer de composició. Aquests fitxers d'entorn s'anomenen així: .env_<tipus de component>.

Exemples

Exemple 1

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

L'ordre descarregarà les darreres imatges de Zabbix 6.0 per a cada component Zabbix i les executarà en mode de separació.

Exemple 2

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

L'ordre descarregarà la imatge base Ubuntu 20.04 (focal), després crearà components de Zabbix 6.0 localment i els executarà en mode de separació.