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 run コマンドを実行し、必要な環境変数やマウントポイントを指定する追加引数を続けて、コンテナを起動します。 いくつかの設定例を以下に示します。

環境変数

すべてのZabbixコンポーネントイメージは、設定を制御するための環境変数を提供しています。 サポートされている環境変数は、コンポーネントリポジトリに一覧表示されています。

これらの環境変数はZabbix設定ファイルのオプションに対応していますが、命名方法が異なります。 例えば、ZBX_LOGSLOWQUERIES は、Zabbix サーバー または Zabbix プロキシ 設定ファイル内の LogSlowQueries に相当します。

以下の環境変数はDockerコンポーネント固有のものであり、Zabbix設定ファイルには存在しません。

ボリューム

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

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

例

例 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.4-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.4-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.4-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 \
      -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-7.4-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.4-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.4-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-74: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-74

5. 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. 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-74

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.4

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

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

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

利用可能なオプションは次のとおりです。

ストレージ

Composeファイルは、ホストマシン上のローカルストレージをサポートするように構成されています。 Docker Composeは、Composeファイルを使用してZabbixコンポーネントを実行するときに、Composeファイルのあるフォルダーにzbx_envディレクトリを作成します。 このディレクトリには、ボリュームセクションで説明したものと同じ構造と、データベースストレージ用のディレクトリが含まれます。

/etc/localtimeおよび/etc/timezoneファイルに対して読み取り専用モードのボリュームもあります。

環境変数

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

例

例1

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

このコマンドは、各Zabbixコンポーネント向けの最新のZabbix 7.4イメージをダウンロードし、デタッチモードで実行します。

例2

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

このコマンドは、ベースイメージ Ubuntu 24.04（noble）をダウンロードし、その後Zabbix 7.4コンポーネントをローカルでビルドして、デタッチモードで実行します。