Come parte del processo successivo all'installazione, è necessario installare, configurare e aggiornare il plug-in Master. Il plug-in Master consente ai Salt Master di comunicare con SaltStack Config. Il plug-in Master include una serie di impostazioni che è possibile modificare per migliorare le prestazioni, specialmente negli ambienti di grandi dimensioni oppure occupati.

Il plug-in Master viene in genere installato in ogni Salt Master nell'ambiente che comunica con SaltStack Config. Ad esempio, se si utilizza una configurazione con più Salt Master (a volte denominata "configurazione con più Master"), è necessario installare il plug-in Master in ciascun Salt Master.

Nota: Nell'ambito dell'iniziativa di VMware volta a rimuovere la terminologia problematica, il termine Salt Master verrà sostituito con un termine più adatto in SaltStack Config, nonché nei prodotti e nella documentazione correlati. Per il completamento di questo aggiornamento della terminologia possono essere necessari alcuni cicli di rilascio.

Quando è necessario installare il plug-in Master?

È necessario installare il plug-in Master in tutti i Salt Master prima di connetterli a SaltStack Config Cloud. Il plug-in Master non è necessario nei Salt Master che non devono comunicare con SaltStack Config.

Se sono già presenti Salt Master, è necessario aggiornare il plug-in Master. Per istruzioni complete sull'aggiornamento e l'installazione del plug-in Master, vedere Come aggiornare il plug-in Master.

Installazione del plug-in Master

Per installare il plug-in Master nel proprio Salt Master:

  1. Accedere al Salt Master.
  2. Se necessario, scaricare il file wheel del plug-in Master da Customer Connect.

    Il plug-in Master è incluso nel file .tar.gz del programma di installazione automatizzato. Dopo aver scaricato ed estratto il file .tar.gz, è possibile trovare il plug-in Master nella directory sse-installer/salt/sse/eapi_plugin/files.

  3. Installare il plug-in Master installando manualmente il file wheel di Python aggiornato. Utilizzare i seguenti comandi di esempio, specificando il nome esatto del file wheel:

    RHEL/CentOS

    sudo pip3 install SSEAPE-file-name.whl --prefix /usr

    Ubuntu

    sudo pip3 install SSEAPE-file-name.whl
    Nota: È possibile che alcuni utenti debbano utilizzare la sintassi pip3.6 o pip36 per i loro sistemi operativi.

Configurazione del plug-in Master

