Usando SaltStack con pilares en Ubuntu 17.04

• Requisitos
• Configurar maestro
• Fórmula
• Pilar
• Desplegando
• Confirmando
• Conclusión

Si bien SaltStack es una gran herramienta para ejecutar operaciones en muchos servidores simultáneamente, también admite ajustes preestablecidos de configuración definidos por host almacenados en un archivo único que se denomina "pilar". En esta guía, escribiremos una pequeña fórmula de SaltStack para instalar Nginx y automatizar la implementación de hosts virtuales mediante pilares.

Requisitos

• Vultr instancia ejecutando Ubuntu 17.04 (maestro)
• Dos instancias de Vultr que ejecutan Ubuntu 17.04 (minions)

Configurar maestro

Si recién está comenzando y aún no configuró su maestro SaltStack, consulte este artículo que explica cómo comenzar con SaltStack.

Fórmula

Comenzamos con la creación de la carpeta para nuestra fórmula que contiene los archivos necesarios para las operaciones de SaltStack en nuestros secuaces.

mkdir -p /srv/salt/nginx

Después de crear la carpeta, podemos continuar escribiendo el init.slsarchivo, que es una parte esencial de cada fórmula:

nginx:
  pkg:
    - installed

/etc/nginx/sites-enabled/virtualhosts.conf:
    file.managed:
        - source: salt://nginx/files/virtualhosts.jinja
        - template: jinja
        - user: root
        - group: root
        - mode: 655

  cmd:
    - run
    - names:
        - service nginx restart

Como probablemente haya notado, SaltStack utiliza el motor de plantillas Jinja para generar archivos de configuración dinámica. Esto proporciona una amplia gama de posibilidades dentro de nuestros archivos de plantilla de configuración, como acceder al código nativo de Python o establecer variables y similares. El siguiente paso consiste en crear la plantilla para nuestro virtualhosts.confarchivo, mientras que primero debemos crear la carpeta:

mkdir -p /srv/salt/nginx/files

Una vez que se crea la carpeta, podemos continuar escribiendo el virtualhosts.jinjaarchivo:

{% for vhost in pillar['vhosts'] %}
server {
    listen {{ vhost['listenPort'] }};
    server_name {{ vhost['serverName'] }};
    root {{ vhost['documentRoot'] }};
    index {%- for index in vhost['indexFiles'] -%}{{ index }}{%- endfor -%};
    location / {
        try_files $uri $uri/ =404;
    }
}
{% endfor %}

Pilar

Después de crear la fórmula, podemos continuar y configurar nuestra base de Pilar:

mkdir -p /srv/pillar/

Cualquier referencia para hosts que coincidan con un archivo de pilar en particular se escriben en el top.slsarchivo dentro del directorio que acabamos de crear. En nuestro ejemplo, asumimos que existen dos secuaces con el nombre de host nginxwww1y nginxwww2que les asignaremos ambos archivos de pilar únicos:

base:
  'id:nginxwww1':
    - match: grain
    - nginxwww1
  'id:nginxwww2':
    - match: grain
    - nginxwww2

A continuación, continuaremos creando un archivo pilar nginxwww1mientras que crearemos un vhost escuchando en el puerto 81 para el dominio example.com, siendo la raíz del documento /var/www/example_com/y los archivos de índice index.shtml:

vhosts:
    -
      listenPort: '81'
      serverName: 'example.com'
      documentRoot: '/var/www/example_com'
      indexFiles:
        - index.shtml

Continuaremos creando un archivo pilar nginxwww2mientras que crearemos un vhost escuchando en el puerto 82 para el dominio example2.com, siendo la raíz del documento /var/www/example2_com/y los archivos de índice index.jsy index.css:

vhosts:
    -
      listenPort: '82'
      serverName: 'example2.com'
      documentRoot: '/var/www/example2_com'
      indexFiles:
        - index.js
        - index.css

Nota: los archivos de pilares se almacenan en/srv/pillar/

Desplegando

Ahora podemos completar nuestro primer intento con pilares actualizándolos en nuestros secuaces:

salt '*' saltutil.refresh_pillar

Luego, podemos ejecutar la fórmula SaltStack:

salt '*' state.sls nginx

Confirmando

Una vez que la fórmula SaltStack se ha ejecutado y completado sin ningún error, debemos ser capaces de ver nginxla escucha en el puerto 81de nginxwww1y en el puerto 82en nginxwww2modo de confirmación.

Conclusión

Esta fórmula de SaltStack, bastante ligera pero potente, puede ampliarse aún más para agregar soporte para HTTPS, posiblemente con una integración de Let's Encrypt, soporte para backends CGI o PHP y todo lo que puede hacer manualmente también. Esta guía debería haberle dado una idea básica de las fórmulas y pilares de SaltStack utilizados para la implementación de archivos de configuración. ¡Feliz automatización!