SaltStack With Pillars gebruiken op Ubuntu 17.04

• Vereisten
• Master opzetten
• Formule
• Pijler
• Implementeren
• Bevestigend
• Gevolgtrekking

Hoewel SaltStack een geweldig hulpmiddel is om bewerkingen op veel servers tegelijkertijd uit te voeren, ondersteunt het ook door de host gedefinieerde configuratie-presets die zijn opgeslagen in een uniek bestand dat verder "pilaar" wordt genoemd. In deze gids zullen we een kleine SaltStack-formule schrijven voor het installeren van Nginx en het automatiseren van de implementatie van virtuele hosts met behulp van pijlers.

Vereisten

• Vultr-instantie met Ubuntu 17.04 (master)
• Twee Vultr-instanties met Ubuntu 17.04 (minions)

Master opzetten

Als je net begint en je SaltStack-master nog niet hebt ingesteld, lees dan dit artikel waarin wordt uitgelegd hoe je aan de slag kunt met SaltStack.

Formule

We beginnen met het maken van de map voor onze formule die verder de bestanden bevat die nodig zijn voor de bewerkingen van SaltStack op onze minions.

mkdir -p /srv/salt/nginx

Na het maken van de map kunnen we doorgaan met het schrijven van het init.slsbestand, wat een essentieel onderdeel is van elke 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

Zoals je waarschijnlijk hebt opgemerkt, gebruikt SaltStack de Jinja-templatie-engine voor het genereren van dynamische configuratiebestanden. Dit biedt een breed scala aan mogelijkheden binnen onze configuratiesjabloonbestanden, zoals toegang tot native Python-code of instellingsvariabelen en dergelijke. De volgende stap bestaat uit het maken van de sjabloon voor ons virtualhosts.confbestand, terwijl we eerst de map moeten maken:

mkdir -p /srv/salt/nginx/files

Zodra de map is gemaakt, kunnen we doorgaan met het schrijven van het virtualhosts.jinjabestand:

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

Pijler

Nadat we de formule hebben gemaakt, kunnen we doorgaan en onze pijlerbasis opzetten:

mkdir -p /srv/pillar/

Alle verwijzingen naar hosts die overeenkomen met een bepaald pijlerbestand worden in het top.slsbestand geschreven in de directory die we zojuist hebben gemaakt. In ons voorbeeld gaan we ervan uit dat er twee minions bestaan ​​met de hostnaam nginxwww1en nginxwww2terwijl we ze beide unieke pijlerbestanden zullen toewijzen:

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

Vervolgens gaan we door met het maken van een pijlerbestand voor, nginxwww1terwijl we een vhost maken die luistert op poort 81 voor het domein example.com, waarbij de documentroot /var/www/example_com/en de indexbestanden zijn index.shtml:

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

We zullen doorgaan met het maken van een pijlerbestand voor nginxwww2terwijl we een vhost zullen maken die luistert op poort 82 voor het domein example2.com, waarbij de documentroot /var/www/example2_com/en de indexbestanden zijn index.jsen index.css:

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

Opmerking: pijlerbestanden worden binnen opgeslagen/srv/pillar/

Implementeren

We kunnen nu onze eerste poging met pijlers voltooien door ze bij te werken op onze minions:

salt '*' saltutil.refresh_pillar

Daarna kunnen we de SaltStack-formule uitvoeren:

salt '*' state.sls nginx

Bevestigend

Zodra de SaltStack-formule zonder fouten is uitgevoerd en voltooid, zouden we het nginxluisteren op poort 81aan nginxwww1en poort 82op nginxwww2als bevestiging moeten kunnen zien .

Gevolgtrekking

Deze vrij lichte maar toch al krachtige SaltStack-formule kan verder worden uitgebreid om ondersteuning voor HTTPS toe te voegen, mogelijk met een integratie van Let's Encrypt, ondersteuning voor CGI- of PHP-backends en alles wat je ook handmatig kunt doen. Deze gids zou u een basisidee moeten hebben gegeven van SaltStack-formules en pijlers die worden gebruikt voor de implementatie van configuratiebestanden. Veel plezier met automatiseren!