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 SaltStack Config. Questa funzionalità è supportata per le distribuzioni nel cloud e in locale. È inoltre possibile scaricare la versione più recente del plug-in Master.

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 SaltStack 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 SaltStack 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.

Nota:

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 SaltStack 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.

Nota:

È 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:

  1. In SaltStack Config, selezionare Amministrazione > Plug-in Master.
  2. Selezionare un Salt Master con lo stato del plug-in Richiede l'aggiornamento.
  3. Fare clic su Aggiorna.
  4. Rivedere le informazioni nella finestra di dialogo per assicurarsi di aver selezionato il Salt Master corretto.
  5. Fare clic su Aggiorna.
  6. Per monitorare l'avanzamento dell'aggiornamento, fare clic su JID ultimo aggiornamento.
  7. 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.

Gli aggiornamenti del plug-in potrebbero non riuscire a causa di:
  • 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:

  1. Verificare il JID ultimo aggiornamento e rivedere i dati non elaborati per eventuali errori.
  2. Eseguire systemctl status salt-master per verificare lo stato del servizio salt-master.
  3. Eseguire salt-master -l debug per avviare il Salt Master in modalità di debug.
  4. Scaricare il plug-in Master dall'area di lavoro Plug-in Master e installare manualmente il plug-in.