Per configurare il Salt Master dopo l'installazione del plug-in Master:

  1. Accedere al Salt Master e verificare che la directory /etc/salt/master.d esista. In caso contrario, crearla.
  2. Generare le impostazioni di configurazione del Master.
    Nota: Se si desidera conservare le impostazioni di configurazione, creare un backup del file di configurazione del plug-in Master esistente prima di eseguire questo passaggio. Copiare quindi le impostazioni pertinenti dalla configurazione esistente nel file appena generato.
    sudo sseapi-config --all > /etc/salt/master.d/raas.conf

    Se l'esecuzione di questo comando causa un errore, è possibile che sia dovuto al metodo usato durante l'installazione iniziale di Salt. Se Salt è stato installato tramite il programma di installazione di SaltStack Config, è probabile che l'installazione includa un pacchetto offline, denominato Salt Crystal, che richiede istruzioni di aggiornamento speciali. Per ulteriori informazioni, vedere la pagina Risoluzione dei problemi.

  3. Modificare il file raas.conf generato e aggiornare i valori come segue per convalidare il certificato utilizzato dall'API (RaaS) e impostare il relativo indirizzo IP.
    Valore Descrizione

    sseapi_ssl_validate_cert

    Convalida il certificato utilizzato dall'API (RaaS). Il valore predefinito è True.

    Se si utilizzano certificati emessi dall'autorità di certificazione, impostare questo valore su True e configurare le impostazioni sseapi_ssl_ca, sseapi_ssl_cert e sseapi_ssl_cert:.

    In caso contrario, impostarlo su False per non convalidare il certificato.

    sseapi_ssl_validate_cert:False

    sseapi_server

    Indirizzo IP HTTP del nodo RaaS, ad esempio http://example.com o https://example.com se SSL è abilitato.

    sseapi_command_age_limit

    Imposta il periodo di tempo (in secondi) dopo il quale i processi precedenti e potenzialmente obsoleti vengono ignorati. Ad esempio, per ignorare i processi che risalgono a un giorno prima, impostarla su:

    sseapi_command_age_limit:86400

    I processi ignorati continueranno ad esistere nel database e verranno visualizzati con lo stato Completed nell'interfaccia utente di SaltStack Config.

    In alcuni ambienti che richiedono che il Salt Master rimanga offline per lunghi periodi di tempo è necessario che il Salt Master esegua tutti i processi accodati quando torna online. Se questa condizione si applica al proprio ambiente, impostare il limite di età su 0.

    sseapi_windows_minion_deploy_delay Imposta un ritardo per consentire l'attivazione di tutti i servizi Windows necessari. Il valore predefinito è 180 secondi.
    sseapi_linux_minion_deploy_delay Imposta un ritardo per consentire l'attivazione di tutti i servizi Linux necessari. Il valore predefinito è 90 secondi.
  4. FACOLTATIVO: aggiornare le impostazioni relative alle prestazioni. Per gli ambienti di grandi dimensioni oppure occupati, è possibile migliorare le prestazioni delle comunicazioni tra il Salt Master e SaltStack Config modificando le seguenti impostazioni.
    • Abilitare l'accodamento degli eventi (disponibile in Salt 2019.2.2 e versioni successive). Gli eventi possono essere accodati nel Salt Master e inviati al returner di eventi in batch utilizzando una singola transazione per più eventi. Per impostazione predefinita, questo meccanismo di accodamento è disabilitato. Per abilitare l'accodamento degli eventi, impostare quanto segue nel file di configurazione del plug-in Salt Master:
      event_return_queue:2500
      event_return_queue_max_seconds:5

      Il numero massimo suggerito di eventi in coda è 2500, come illustrato. Quando è piena, la coda viene svuotata e gli eventi vengono inoltrati al returner di eventi. Un valore inferiore potrebbe essere più adatto per gli ambienti più piccoli o meno occupati.

      In alcuni casi, il bus degli eventi di Salt potrebbe non essere sufficientemente occupato da causare il regolare raggiungimento delle dimensioni massime della coda. Se si imposta event_return_queue_max_seconds, la coda verrà svuotata quando l'evento meno recente nella coda è precedente al valore configurato, indipendentemente dal numero di eventi presenti nella coda.

    • Abilitare e configurare i motori eventqueue e rpcqueue:

      Questi motori effettuano l'offload di alcune comunicazioni con SaltStack Config dai percorsi di codice critici per le prestazioni ai processi dedicati. Mentre i motori sono in attesa di comunicare con SaltStack Config, i payload vengono archiviati nel file system locale del Salt Master in modo che i dati possano persistere a ogni riavvio del Salt Master.

      Per abilitare i motori, rimuovere il commento dalle seguenti impostazioni nel file di configurazione del plug-in Salt Master (raas.conf):

      engines:
        - sseapi: {}
        - eventqueue: {}
        - rpcqueue: {}
        - jobcompletion: {}
        - keyauth: {}

      Per configurare il motore eventqueue, rimuovere il commento e aggiornare le impostazioni seguenti:

      sseapi_event_queue:
        name: sseapi-events
        strategy: always
        push_interval: 5
        batch_limit: 2000
        age_limit: 86400
        size_limit: 35000000
        vacuum_interval: 86400
        vacuum_limit: 350000
        forward: []

      I parametri della coda possono essere modificati in base al modo in cui collaborano. Ad esempio, supponendo una media di 400 eventi al secondo nel bus degli eventi di Salt, le impostazioni visualizzate in precedenza consentono di raccogliere circa 24 ore di traffico degli eventi in coda nel Salt Master prima che gli eventi meno recenti vengono eliminati a causa dei limiti di dimensione o di età.

      Per configurare il motore rpcqueue, rimuovere il commento e aggiornare le impostazioni seguenti:

      sseapi_rpc_queue:
          name: sseapi-rpc
          strategy: always
          push_interval: 5
          batch_limit: 500
          age_limit: 3600
          size_limit: 360000
          vacuum_interval: 86400
          vacuum_limit: 100000
    • Abilitare la memorizzazione nella cache del carico:
      sseapi_local_cache:
          load:3600
      Nota: Se il motore rpcqueue è abilitato, deve essere abilitata anche la memorizzazione nella cache del carico per consentire al Salt Master di gestire correttamente i processi.
    • Limitare le dimensioni del payload dei grani dei minion:
      sseapi_max_minion_grains_payload:2000
    • Abilitare la funzionalità che consente di ignorare i processi che risalgono a prima di un periodo definito (in secondi). Ad esempio, utilizzare 86400 per impostarla in modo che ignori i processi che hanno più di un giorno. Quando è impostata su 0, questa funzionalità è disabilitata:
      sseapi_command_age_limit:0
      Nota:

      Questa funzionalità è utile durante l'aggiornamento per evitare l'esecuzione imprevista dei comandi precedenti archiviati nel database.

    Insieme, l'accodamento degli eventi in Salt e i motori di accodamento, la memorizzazione nella cache del carico, il limite delle dimensioni del payload dei grani e il limite di età dei comandi nel plug-in Salt Master aumentano la velocità effettiva e riducono la latenza delle comunicazioni tra il Salt Master e SaltStack Config nei percorsi di codice più sensibili alle prestazioni.

  5. Riavviare il servizio Master.
    sudo systemctl restart salt-master
  6. FACOLTATIVO: potrebbe essere necessario eseguire un processo di test per assicurarsi che a questo punto il plug-in Master consenta la comunicazione tra il Master e il nodo RaaS.
    salt -v '*' test.ping

