Salt Project è un software open source basato su Python per l'automazione IT basata su eventi, l'esecuzione di attività remote e la gestione della configurazione.

Per ulteriori informazioni su Salt, vedere Guida utente di Salt.

Salt richiede la distribuzione di un minion Salt nel guest. Le variabili guest specifiche di Salt vengono impostate sul lato host per macchina virtuale e successivamente lette da VMware Tools nel guest. VMware Tools scarica quindi il bundle Salt e avvia un'istanza di minion Salt nel guest.

Prerequisiti

  • Supporta solo sistemi operativi a 64 bit.
  • Per Windows, è supportato Windows 8 e versioni successive.
    Nota: Windows 2008R2 non è supportato.
  • VMware Tools deve essere installato con la funzionalità del minion Salt. Questa funzionalità è abilitata per impostazione predefinita.
  • Sono presenti dipendenze nei pacchetti installati in Linux (come curl e wget)

Procedura

  • Configurazione lato host per macchina virtuale utilizzando le variabili guest
    L'amministratore host gestisce tutte le impostazioni delle variabili guest sul lato host per una determinata macchina virtuale utilizzando l'API della macchina virtuale o l'interfaccia utente di vSphere/VC.
      • Windows:

        La funzionalità di VMware Tools del minion Salt è installata per impostazione predefinita e può essere modificata in un'installazione personalizzata.

        Affinché VMware Tools crei un'istanza minion Salt su una particolare macchina virtuale e connetta il minion Salt con il master Salt, l'amministratore dell'host deve configurare e impostare la variabile guest per quella macchina virtuale.

        Nell'interfaccia utente dell'host di vSphere, selezionare una particolare macchina virtuale, fare clic con il pulsante destro del mouse e modificare le impostazioni. Nella scheda Opzioni macchina virtuale selezionare Avanzate > Modifica configurazione > Aggiungi/Elimina parametro e impostare

        • guestinfo./vmware.components.salt_minion.desiredstate su presente
        • guestinfo./vmware.components.salt_minion.args su <argomenti personalizzati sullo script di configurazione del minion Salt di VMware Tools>

        Ad esempio:

        guestinfo./vmware.components.salt_minion.desiredstate → presente

        guestinfo./vmware.components.salt_minion.args → master=1.2.3.4

      • Linux:
        L'amministratore dell'host deve installare open-vm-tools e open-vm-tools-salt-minion e quindi impostare la variabile guest per una determinata macchina virtuale come:
        • guestinfo./vmware.components.salt_minion.desiredstate su presente
        • guestinfo./vmware.components.salt_minion.args su <argomenti personalizzati sullo script di configurazione del minion Salt di VMware Tools>

        Ad esempio:

        guestinfo./vmware.components.salt_minion.desiredstate → presente

        guestinfo./vmware.components.salt_minion.args → master=1.2.3.4 id=12345

    • Rimozione del minion Salt

      In Windows o Linux, se l'amministratore dell'host imposta la variabile guest guestinfo./vmware.components.salt_minion.desiredstate su assente, allora VMware Tools rimuove l'istanza di minion Salt nella macchina virtuale guest.

      Ad esempio:

      guestinfo./vmware.components.salt_minion.desiredstate → assente

    • Controllo dello stato più recente del minion Salt nel guest

      Per controllare lo stato più recente del minion Salt nel guest nell'interfaccia utente di vSphere, utilizzare la variabile guest:

      guestinfo.vmware.components.salt_minion.laststatus

  • Configurazione lato guest utilizzando tools.conf

    Il file tools.conf contiene le configurazioni di VMware Tools in formato .ini. Questo strumento cerca la sezione salt_minion e utilizza le configurazioni definite in tale sezione. Questo file è archiviato all'indirizzo:

    Windows - C:\ProgramData\VMware\VMware Tools\tools.conf

    Linux - /etc/vmware-tools/tools.conf

    Di seguito è disponibile un esempio della sezione salt_minion come definito in tools.conf:

    [salt_minion]
