コンテナからのアップグレード

概要

このセクションでは、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