Anche se non viene visualizzata alcuna attività, come se non fosse connesso alcun minion, è probabile che questo indichi una configurazione corretta.

Riferimenti delle impostazioni di configurazione

Queste impostazioni nel file di configurazione consentono a ogni Salt Master di connettersi all'API (RaaS). Queste impostazioni sono disponibili nel file di configurazione /etc/salt/master.d/raas.conf.

Importante:

Le impostazioni del Salt Master nel file raas.conf hanno la precedenza sulle impostazioni esistenti in /etc/salt/master. Se le impostazioni di fileserver_backend o ext_pillar sono state personalizzate in /etc/salt/master, è necessario unirle manualmente in modo che siano presenti in un solo file. Facoltativamente, è possibile riordinare i back-end per modificare la precedenza.

La seguente tabella illustra le impostazioni di configurazione generali:

Opzione Descrizione
id ID Salt Master, generato automaticamente se non viene impostato
sseapi_server URL del server SSEAPI, ad esempio https://sse.example.com:443
engines motori Salt da abilitare, sseapi, eventqueue, rpcqueue, jobcompletion e keyauth consigliati.
master_job_cache sseapi per utilizzare la cache dei processi Master di SaltStack Config
event_return returner eventi di Salt, sseapi consigliato per utilizzare il returner di eventi di SaltStack Config
ext_pillar origini dei pillar esterni, sseapi consigliato
fileserver_backend back-end dei file server, sseapi e roots consigliati
sseapi_update_interval frequenza di aggiornamento dal file server (secondi, valore predefinito 60)
sseapi_poll_interval frequenza di polling di SaltStack Config per i nuovi dati (secondi, valore predefinito 30)
sseapi_jce_poll_interval aggiunge un ritardo tra le iterazioni nel motore jobcompletion in modo che vengano inviati al massimo 5760 comandi find_job al giorno per Salt Master (secondi, predefinito 15)
sseapi_timeout timeout per le chiamate API (RaaS) (secondi, valore predefinito 200)
sseapi_pubkey_path percorso del file della chiave pubblica per l'autenticazione del Salt Master di SaltStack Config
sseapi_key_rotation intervallo di rotazione della chiave di autenticazione di SaltStack Config del Salt Master (secondi, valore predefinito 86400)
sseapi_cache_pillar indica se memorizzare nella cache i dati dei pillar in SaltStack Config (True o False, valore predefinito False)
sseapi_cluster_id (facoltativo) nome del cluster di Salt Master, per raggruppare i Salt Master in cluster in SaltStack Config
sseapi_failover_master indica se questo Salt Master è un Salt Master di failover (True o False, valore predefinito False)
sseapi_command_age_limit indica se ignorare i comandi dell'API (RaaS) precedenti a un periodo definito (secondi, 0 per disabilitare l'opzione, valore predefinito 0)

La seguente tabella spiega le impostazioni di SSL:

