Cómo instalar Saltstack Master y Minion en Debian 11

Introducción

SaltStack es un software de gestión de configuración y automatización gratuito, de código abierto y basado en Python. Es una herramienta de línea de comandos que lo ayuda a administrar su infraestructura desde una ubicación central. SoltStack se compone de cuatro componentes. A continuación se muestra una breve explicación de cada componente:

Salt Master actúa como un controlador de línea de comando para sus minions (esbirros). Se utiliza para controlar y gestionar un cierto número de minions.
Salt Minions son demonios esclavos que reciben configuraciones y comandos del maestro.
La fórmula es archivo de gestión de configuración.
La ejecución es una serie de comandos y módulos que se ejecutan en minions.

En este artículo, le mostraré cómo instalar los sistemas SaltStack Master y Minion en Debian 11.

Requisitos previos

Dos servidores que ejecutan Debian 11.
Una contraseña de root está configurada en el servidor.

Si desea instalar Saltstack en un servidor remoto, continúe leyendo; de lo contrario, omita el primer párrafo "Conexión al servidor" y lea el siguiente.

Conexión al servidor

Para acceder al servidor, necesita saber la dirección IP. También necesitará su nombre de usuario y contraseña para la autenticación. Para conectarse al servidor como root escriba el siguiente comando:

ssh root@IP_DEL_SERVER

A continuación, deberá ingresar la contraseña de usuario raíz.

Si no está usando el usuario raíz, puede iniciar sesión con otro nombre de usuario usando el mismo comando, luego cambie la raíz a su nombre de usuario :

ssh nome_utente@IP_DEL_SERVER

A continuación, se le pedirá que introduzca su contraseña de usuario.

El puerto estándar para conectarse a través de ssh es 22 , si su servidor usa un puerto diferente, deberá especificarlo usando el parámetro -p , luego escriba el siguiente comando:

ssh nome_utente@IP_DEL_SERVER -p PORTA

Instalar maestro saltstack

De forma predeterminada, SaltStack no está incluido en el repositorio predeterminado de Debian 11. Por lo tanto, deberá agregar el repositorio de SaltStack a APT. Puede agregarlo ejecutando el siguiente comando:

curl -fsSL -o /usr/share/keyrings/salt-archive-keyring.gpg https://repo.saltproject.io/py3/debian/11/amd64/latest/salt-archive-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/salt-archive-keyring.gpg arch=amd64] https://repo.saltproject.io/py3/debian/11/amd64/latest bullseye main" | tee /etc/apt/sources.list.d/salt.list

Una vez que se agrega el repositorio, actualice la memoria caché del repositorio con el siguiente comando:

apt-get update -y

Luego, instale las dependencias requeridas usando el siguiente comando:

apt-get install python3 salt-common -y

Luego, instale el maestro SaltStack con el siguiente comando:

apt-get install salt-master -y

Después de completar la instalación, puede continuar con el siguiente paso.

Configurar el maestro Saltstack

A continuación, deberá definir la interfaz de conexión en el archivo de configuración de SaltSTack:

nano /etc/salt/master

Edite la siguiente línea:

interface: 0.0.0.0

Guarde y cierre el archivo, luego reinicie el maestro SaltStack con el siguiente comando:

systemctl restart salt-master

Ahora puede verificar el estado de SaltStack con el siguiente comando:

systemctl status salt-master

Obtendrá el siguiente resultado:

