5 Instalação a partir de containers

Visão geral

Esta seção descreve como implantar o Zabbix com Docker ou Docker Compose.

O Zabbix fornece oficialmente:

• Imagens Docker separadas para cada componente do Zabbix para serem executadas como containers portáteis e autossuficientes.
• Arquivos Compose para definir e executar componentes Zabbix multi-container no Docker.

Arquivos de origem

Os arquivos de origem do Docker estão armazenados no repositório oficial do Zabbix no GitHub, onde você pode acompanhar as últimas alterações nos arquivos ou fazer um fork do projeto para criar suas próprias imagens.

Docker

O Zabbix fornece imagens baseadas em uma variedade de imagens de sistemas operacionais base. Para obter a lista de imagens de sistemas operacionais base suportadas para um componente específico do Zabbix, consulte a descrição do componente no Docker Hub. Todas as imagens do Zabbix são configuradas para reconstruir as imagens mais recentes se as imagens base forem atualizadas.

Instalação

Para obter a imagem do componente Zabbix, execute:

docker pull zabbix/zabbix-server-mysql

Substitua zabbix/zabbix-server-mysql pelo nome do repositório docker necessário.

Este comando irá baixar a versão mais recente e estável do componente Zabbix baseada no sistema operacional Alpine Linux. Você pode adicionar tags ao nome do repositório para obter uma imagem baseada em outro sistema operacional ou de uma versão principal ou secundária específica do Zabbix.

Os seguintes repositórios estão disponíveis no Docker Hub:

Tags

As imagens oficiais dos componentes Zabbix podem conter as seguintes tags:

Configuração inicial

Após baixar as imagens, inicie os containers executando o comando docker run seguido de argumentos adicionais para especificar as variáveis de ambiente e/ou pontos de montagem necessários. Alguns exemplos de configuração são fornecidos abaixo.

Variáveis de ambiente

Todas as imagens dos componentes do Zabbix fornecem variáveis de ambiente para controlar a configuração. As variáveis de ambiente suportadas estão listadas no repositório do componente.

Essas variáveis de ambiente são opções dos arquivos de configuração do Zabbix, mas com um método de nomenclatura diferente. Por exemplo, ZBX_LOGSLOWQUERIES é igual a LogSlowQueries dos arquivos de configuração do Zabbix server ou do Zabbix proxy.

As seguintes variáveis de ambiente são específicas para componentes Docker e não existem nos arquivos de configuração do Zabbix:

Volumes

As imagens permitem montar volumes usando os seguintes pontos de montagem:

Para informações adicionais, consulte os repositórios oficiais do Zabbix no Docker Hub.

Exemplos

Exemplo 1

O exemplo demonstra como executar o Zabbix server com suporte ao banco de dados MySQL, interface web do Zabbix baseada no servidor web Nginx e Zabbix Java gateway.

1. Crie uma rede dedicada para os containers dos componentes do Zabbix:

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

2. Inicie uma instância vazia do servidor 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. Inicie a instância do 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. Inicie a instância do Zabbix server e vincule a instância ao servidor MySQL criado:

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. Inicie a interface web do Zabbix e vincule a instância ao servidor MySQL e ao Zabbix server criados:

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

Exemplo 2

O exemplo demonstra como executar o Zabbix server com suporte ao banco de dados PostgreSQL, interface web do Zabbix baseada no servidor web Nginx e recurso de SNMP trap.

1. Crie uma rede dedicada para os containers dos componentes do Zabbix:

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

2. Inicie uma instância vazia do servidor 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. Inicie a instância do 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. Inicie a instância do Zabbix server e vincule a instância ao servidor PostgreSQL criado:

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. Inicie a interface web do Zabbix e vincule a instância ao servidor PostgreSQL e ao Zabbix server criados:

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

Exemplo 3

O exemplo demonstra como executar o Zabbix server com suporte ao banco de dados MySQL, interface web do Zabbix baseada no servidor web Nginx e Zabbix Java gateway usando podman no Red Hat 8.

1. Crie um novo pod com o nome zabbix e portas expostas (interface web, Zabbix server trapper):

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

2. (opcional) Inicie o container do Zabbix agent na localização do 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-70:latest

3. Crie o diretório ./mysql/ no host e inicie o 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. Inicie o container do 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-70

5. Inicie o container do Zabbix Java Gateway:

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

6. Inicie o container da interface web do 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-70

Docker Compose

Alternativamente, o Zabbix pode ser instalado usando o plugin Docker Compose. Os arquivos Compose para definir e executar componentes Zabbix multi-contêiner estão disponíveis no repositório oficial do Zabbix Docker no GitHub.

Esses arquivos compose são adicionados como exemplos; eles são sobrecarregados. Por exemplo, eles contêm proxies com suporte tanto para MySQL quanto para SQLite3.

Para obter os arquivos Docker compose fornecidos pelo Zabbix, clone o repositório:

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

Altere para a versão necessária:

git checkout 8.0

Configure os arquivos de configuração e crie e inicie os contêineres:

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

Substitua docker-compose_v3_alpine_mysql_latest.yaml no comando acima pelo arquivo de configuração necessário.

As seguintes opções estão disponíveis:

Armazenamento

Os arquivos Compose são configurados para suportar armazenamento local em uma máquina host. O Docker Compose criará um diretório zbx_env na pasta com o arquivo compose quando você executar os componentes do Zabbix usando o arquivo compose. O diretório conterá a mesma estrutura descrita na seção Volumes e o diretório para armazenamento do banco de dados.

Também existem volumes em modo somente leitura para os arquivos /etc/localtime e /etc/timezone.

Variáveis de ambiente

Os arquivos de variáveis têm a seguinte estrutura de nomenclatura: .env_<tipo de componente> e estão localizados no diretório env_vars diretório. Consulte variáveis de ambiente para obter detalhes sobre a nomenclatura das variáveis e a seleção disponível.

Exemplos

Exemplo 1

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

O comando fará o download das imagens mais recentes do Zabbix 8.0 para cada componente do Zabbix e as executará em modo detach.

Exemplo 2

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

O comando fará o download da imagem base Ubuntu 24.04 (noble), depois irá construir localmente os componentes do Zabbix 8.0 e executá-los em modo detach.