コンテナからのアップグレード
概要
このセクションでは、Zabbix 8.2.x コンテナへの正常なアップグレードに必要な手順について説明します。
以下の項目について、それぞれ手順を説明します。
アップグレードする前に、関連するアップグレードに関する注意事項を必ず確認してください。
アップグレードを開始する前に、ユーザーにアップグレードに必要なデータベース権限が付与されていることを確認してください。
Zabbix 6.0 以前からアップグレードする場合、アップグレード中に決定論的トリガーを作成する必要があります。
MySQL/MariaDB でバイナリログが有効になっている場合、これにはスーパーユーザー権限、または変数/設定パラメータ log_bin_trust_function_creators = 1 の設定が必要です。
変数の設定方法については、データベース作成スクリプトを参照してください。
コンソールから実行する場合、変数の設定は一時的なものとなり、Docker の再起動時に解除されることに注意してください。
この場合、SQL サービスは実行したままにし、docker compose down zabbix-server を実行して zabbix-server サービスのみを停止した後、docker compose up -d zabbix-server を実行してください。
または、この変数を設定ファイルで設定することもできます。
データベースのサイズによっては、データベースのバージョン 8.2 へのアップグレードに長時間かかる場合があります。
Zabbixコンポーネントイメージのアップグレード
Zabbixコンポーネントコンテナのベースとして使用しているDockerイメージをアップグレードする手順です。
以下の手順では、Zabbixプロキシを例として使用します。
zabbix-proxy-sqlite3 を使用するコンポーネントのコンテナ名に置き換えてください。
1. すべてのコンテナを確認し、コンテナ名と現在のイメージバージョンを特定します。
docker ps -a
# CONTAINER ID IMAGE (...) NAMES
# 5a0c2e3d02b4 zabbix/zabbix-proxy-sqlite3:alpine-8.2-latest (...) zabbix-proxy-sqlite3
2. 新しいイメージバージョンを取得します。
docker pull zabbix/zabbix-proxy-sqlite3:alpine-8.2-latest
3. Zabbixコンポーネントコンテナを停止します。
docker stop zabbix-proxy-sqlite3
4. Zabbixコンポーネントコンテナを削除します。
続行する前に、元の docker run コマンドで使用したすべての設定フラグとボリュームマウントを記録していることを確認してください。これらはコンテナの再作成時に必要になります。
docker rm zabbix-proxy-sqlite3
5. 更新したイメージを使用して新しいコンテナを起動します。
docker run --name zabbix-proxy-sqlite3 \
-e ZBX_SERVER_HOST=192.0.2.1 \
-e ZBX_PROXYMODE=0 \
-e ZBX_HOSTNAME=zabbix-proxy-sqlite3 \
-v zabbix-proxy-data:/var/lib/zabbix/db_data \
--init \
-d \
zabbix/zabbix-proxy-sqlite3:alpine-8.2-latest
Zabbixコンテナの実行方法の詳細については、Docker (manual deployment)を参照してください。
6. コンテナのログを確認し、アップグレードが正常に完了したことを確認します。
docker logs -f zabbix-proxy-sqlite3
Docker Composeファイルのアップグレード
この手順では、Zabbixコンポーネントのデプロイに使用するDocker Composeファイルをアップグレードします。
Docker Composeを使用してZabbixをインストールした場合は、この手順に従ってください。
1. すべてのコンテナを確認し、名前と現在のイメージバージョンを特定します。
docker ps -a
# CONTAINER ID IMAGE (...) NAMES
# d095f486deef zabbix/zabbix-server-mysql:alpine-8.0-latest (...) zabbix-docker-zabbix-server-1
# 70627d833da0 zabbix/zabbix-web-nginx-mysql:alpine-8.0-latest (...) zabbix-docker-zabbix-web-nginx-mysql-1
# aaaa664cc185 zabbix/zabbix-server-mysql:alpine-8.0-latest (...) zabbix-docker-server-db-init-1
# 9ab3e77492ff mysql:8.0-oracle (...) zabbix-docker-mysql-server-1
2. 以前にクローンしたZabbix Dockerリポジトリに移動し、最新の更新を取得して、8.2ブランチに切り替えます。
ローカルリポジトリの.env、compose.yaml、その他のファイルを変更している場合、git pullによって上書きされる可能性があります。
この手順を実行する前に、ローカルでの変更をバックアップしてください。
cd zabbix-docker
git pull
git checkout 8.2
3. 更新されたDocker Composeファイルを使用して、Zabbixコンポーネントをデプロイします。
# データベースとしてMySQLを使用する場合:
docker compose -f ./compose.yaml up -d
# データベースとしてPostgreSQLを使用する場合:
docker compose -f ./compose_pgsql.yaml up -d
すべてのコンテナが再作成されて起動した後、データ収集が再開されるまで1~3分かかる場合があります。
Zabbixコンテナの実行について詳しくは、Docker Composeを参照してください。
4. コンテナのログを確認して、アップグレードが正常に完了したことを確認します(zabbix-docker-zabbix-server-1をコンポーネントのコンテナ名に置き換えてください)。
docker logs -f zabbix-docker-zabbix-server-1