Utilisation de SaltStack avec des piliers sur Ubuntu 17.04

• Exigences
• Configuration du maître
• Formule
• Pilier
• Déployer
• Confirmation
• Conclusion

Bien que SaltStack soit un excellent outil pour exécuter simultanément des opérations sur de nombreux serveurs, il prend également en charge les préréglages de configuration définis par hôte stockés dans un fichier unique qui sont en outre appelés «pilier». Dans ce guide, nous allons écrire une petite formule SaltStack pour installer Nginx et automatiser le déploiement des hôtes virtuels à l'aide de piliers.

Exigences

• Instance Vultr exécutant Ubuntu 17.04 (maître)
• Deux instances Vultr exécutant Ubuntu 17.04 (serviteurs)

Configuration du maître

Si vous ne faites que commencer et que vous n'avez pas encore configuré votre maître SaltStack, consultez cet article qui explique comment démarrer avec SaltStack.

Formule

Nous commençons par créer le dossier de notre formule qui contient en outre les fichiers nécessaires aux opérations de SaltStack sur nos serviteurs.

mkdir -p /srv/salt/nginx

Après avoir créé le dossier, nous pouvons continuer à écrire le init.slsfichier qui est une partie essentielle de chaque formule:

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

Comme vous l'avez probablement remarqué, SaltStack utilise le moteur de modèle Jinja pour générer des fichiers de configuration dynamiques. Cela offre un large éventail de possibilités dans nos fichiers de modèle de configuration, comme l'accès au code Python natif ou la définition de variables et similaires. L'étape suivante consiste à créer le modèle de notre virtualhosts.conffichier, alors que nous devons d'abord créer le dossier:

mkdir -p /srv/salt/nginx/files

Une fois le dossier créé, nous pouvons continuer à écrire le virtualhosts.jinjafichier:

{% 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 %}

Pilier

Après avoir créé la formule, nous pouvons continuer et configurer notre base de piliers:

mkdir -p /srv/pillar/

Toutes les références pour les hôtes correspondant à un fichier de pilier particulier sont écrites dans le top.slsfichier dans le répertoire que nous venons de créer. Dans notre exemple, nous supposons que deux serviteurs existent avec le nom d'hôte nginxwww1et nginxwww2que nous leur assignerons les deux fichiers de pilier uniques:

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

Ensuite, nous continuerons de créer un fichier pilier pour nginxwww1alors que nous créerons un écoute vhost sur le port 81 pour le domaine example.com, la racine du document étant /var/www/example_com/et les fichiers d'index étant index.shtml:

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

Nous allons continuer à créer un fichier pilier pour nginxwww2alors que nous allons créer un écoute vhost sur le port 82 pour le domaine example2.com, la racine du document étant /var/www/example2_com/et les fichiers d'index étant index.jset index.css:

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

Remarque: les fichiers de pilier sont stockés dans/srv/pillar/

Déployer

Nous pouvons maintenant compléter notre premier essai avec des piliers en les mettant à jour sur nos serviteurs:

salt '*' saltutil.refresh_pillar

Ensuite, nous pouvons exécuter la formule SaltStack:

salt '*' state.sls nginx

Confirmation

Une fois que la formule de SaltStack a été exécuté et terminé sans erreur, nous devrions être en mesure de voir l' nginxécoute sur le port 81sur nginxwww1et sur le port 82sur nginxwww2la confirmation.

Conclusion

Cette formule SaltStack plutôt légère mais déjà puissante peut être étendue pour ajouter la prise en charge de HTTPS, éventuellement avec une intégration de Let's Encrypt, une prise en charge des backends CGI ou PHP et tout ce que vous pouvez également faire manuellement. Ce guide aurait dû vous donner une idée de base des formules et piliers SaltStack utilisés pour le déploiement des fichiers de configuration. Bonne automatisation!