? salt-master.service - The Salt Master Server
     Loaded: loaded (/lib/systemd/system/salt-master.service; enabled; vendor preset: enabled)
     Active: active (running) since Sat 2022-02-12 07:39:48 UTC; 9s ago
       Docs: man:salt-master(1)
             file:///usr/share/doc/salt/html/contents.html
             https://docs.saltproject.io/en/latest/contents.html
   Main PID: 19403 (salt-master)
      Tasks: 32 (limit: 2341)
     Memory: 201.5M
        CPU: 6.109s
     CGroup: /system.slice/salt-master.service
             ??19403 /usr/bin/python3 /usr/bin/salt-master
             ??19407 /usr/bin/python3 /usr/bin/salt-master
             ??19431 /usr/bin/python3 /usr/bin/salt-master
             ??19434 /usr/bin/python3 /usr/bin/salt-master
             ??19435 /usr/bin/python3 /usr/bin/salt-master
             ??19436 /usr/bin/python3 /usr/bin/salt-master
             ??19437 /usr/bin/python3 /usr/bin/salt-master
             ??19444 /usr/bin/python3 /usr/bin/salt-master
             ??19445 /usr/bin/python3 /usr/bin/salt-master
             ??19446 /usr/bin/python3 /usr/bin/salt-master
             ??19448 /usr/bin/python3 /usr/bin/salt-master
             ??19451 /usr/bin/python3 /usr/bin/salt-master
             ??19454 /usr/bin/python3 /usr/bin/salt-master

Feb 12 07:39:48 debian11 systemd[1]: Starting The Salt Master Server...
Feb 12 07:39:48 debian11 systemd[1]: Started The Salt Master Server.

Una vez hecho esto, puede continuar con el siguiente paso.

Instalar y configurar Saltstack Minion

SaltStack Master ahora está instalado y configurado. Ahora, inicie sesión en otra máquina y agregue el repositorio SaltStack Minion con el siguiente comando:

curl -fsSL -o /usr/share/keyrings/salt-archive-keyring.gpg https://repo.saltproject.io/py3/debian/11/amd64/latest/salt-archive-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/salt-archive-keyring.gpg arch=amd64] https://repo.saltproject.io/py3/debian/11/amd64/latest bullseye main" | tee /etc/apt/sources.list.d/salt.list

Una vez que se agrega el repositorio, actualice la memoria caché del repositorio con el siguiente comando:

apt-get update -y

Luego, instala SaltStack Minion con el siguiente comando:

apt-get install salt-minion -y

Una vez completada la instalación, edite el archivo de configuración de SaltStack Minion y defina la dirección IP principal:

nano /etc/salt/minion

Edite la siguiente línea:

master: salt-master-ip

Guarde y cierre el archivo cuando haya terminado.

A continuación, deberá autenticar a los minions utilizando la huella digital pública del maestro.

En la máquina Salt Master, enumere todas las huellas dactilares con el siguiente comando:

salt-key --finger-all

Obtendrá el siguiente resultado:

Local Keys:
master.pem:  b7:f0:ed:19:bf:e8:e0:9d:c3:9c:a2:09:2c:97:2f:6b:0f:cb:eb:76:3d:d7:d5:a9:7d:0c:3a:60:6e:9f:d7:78
master.pub:  5e:4f:2b:37:41:cc:4b:9c:b0:ed:cb:0a:fb:c7:59:54:5f:11:34:ab:d2:99:96:c1:e7:ef:4d:95:b0:7c:d3:d1

Ahora, copie la línea de la huella digital master.puby agréguela al archivo de configuración de Minion.

En la máquina Minion, edite el archivo de configuración:

nano /etc/salt/minion

Agregue la huella digital principal como se muestra a continuación:

master_finger:  '5e:4f:2b:37:41:cc:4b:9c:b0:ed:cb:0a:fb:c7:59:54:5f:11:34:ab:d2:99:96:c1:e7:ef:4d:95:b0:7c:d3:d1'

También necesitarás definir el nombre del Minion:

id: Minion1

Guarde y cierre el archivo, luego reinicie SaltStack Minion usando el siguiente comando:

systemctl restart salt-minion

También puede verificar el estado de SaltStack Minion con el siguiente comando:

systemctl status salt-minion

Obtendrá el siguiente resultado:

