Aggiornamento dai container
Panoramica
Questa sezione descrive i passaggi necessari per eseguire correttamente l'upgrade dei container Zabbix 8.2.x.
Sono disponibili set di istruzioni separati per:
Prima dell'upgrade, assicurarsi di leggere le note sull'upgrade pertinenti!
Prima di avviare l'upgrade, verificare che gli utenti dispongano delle autorizzazioni necessarie sul database per eseguire l'upgrade.
Per gli upgrade da Zabbix 6.0 o versioni precedenti, durante l'upgrade sarà necessario creare trigger deterministici.
Se il logging binario è abilitato per MySQL/MariaDB, sono necessari i privilegi di superutente oppure è necessario impostare la variabile/parametro di configurazione log_bin_trust_function_creators = 1.
Per istruzioni su come impostare la variabile, vedere Script per la creazione del database.
Se la variabile viene impostata da una console, verrà impostata solo temporaneamente e sarà eliminata al riavvio di Docker.
In questo caso, mantenere in esecuzione il servizio SQL, arrestare solo il servizio zabbix-server eseguendo docker compose down zabbix-server, quindi eseguire docker compose up -d zabbix-server.
In alternativa, è possibile impostare questa variabile nel file di configurazione.
A seconda delle dimensioni del database, l'upgrade del database alla versione 8.2 potrebbe richiedere molto tempo.
Aggiornamento dell'immagine del componente Zabbix
Queste istruzioni aggiornano le immagini Docker utilizzate come base per i container dei componenti Zabbix.
I passaggi seguenti utilizzano un proxy Zabbix come esempio.
Sostituire zabbix-proxy-sqlite3 con il nome del container del proprio componente.
1. Controllare tutti i container per identificarne i nomi e le versioni correnti delle immagini:
docker ps -a
# CONTAINER ID IMAGE (...) NAMES
# 5a0c2e3d02b4 zabbix/zabbix-proxy-sqlite3:alpine-8.2-latest (...) zabbix-proxy-sqlite3
2. Scaricare la nuova versione dell'immagine:
docker pull zabbix/zabbix-proxy-sqlite3:alpine-8.2-latest
3. Arrestare il container del componente Zabbix:
docker stop zabbix-proxy-sqlite3
4. Rimuovere il container del componente Zabbix:
Assicurarsi di aver annotato tutti i flag di configurazione e i mount dei volumi utilizzati nel comando docker run originale prima di procedere, poiché saranno necessari per ricreare il container.
docker rm zabbix-proxy-sqlite3
5. Avviare un nuovo container utilizzando l'immagine aggiornata:
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
Per ulteriori informazioni sull'esecuzione dei container Zabbix, vedere Docker (distribuzione manuale).
6. Verificare che l'aggiornamento sia riuscito controllando i log del container:
docker logs -f zabbix-proxy-sqlite3
Aggiornamento del file Docker Compose
Queste istruzioni aggiornano i file Docker Compose utilizzati per la distribuzione dei componenti Zabbix. Seguire queste istruzioni se Zabbix è stato installato utilizzando Docker Compose.
1. Controllare tutti i container per identificarne i nomi e le versioni correnti delle immagini:
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. Accedere al repository Docker di Zabbix clonato in precedenza, scaricare gli aggiornamenti più recenti e passare al branch 8.2:
Se sono stati modificati .env, compose.yaml o altri file nel repository locale, git pull potrebbe sovrascriverli.
Eseguire il backup di tutte le modifiche locali prima di procedere.
cd zabbix-docker
git pull
git checkout 8.2
3. Distribuire i componenti Zabbix utilizzando il file Docker Compose aggiornato:
# Con MySQL come database:
docker compose -f ./compose.yaml up -d
# Con PostgreSQL come database:
docker compose -f ./compose_pgsql.yaml up -d
Dopo che tutti i container sono stati ricreati e avviati, potrebbero essere necessari 1–3 minuti prima che la raccolta dei dati riprenda. Per ulteriori informazioni sull'esecuzione dei container Zabbix, vedere Docker Compose.
4. Verificare che l'aggiornamento sia riuscito controllando i log del container (sostituire zabbix-docker-zabbix-server-1 con il nome del container del proprio componente):
docker logs -f zabbix-docker-zabbix-server-1