L'area di lavoro Plug-in Master offre la possibilità di aggiornare la versione del plug-in Master nel Salt Master in modo che corrisponda alla versione di Automation Config. Questa funzionalità è supportata per le distribuzioni nel cloud e in locale. È inoltre possibile scaricare la versione più recente del plug-in Master.
![](images/GUID-B303FB33-5467-4D18-A6F9-F93889B7680B-low.png)
L'area di lavoro Plug-in Master fornisce informazioni su stato dei plug-in, versione dei plug-in, versione di Salt, JID dell'ultimo aggiornamento e molto altro. La versione più recente di sseapiclient
è disponibile anche tramite l'area di lavoro Plug-in Master. Per ulteriori informazioni, vedere Utilizzo dell'API.
Il plug-in Master consente ai Salt Master di comunicare con Automation Config. Il plug-in include anche una serie di impostazioni che è possibile modificare per migliorare le prestazioni. Per ulteriori informazioni, vedere il riferimento alle impostazioni di configurazione del plug-in Master.
RaaS contiene la versione corrente e precedente del plug-in Master. Quando il Salt Master si connette a RaaS, il Salt Master verifica se RaaS dispone di versioni del plug-in che non ha. Se il Salt Master non dispone di tali versioni del plug-in, il Salt Master recupera i plug-in da RaaS e li memorizza nella cache in locale in /var/cache/salt/master/plugin_cache/
.
Quando è disponibile una nuova versione di Automation Config, il plug-in non viene aggiornato automaticamente. È necessario avviare autonomamente il processo di aggiornamento. È consigliabile eseguire l'aggiornamento alla versione più recente del plug-in quando disponibile.
Il processo di aggiornamento del plug-in Master si basa sul modulo service
e sullo stato service.running
di Salt per riavviare il Salt Master dopo l'aggiornamento del plug-in. Il modulo service
dipende dal gestore init della distribuzione, ad esempio systemd
.
Se si esegue il Salt Master in un contenitore o in una distribuzione che non utilizza un gestore init, è necessario riavviare manualmente il Salt Master dopo l'aggiornamento. Se non si riavvia il Salt Master, l'area di lavoro Plug-in Master segnala che nel Salt Master è in esecuzione una versione del plug-in obsoleta.
Prima di iniziare
Per poter utilizzare l'area di lavoro Plug-in Master, è necessario soddisfare i seguenti prerequisiti:
- Installare il plug-in Master nel proprio Salt Master. Per ulteriori informazioni, vedere Installazione e configurazione del plug-in Master.
- Verificare che la chiave del Salt Master sia stata accettata nell'interfaccia utente di Automation Config.
- Verificare che il Salt Master sia in esecuzione come
root
. Se il Salt Master è in esecuzione come utente non root, l'aggiornamento non riesce. - Assicurarsi che nel Salt Master sia in esecuzione Salt versione 3002.1 o successiva. Se nel Salt Master è in esecuzione la versione 3002 o precedente, è necessario aggiornare la versione di Salt prima di poter utilizzare l'area di lavoro Plug-in Master. Per ulteriori informazioni, vedere Aggiornamento di Salt.
- Assicurarsi che nel Salt Master sia in esecuzione la versione 8.11.2 o successiva del plug-in Master. Se nel Salt Master viene eseguita la versione 8.11.1 o una versione precedente, è necessario aggiornare manualmente il plug-in prima di poter utilizzare l'area di lavoro Plug-in Master. Per ulteriori informazioni, vedere Aggiornamento del plug-in Master utilizzando la CLI.
Aggiornamento del plug-in Master
È possibile aggiornare la versione del plug-in Master in uno o più Salt Master.
È possibile aggiornare la versione del plug-in Master solo tramite l'area di lavoro Plug-in Master se lo stato del plug-in è Richiede l'aggiornamento. Se lo stato del plug-in indica che il Salt Master richiede un intervento manuale, è necessario accedere al Salt Master per risolvere il problema. Vedere Risoluzione dei problemi relativi all'aggiornamento del plug-in per ulteriori informazioni.
Per aggiornare il plug-in Master:
- In Automation Config, selezionare .
- Selezionare un Salt Master con lo stato del plug-in Richiede l'aggiornamento.
- Fare clic su Aggiorna.
- Rivedere le informazioni nella finestra di dialogo per assicurarsi di aver selezionato il Salt Master corretto.
- Fare clic su Aggiorna.
- Per monitorare l'avanzamento dell'aggiornamento, fare clic su JID ultimo aggiornamento.
- Nell'area di lavoro Plug-in Master, verificare che lo stato del plug-in sia cambiato in Aggiornato.
Se l'aggiornamento non riesce, vedere Risoluzione dei problemi relativi all'aggiornamento del plug-in.
Risoluzione dei problemi relativi all'aggiornamento del plug-in
Se l'aggiornamento del plug-in non riesce, è necessario risolvere manualmente il problema accedendo al Salt Master. Non è presente alcun ripristino automatico per gli aggiornamenti non riusciti del plug-in.
- Problemi dell'infrastruttura
- Problemi di configurazione con le macchine virtuali
- Problemi di connessione con il Salt Master
Provare a eseguire i passaggi seguenti per identificare la causa dell'aggiornamento non riuscito:
- Verificare il JID ultimo aggiornamento e rivedere i dati non elaborati per eventuali errori.
- Eseguire
systemctl status salt-master
per verificare lo stato del serviziosalt-master
. - Eseguire
salt-master -l debug
per avviare il Salt Master in modalità di debug. - Scaricare il plug-in Master dall'area di lavoro Plug-in Master e installare manualmente il plug-in.