このセクションでは、Zabbix 8.0.x コンテナへのアップグレードを成功させるために必要な手順について説明します。
個々のZabbixコンポーネントイメージやDocker composeファイルのアップグレード用に、別々の手順が用意されています。
アップグレードの前に、関連するアップグレードノートを必ずお読みください!
アップグレードを開始する前に、ユーザーがアップグレードのために必要なデータベース権限を持っていることを確認してください。
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.0へのアップグレードにかなりの時間がかかる場合があります。
以下の手順は、任意のZabbixコンポーネントのアップグレードに使用できます。zabbix-server-mysqlを必要なコンポーネントのイメージ名に置き換えてください。
1. 現在のイメージバージョンを確認します:
2. 希望するイメージバージョンをプルします。例:
zabbix/zabbix-server-mysql:alpine-8.0-latestは、Alpine LinuxベースのMySQLサポート付きZabbixサーバー8.0の最新のマイナーバージョンをプルします。 必要なDockerリポジトリとタグの組み合わせの名前に置き換えてください。 利用可能なオプションの一覧については、コンテナからのインストールを参照してください。
3. コンテナを停止します:
4. コンテナを削除します:
5. docker runコマンドを実行し、必要な環境変数やマウントポイントを指定する追加引数を続けて、更新されたコンテナを起動します。
設定例
MySQLを使用したZabbixサーバー:
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-latestPostgreSQLを使用したZabbixサーバー:
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他のZabbixコンポーネントを含む、より多くの設定例は、コンテナからのインストールページで利用できます。
6. アップデートを確認します:
composeファイルを使用してZabbixをインストールした場合は、このセクションのアップグレード手順に従ってください。
1. 現在のイメージバージョンを確認します:
2. GitHubのリポジトリから最新の更新を取得し、必要なブランチに切り替えます:
3. 新しいcomposeファイルを使用してZabbixコンポーネントを起動します:
4. アップデートを確認します:
サポートされている環境変数やボリュームマウントポイントのリストなど、詳細についてはコンテナからのインストールを参照してください。