Používanie SaltStack With Pillars na Ubuntu 17.04

Zatiaľ čo SaltStack je skvelý nástroj na spustenie operácií na mnohých serveroch súčasne, podporuje aj predvoľby konfigurácie definované pre jednotlivých hostiteľov uložené v jedinečnom súbore, ktorý sa ďalej nazýva „pilier“. V tejto príručke napíšeme malý vzorec SaltStack na inštaláciu Nginx a automatizáciu nasadenia virtuálnych hostiteľov pomocou pilierov.

Požiadavky

• Inštancia Vultr so systémom Ubuntu 17.04 (hlavná)
• Dve inštancie Vultr so systémom Ubuntu 17.04 (prisluhovači)

Nastavenie majstra

Ak ešte len začínate a ešte ste nenastavili svoj hlavný nástroj SaltStack, prečítajte si tento článok, ktorý vysvetľuje, ako začať so SaltStack.

Vzorec

Začneme vytvorením priečinka pre náš vzorec, ktorý ďalej obsahuje súbory potrebné na operácie SaltStacku na našich prisluhovačoch.

mkdir -p /srv/salt/nginx

Po vytvorení priečinka môžeme pokračovať v písaní init.slssúboru, ktorý je nevyhnutnou súčasťou každého vzorca:

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

Ako ste si pravdepodobne všimli, SaltStack používa šablónový engine Jinja na generovanie dynamických konfiguračných súborov. To poskytuje širokú škálu možností v rámci našich konfiguračných šablón šablón, ako je napríklad prístup k natívnemu kódu Pythonu alebo nastavenie premenných a podobne. Ďalší krok pozostáva z vytvorenia šablóny pre náš virtualhosts.confsúbor, pričom najprv musíme vytvoriť priečinok:

mkdir -p /srv/salt/nginx/files

Po vytvorení priečinka môžeme pokračovať v písaní virtualhosts.jinjasúboru:

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

Po vytvorení vzorca môžeme pokračovať a nastaviť základňu piliera:

mkdir -p /srv/pillar/

Akékoľvek odkazy na hostiteľov, ktorí sa zhodujú s konkrétnym súborom piliera, sa zapíšu do top.slssúboru v adresári, ktorý sme práve vytvorili. V našom príklade budeme predpokladať, že dvaja prisluhovači existuje s názvom hostiteľa nginxwww1, a nginxwww2vzhľadom k tomu, budeme priraďovať im oba súbory jedinečné piliere:

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

Ďalej budeme pokračovať vo vytváraní pilierového súboru pre, nginxwww1zatiaľ čo vytvoríme vhost počúvajúci na porte 81 pre doménu example.com, pričom koreň dokumentu je /var/www/example_com/a indexové súbory sú index.shtml:

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

Budeme pokračovať vo vytváraní pilierového súboru pre, nginxwww2zatiaľ čo vytvoríme vhost počúvajúci na porte 82 pre doménu example2.com, pričom koreň dokumentu je /var/www/example2_com/a indexové súbory sú index.jsa index.css:

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

Poznámka: Pilier súbory sú uložené v/srv/pillar/

Nasadzovanie

Teraz môžeme dokončiť náš prvý pokus s piliermi tak, že ich aktualizujeme na našich prisluhovačoch:

salt '*' saltutil.refresh_pillar

Potom môžeme spustiť vzorec SaltStack:

salt '*' state.sls nginx

Potvrdzuje sa

Akonáhle je SaltStack vzorec bol beh a dokončená bez chýb, mali by sme byť schopní vidieť nginxnačúva na porte 81na nginxwww1aj na porte 82na nginxwww2ako potvrdenie.

Záver

Tento pomerne ľahký, ale už výkonný vzorec SaltStack možno ďalej rozšíriť o podporu HTTPS, prípadne s integráciou Let's Encrypt, podporou pre CGI alebo PHP backendy a všetko, čo môžete robiť aj manuálne. Táto príručka by vám mala poskytnúť základnú predstavu o vzorcoch a pilieroch SaltStack používaných na nasadenie konfiguračných súborov. Šťastnú automatizáciu!