5 コンテナでのインストール

概要

このセクションでは、Docker または Docker Compose を使用して Zabbix をデプロイする方法について説明します。

Zabbix は公式に以下を提供しています。

• 各 Zabbix コンポーネントごとに個別の Docker イメージ。これにより、移植可能で自己完結型のコンテナとして実行できます。
• Docker で複数コンテナの Zabbix コンポーネントを定義および実行するための Compose ファイル。

ソースファイル

Dockerファイルのソースは、GitHub 上の Zabbix の公式リポジトリに保存されており、そこで最新のファイル変更を追跡したり、プロジェクトをフォークして独自のイメージを作成したりできます。

Docker

Zabbix は、さまざまな OS ベースイメージに基づくイメージを提供しています。 特定の Zabbix コンポーネントでサポートされているベースオペレーティングシステムイメージの一覧を取得するには、Docker Hub にある各コンポーネントの説明を参照してください。 すべての Zabbix イメージは、ベースイメージが更新された場合に最新イメージを再ビルドするよう設定されています。

インストール

Zabbix コンポーネントのイメージを取得するには、次を実行します。

docker pull zabbix/zabbix-server-mysql

zabbix/zabbix-server-mysql を必要な Docker リポジトリ名に置き換えてください。

このコマンドは、Alpine Linux OS ベースの最新の安定版 Zabbix コンポーネントバージョンを取得します。 別のオペレーティングシステムをベースにしたイメージ、または特定の Zabbix メジャー/マイナーバージョンのイメージを取得するには、リポジトリ名に tags を追加できます。

Docker Hub では、次のリポジトリを利用できます。

タグ

公式のZabbixコンポーネントイメージには、以下のタグが含まれる場合があります。

Docker Compose

別の方法として、ZabbixはDocker Composeプラグインを使用してインストールできます。 複数コンテナのZabbixコンポーネントを定義して実行するためのComposeファイルは、GitHub上の公式のZabbix Dockerリポジトリで提供されています。

これらのcomposeファイルは例として追加されていますが、多くの構成が含まれています。 たとえば、MySQLとSQLite3の両方をサポートするプロキシが含まれています。

Zabbixが提供するDocker composeファイルを取得するには、リポジトリをクローンします。

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

必要なバージョンに切り替えます。

git checkout 7.0

Compose設定ファイルを使用してコンテナを作成し、起動します。

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

上記のコマンド内のdocker-compose_v3_alpine_mysql_latest.yamlを、必要な設定ファイルに置き換えてください。

以下のオプションを利用できます。

環境変数

変数ファイルは、.env_<コンポーネントの種類>という名前構造を持ち、env_varsディレクトリにあります。変数の名前と利用可能な選択の詳細については、環境変数を参照してください。

ボリューム

イメージでは、以下のマウントポイントを使用してボリュームをマウントできます。

詳細については、Docker Hub の Zabbix 公式リポジトリを参照してください。

Makefile

The Zabbix Dockerfiles repository also provides a Makefile as a shortcut for common Docker Compose tasks. Instead of using the full docker compose command, you can use shorter make commands (run make help to see the available options):

# Default deployment (Zabbix server, web interface, MySQL, all on Alpine Linux)
make up

# Custom deployment (Zabbix server, web interface with custom Nginx ports, PostgreSQL, all on Ubuntu)
make up \
  OS=ubuntu \
  DB=pgsql \
  ZABBIX_WEB_NGINX_HTTP_PORT=8282 \
  ZABBIX_WEB_NGINX_HTTPS_PORT=8443

By default, make up starts only a minimal set of services (Zabbix server, web interface, and database). This keeps the setup lightweight and avoids starting components that may not be needed. To include additional components, you can use the following Compose profiles:

# Default deployment + Zabbix agent, Java gateway, web service, and SNMP traps:
make up COMPOSE_PROFILES=full

# COMPOSE_PROFILES=full + Zabbix proxy (MySQL and SQLite3):
make up COMPOSE_PROFILES=all

初期設定

イメージをダウンロードした後、必要な環境変数やマウントポイントを指定する追加引数を付けて、docker runコマンドを実行し、コンテナを起動します。 いくつかの設定例を以下に示します。

例

例 1

この例では、MySQLデータベースをサポートするZabbixサーバー、Nginx WebサーバーをベースとしたZabbix Webインターフェース、およびZabbix Javaゲートウェイを実行する方法を示します。

1. Zabbixコンポーネントコンテナ専用のネットワークを作成します。

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

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

3. Zabbix Javaゲートウェイインスタンスを起動します。

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

4. Zabbixサーバーインスタンスを起動し、作成した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-7.0-latest

5. Zabbix Webインターフェースを起動し、作成したMySQLサーバーインスタンスおよび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-7.0-latest

例 2

この例では、PostgreSQLデータベースをサポートするZabbixサーバー、Nginx WebサーバーをベースとしたZabbix Webインターフェース、およびSNMPトラップ機能を実行する方法を示します。

1. Zabbixコンポーネントコンテナ専用のネットワークを作成します。

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

2. 空の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. Zabbix snmptrapsインスタンスを起動します。

docker run --name zabbix-snmptraps -t \
      -v /zbx_instance/snmptraps:/var/lib/zabbix/snmptraps:rw \
      --network=zabbix-net \
      -p 162:1162/udp \
      --restart unless-stopped \
      -d zabbix/zabbix-snmptraps:alpine-7.0-latest

4. Zabbixサーバーインスタンスを起動し、作成した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-7.0-latest

5. Zabbix Webインターフェースを起動し、作成したPostgreSQLサーバーインスタンスおよび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-7.0-latest

例 3

この例では、Red Hat 8 上で podman を使用して、MySQLデータベースをサポートするZabbixサーバー、Nginx WebサーバーをベースとしたZabbix Webインターフェース、およびZabbix Javaゲートウェイを実行する方法を示します。

1. zabbix という名前の新しいpodを作成し、ポート（Webインターフェース、Zabbixサーバー trapper）を公開します。

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

2. （任意）zabbix 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. ホスト上に ./mysql/ ディレクトリを作成し、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. 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-70

5. 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. Zabbix Webインターフェースコンテナを起動します。

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