? salt-minion.service - The Salt Minion
     Loaded: loaded (/lib/systemd/system/salt-minion.service; enabled; vendor preset: enabled)
     Active: active (running) since Sat 2022-02-12 07:46:04 UTC; 7s ago
       Docs: man:salt-minion(1)
             file:///usr/share/doc/salt/html/contents.html
             https://docs.saltproject.io/en/latest/contents.html
   Main PID: 2324 (salt-minion)
      Tasks: 8 (limit: 2341)
     Memory: 59.9M
        CPU: 1.185s
     CGroup: /system.slice/salt-minion.service
             ??2324 /usr/bin/python3 /usr/bin/salt-minion
             ??2326 /usr/bin/python3 /usr/bin/salt-minion
             ??2328 /usr/bin/python3 /usr/bin/salt-minion

Feb 12 07:46:04 debian11 systemd[1]: Starting The Salt Minion...
Feb 12 07:46:04 debian11 systemd[1]: Started The Salt Minion.

También puede verificar la huella digital del minion usando el siguiente comando:

salt-call key.finger --local

Obtendrá el siguiente resultado:

local:
    14:12:ef:33:d2:1e:49:23:7b:a2:74:8d:19:fc:be:5e:6d:a6:57:ec:4f:a9:da:23:69:3f:62:1b:6b:4b:2f:27

En la máquina SaltStack Master, haga coincidir la huella digital con el siguiente comando:

salt-key --finger-all

Obtendrá el siguiente resultado:

Local Keys:
master.pem:  b7:f0:ed:19:bf:e8:e0:9d:c3:9c:a2:09:2c:97:2f:6b:0f:cb:eb:76:3d:d7:d5:a9:7d:0c:3a:60:6e:9f:d7:78
master.pub:  5e:4f:2b:37:41:cc:4b:9c:b0:ed:cb:0a:fb:c7:59:54:5f:11:34:ab:d2:99:96:c1:e7:ef:4d:95:b0:7c:d3:d1
Unaccepted Keys:
Minion1:  14:12:ef:33:d2:1e:49:23:7b:a2:74:8d:19:fc:be:5e:6d:a6:57:ec:4f:a9:da:23:69:3f:62:1b:6b:4b:2f:27

En SaltStack Master, acepta el Minion usando el siguiente comando:

salt-key -a Minion1

Obtendrá el siguiente resultado:

The following keys are going to be accepted:
Unaccepted Keys:
Minion1
Proceed? [n/Y] Y
Key for minion Minion1 accepted.

Ahora verifica la conexión entre Master y Minion usando el siguiente comando:

salt Minion1 test.ping

Obtendrá el siguiente resultado:

Minion1:
    True

Una vez hecho esto, puede continuar con el siguiente paso.

Controla a los Minions desde el Maestro

Después de la exitosa conexión entre Master y Minion. Comencemos a ejecutar algunos comandos en los Minions.

Ejecute el siguiente comando para enumerar el espacio en disco disponible en Minion:

salt '*' disk.usage

Obtendrá el siguiente resultado:

Minion1:
    ----------
    /:
        ----------
        1K-blocks:
            51538400
        available:
            47658628
        capacity:
            4%
        filesystem:
            /dev/sda1
        used:
            1661604
    /dev:
        ----------
        1K-blocks:
            998936
        available:
            998936
        capacity:
            0%
        filesystem:
            udev
        used:
            0
    /dev/shm:
        ----------
        1K-blocks:
            1015232
        available:
            1015152
        capacity:
            1%
        filesystem:
            tmpfs
        used:
            80

Para instalar el paquete de Apache en Minion, ejecute el siguiente comando:

salt Minion1 pkg.install apache2

Obtendrá el siguiente resultado:

