Upgrade from containers

Aperçu

Cette section décrit les étapes requises pour une mise à niveau réussie vers les conteneurs Zabbix 8.0.x.

Des ensembles d'instructions distincts sont disponibles pour la mise à niveau des images des composants Zabbix individuels et des fichiers Docker compose.

Avant la mise à niveau, assurez-vous de lire les notes de mise à niveau correspondantes !

Avant de commencer la mise à niveau, vérifiez que les utilisateurs disposent des autorisations nécessaires sur la base de données à des fins de mise à niveau.\

Pour les mises à niveau depuis Zabbix 6.0 ou une version antérieure, des déclencheurs déterministes devront être créés pendant la mise à niveau. Si la journalisation binaire est activée pour MySQL/MariaDB, cela nécessite des privilèges de superutilisateur ou la définition de la variable/du paramètre de configuration log_bin_trust_function_creators = 1. Consultez Scripts de création de base de données pour savoir comment définir la variable.
Notez que si l'exécution se fait depuis une console, la variable ne sera définie que temporairement et sera supprimée lorsqu'un Docker sera redémarré. Dans ce cas, laissez votre service SQL en cours d'exécution, arrêtez uniquement le service zabbix-server en exécutant 'docker compose down zabbix-server', puis 'docker compose up -d zabbix-server'.
Vous pouvez également définir cette variable dans le fichier de configuration.

Selon la taille de la base de données, la mise à niveau vers la version 8.0 peut prendre assez longtemps.

Mise à niveau d’une image Zabbix

Les étapes ci-dessous peuvent être utilisées pour mettre à niveau n’importe quel composant Zabbix. Remplacez zabbix-server-mysql par le nom d’image du composant requis.

1. Vérifiez la version actuelle de l’image :

docker inspect -f '{{ .Config.Image }}' zabbix-server-mysql

2. Récupérez la version d’image souhaitée, par exemple :

docker pull zabbix/zabbix-server-mysql:alpine-8.0-latest

zabbix/zabbix-server-mysql:alpine-8.0-latest récupérera la dernière version mineure publiée de Zabbix server 8.0 avec prise en charge de MySQL, basée sur Alpine Linux. Remplacez-la par le nom du dépôt Docker et la combinaison de tags dont vous avez besoin. Consultez Installation à partir de conteneurs pour obtenir la liste des options disponibles.

3. Arrêtez le conteneur :

docker stop zabbix-server-mysql

4. Supprimez le conteneur :

docker rm zabbix-server-mysql

5. Lancez le conteneur mis à jour en exécutant la commande docker run, suivie d’arguments supplémentaires pour spécifier les variables d’environnement et/ou les points de montage requis.

Exemples de configuration

Zabbix server avec 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

Zabbix server avec 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

Serveur 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=utf8mb4--collation-server=utf8mb4_bin \

D’autres exemples de configuration, y compris des exemples pour d’autres composants Zabbix, sont disponibles sur la page Installation à partir de conteneurs.

6. Vérifiez la mise à jour :

docker logs -f zabbix-server-mysql

Fichiers Compose

Suivez les instructions de mise à niveau de cette section si vous avez installé Zabbix à l’aide d’un fichier compose.

1. Vérifiez la version actuelle de l’image :

docker inspect -f '{{ .Config.Image }}' zabbix-server-mysql

2. Récupérez les dernières mises à jour depuis le dépôt GitHub et basculez vers la branche requise :

git pull
git checkout 8.0

3. Démarrez les composants Zabbix à l’aide du nouveau fichier compose :

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

4. Vérifiez la mise à jour :

docker logs -f zabbix-server-mysql

Consultez Installation à partir de conteneurs pour plus de détails, y compris les listes des variables d’environnement prises en charge et des points de montage de volumes.