コンテナからのインストール

概要

このセクションでは、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メジャーまたはマイナーバージョンのイメージを取得できます。

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

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

docker run --name zabbix-java-gateway -t \
    --network=zabbix-net \
    --restart unless-stopped \
    -d zabbix/zabbix-java-gateway:alpine-8.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-8.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-8.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 \
    -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. 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-8.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-8.0-latest

例3

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

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

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.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. 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ゲートウェイコンテナを起動します。

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ファイルは、公式のZabbix Dockerリポジトリで提供されています。

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

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

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

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

git checkout 8.0

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ディレクトリを作成します。 このディレクトリには、Volumesセクションで説明されているのと同じ構造と、データベースストレージ用のディレクトリが含まれます。

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

環境変数

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

例

例 1

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

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

例 2

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

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