Opzione Descrizione
sseapi_ssl_key percorso della chiave privata del certificato
sseapi_ssl_cert percorso del certificato
sseapi_ssl_validate_cert indica se convalidare il certificato SSL di SaltStack Config (True o False, valore predefinito True)

La seguente tabella spiega le impostazioni del motore della coda degli eventi, disponibili sotto l'intestazione sseapi_event_queue:

Opzione Descrizione
name Nome della coda degli eventi (valore predefinito sseapi-events, non è necessario modificarlo)
strategy Indica quando accodare gli eventi (always, on_failure o never, valore predefinito never)
push_interval Frequenza di push degli eventi in SaltStack Config (secondi, valore predefinito 5)
batch_limit Numero massimo di eventi di cui eseguire il push in SaltStack Config per intervallo (valore predefinito 2000)
age_limit Età massima degli eventi in coda; rilascia gli eventi meno recenti (secondi, valore predefinito 86400)
size_limit Dimensioni massime della coda; rilascia gli eventi meno recenti (eventi, valore predefinito 35000000)
vacuum_interval Frequenza di svuotamento del database della coda (secondi, valore predefinito 86400)
vacuum_limit Dimensioni massime della coda quando il database della coda viene svuotato (eventi, valore predefinito 350000)
forward Returner Salt aggiuntivi a cui inviare gli eventi durante lo svuotamento della coda (valore predefinito none)

La voce della configurazione forward può specificare un elenco di uno o più nomi di returner Salt. Ogni volta che la coda degli eventi viene svuotata, gli eventi in coda verranno inviati a SaltStack Config e a tutti i returner nell'elenco. Ciò consente di aggiungere le funzionalità di accodamento e persistenza del motore della coda degli eventi a qualsiasi returner Salt standard. Di seguito è disponibile un esempio di configurazione che causa la scrittura degli eventi in un file locale ogni volta che vengono inviati a SaltStack Config:

sseapi_event_queue:
  # ...other queue settings...
  forward:
    - rawfile_json

# rawfile_json returner configuration
rawfile_json.filename: /var/log/salt/events.json

La seguente tabella spiega le impostazioni del motore della coda RPC, disponibili sotto l'intestazione sseapi_rpc_queue:

Opzione Descrizione
name Nome della coda degli eventi (valore predefinito sseapi-rpc, non è necessario modificarlo)
strategy Indica quando accodare gli eventi (always, on_failure o never, valore predefinito never)
push_interval Frequenza di invio delle chiamate a SaltStack Config (secondi, valore predefinito 5)
batch_limit Numero massimo di chiamate di cui eseguire il push in SaltStack Config per intervallo (valore predefinito 500)
age_limit Età massima delle chiamate in coda; rilascia le voci meno recenti (secondi, valore predefinito 3600)
size_limit Dimensioni massime della coda; rilascia le voci meno recenti (eventi, valore predefinito 360000)
vacuum_interval Frequenza di svuotamento del database della coda (secondi, valore predefinito 86400)
vacuum_limit Dimensioni massime della coda quando il database della coda viene svuotato (voci, valore predefinito 100000)

La seguente tabella spiega le impostazioni del percorso. Dopo la generazione della configurazione iniziale, prestare attenzione a modificare tali impostazioni. I moduli verranno copiati in queste directory dal processo di installazione. Tuttavia, l'aggiunta di percorsi aggiuntivi non avrà effetti negativi.

Opzione Descrizione
beacons_dirs percorso/i dei moduli esterni dei beacon
engines_dirs percorso/i dei moduli esterni dei motori
fileserver_dirs percorso/i dei moduli esterni del file server
pillar_dirs percorso/i dei moduli esterni del pillar
returner_dirs percorso/i dei moduli esterni del returner
roster_dirs percorso/i dei moduli esterni del roster
runner_dirs percorso/i dei moduli esterni del runner
module_dirs percorso/i dei moduli esterni del Salt
proxy_dirs percorso/i dei moduli esterni del proxy
metaproxy_dirs percorso/i dei moduli esterni del metaproxy
states_dirs percorso/i dei moduli esterni degli stati

Passaggi successivi

Dopo aver installato e configurato il plug-in Master, è possibile richiedere l'accesso al servizio SaltStack Config Cloud in VMware Cloud Services Platform (CSP).