master=1.2.3.4
conf_file=/etc/salt/minion
id=dev_minion
    Nota: Solo le opzioni di configurazione del minion sono disponibili in tools.conf. L'azione di script desiderata non può essere ottenuta da tools.conf.
    • Configurazione dell'intervallo per il monitoraggio della modifica dello stato nelle variabili guest:

      VMware Tools esegue periodicamente il sondaggio delle variabili guest per le modifiche dello stato. Il valore dell'intervallo di polling è 180s e può essere configurato nelle impostazioni tools.conf.

      [componentmgr]

      poll-interval=180 (valore predefinito: 180s)

    • Abilitazione e disabilitazione dei componenti (salt_minion):
      • L'amministratore guest può abilitare il salt_minion configurando le impostazioni tools.conf.

        [componentmgr]

        included=salt_minion

      • L'amministratore guest può abilitare tutti i componenti configurando le impostazioni tools.conf.

        [componentmgr]

        included=all (configurazione predefinita)

      • L'amministratore guest può disabilitare tutti i componenti configurando le impostazioni tools.conf.

        [componentmgr]

        included=none
  • Installazione del minion Salt utilizzando uno script di installazione
      • Ambiente Linux
        Nei sistemi Linux, lo script di installazione svtminion.sh è uno script bash con i seguenti prerequisiti:
        • - systemctl
        • - curl
        • - sha512sum
        • - vmtoolsd
        • - grep
        • - awk
        • - sed
        • - cut
        • - wget

        svtminion.sh --help mostra le opzioni della riga di comando.

        Utilizzo: 
        ./svtminion.sh [-c|--clear] [-d|--depend] [-h|--help] [-i|--install] 
 [-j|--source] [-l|--loglevel] [-m|--minionversion]
[-r|--remove] [-s|--status] [-v|--version]

        dove ./svtminion.sh [-j|--source] specifica la posizione da cui installare il minion Salt. Il valore predefinito è la posizione repo.saltproject.io.

        Ad esempio: Posizione URL

        http://my_web_server.com/my_salt_onedir

        https://my_web_server.com/my_salt_onedir

        file:////my_path/my_salt_onedir

        //my_path/my_salt_onedir

        Nota: Se è specificata una versione precisa del minion Salt, [-m|--minionversion], viene aggiunto all'origine. Il valore predefinito è la più recente.

        Di seguito è disponibile un esempio dell'installazione salt_minion come definito in tools.conf:

        [salt_minion]
master=1.2.3.4
conf_file=/etc/salt/minion
id=dev_minion
source=https://my_web_server.com/my_salt_onedir
        Nota: Se si installa dalla replica privata del percorso del repository standard per Salt, utilizzare source=https://repo.saltproject.io/salt/vmware-tools-onedir/
      • Ambiente Windows

        Nei sistemi Windows, lo script di installazione svtminion.ps1 è uno script powershell. L'unico prerequisito per Windows è il binario "vmtoolsd.exe", che viene utilizzato per eseguire query sui dati delle variabili guest.

        Per ottenere assistenza per questo script, eseguire il comando svtminion.ps1 -h o Get-Help svtminion.ps1.

        Lo script di VMware Tools per la gestione del minion Salt in un guest Windows è: 
        .\svtminion.ps1 [-Install] [-MinionVersion <String>] [-Source <String>] [[-ConfigOptions] <String[]>] [-LogLevel <String>] [-Help] [-Version] [<CommonParameters>]

        dove -Source <String> è l'URL o il percorso del repository contenente i programmi di installazione.

        Contiene una struttura di directory simile a quella trovata nella posizione predefinita: https://repo.saltproject.io/salt/vmware-tools-onedir/. In questo modo è possibile gestire i protocolli più comuni quali http, https, ftp, unc, local

        Ad esempio:

        PS>svtminion.ps1 -Install
        PS>svtminion.ps1 -Install -MinionVersion 3004-1 master=192.168.10.10 id=dev_box
        PS>svtminion.ps1 -Install -Source https://my.domain.com/vmtools/salt
        Nota:

        Per visualizzare gli esempi, digitare get-help .\svtminion.ps1 -examples

        Per maggiori informazioni, digitare get-help .\svtminion.ps1 -detailed

        Per informazioni tecniche, digitare get-help .\svtminion.ps1 -full

  • Recupero informazioni registro in corso
    L'amministratore guest può recuperare le informazioni del registro relative al minion Salt dal seguente percorso:
    Windows
    File di registro Posizione
    File di registro per il controllo dello stato del minion Salt C:\Windows\Temp\vmware-svtminion-status-{Timestamp}.log
    File di registro per l'installazione di un'istanza minion Salt nel guest C:\Windows\Temp\vmware-svtminion-install-{TimeStamp}.log
    File di registro per la rimozione di un'istanza minion Salt nel guest: C:\Windows\Temp\vmware-svtminion-remove-{TimeStamp}.log
    File di registro per il controllo delle informazioni di runtime dopo l'installazione o la rimozione di un'istanza minion Salt nel guest C:\salt\var\log\minion log files
    Linux
    File di registro Posizione
    File di registro per il controllo dello stato del minion Salt /var/log/vmware-svtminion.sh-status-{Timestamp}.log
    File di registro per l'installazione di un'istanza minion Salt nel guest /var/log/vmware-svtminion.sh-install-{TimeStamp}.log
    File di registro per la rimozione di un'istanza minion Salt nel guest: /var/log/vmware-svtminion.sh-remove-{TimeStamp}.log
    File di registro per il controllo delle informazioni di runtime dopo l'installazione o la rimozione di un'istanza minion Salt nel guest /var/log/salt/minion