Minion1:
    ----------
    apache2:
        ----------
        new:
            2.4.52-1~deb11u2
        old:
    apache2-bin:
        ----------
        new:
            2.4.52-1~deb11u2
        old:
    apache2-data:
        ----------
        new:
            2.4.52-1~deb11u2
        old:
    apache2-utils:
        ----------
        new:
            2.4.52-1~deb11u2
        old:
    libapr1:
        ----------
        new:
            1.7.0-6+deb11u1
        old:
    libaprutil1:
        ----------
        new:
            1.6.1-5
        old:
    libaprutil1-dbd-sqlite3:
        ----------
        new:
            1.6.1-5
        old:
    libaprutil1-ldap:
        ----------
        new:
            1.6.1-5
        old:

Para verificar la memoria libre en Minion, ejecute el siguiente comando:

salt '*' cmd.run 'free -m'

Obtendrá el siguiente resultado:

Minion1:
                   total        used        free      shared  buff/cache   available
    Mem:            1982         140        1392           2         450        1691
    Swap:              0           0           0

Use Salt State File para administrar Minions

Los archivos de estado también se conocen como archivos de administración de configuración que se utilizan para configurar y administrar Minions.

Para crear un archivo de estado, deberá crear la base de entorno para SaltStack.

mkdir /src/salt

Luego, crea un archivo de estado con el siguiente comando:

nano /src/salt/setup.sls

Agregue el siguiente código para instalar el paquete PHP, UNZIP y Apache en Minions:

network_utilities: 
 pkg.installed: 
   - pkgs: 
     - php 
     - unzip 

apache2_pkg: 
 pkg.installed: 
   - name: apache2 

apache2_service: 
 service.running: 
   - name: apache2 
   - enable: True 
   - require: 
     - pkg: apache2_pkg

Guarde y cierre el archivo, luego aplique la configuración a todos los Minions usando el siguiente comando:

salt '*' state.apply setup

Obtendrá el siguiente resultado:

Minion1:
----------
          ID: network_utilities
    Function: pkg.installed
      Result: True
     Comment: The following packages were installed/updated: php, unzip
     Started: 07:51:22.424504
    Duration: 17349.907 ms
     Changes:   
              ----------
              libapache2-mod-php7.4:
                  ----------
                  new:
                      7.4.25-1+deb11u1
                  old:
              php:
                  ----------
                  new:
                      2:7.4+76
                  old:
              php-common:
                  ----------
                  new:
                      2:76
                  old:
              php7.4:
                  ----------
                  new:
                      7.4.25-1+deb11u1
                  old:
              php7.4-cli:
                  ----------
                  new:
                      7.4.25-1+deb11u1
                  old:
              php7.4-common:
                  ----------
                  new:
                      7.4.25-1+deb11u1
                  old:
              php7.4-json:
                  ----------
                  new:
                      7.4.25-1+deb11u1
                  old:
              php7.4-opcache:
                  ----------
                  new:
                      7.4.25-1+deb11u1
                  old:
              php7.4-readline:
                  ----------
                  new:
                      7.4.25-1+deb11u1
                  old:
              psmisc:
                  ----------
                  new:
                      23.4-2
                  old:
              unzip:
                  ----------
                  new:
                      6.0-26
                  old:
----------
          ID: apache2_pkg
    Function: pkg.installed
        Name: apache2
      Result: True
     Comment: All specified packages are already installed
     Started: 07:51:39.780956
    Duration: 1029.457 ms
     Changes:   
----------
          ID: apache2_service
    Function: service.running
        Name: apache2
      Result: True
     Comment: The service apache2 is already running
     Started: 07:51:40.812210
    Duration: 35.61 ms
     Changes:   

Summary for Minion1
------------
Succeeded: 3 (changed=1)
Failed:    0
------------
Total states run:     3
Total run time:  18.415 s

Conclusión

¡Felicidades! ha instalado y configurado correctamente SaltStack Master y Minions en el servidor Debian 11. También explicamos cómo administrar Minions usando archivos de estado y la línea de comandos. Espero que esto lo ayude a automatizar y administrar su infraestructura desde la ubicación central.