Abilitazione del minion Salt tramite VMware Tools

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.
  • Supporta solo sistemi operativi a 64 bit.
  • Per Windows, è supportato Windows 8 e versioni successive.
    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)
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.
  • 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
    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
        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
        Se si installa dalla replica privata del percorso del repository standard per Salt, utilizzare
      • 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
        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