Použití SaltStack With Pillars na Ubuntu 17.04

Zatímco SaltStack je skvělý nástroj pro spouštění operací na mnoha serverech současně, podporuje také předvolby konfigurace definované pro jednotlivé hostitele uložené v jedinečném souboru, který se dále nazývá „pilíř“. V této příručce napíšeme malý vzorec SaltStack pro instalaci Nginx a automatizaci nasazení virtuálních hostitelů pomocí pilířů.

Požadavky

• Instance Vultr se systémem Ubuntu 17.04 (master)
• Dvě instance Vultr se systémem Ubuntu 17.04 (přisluhovači)

Nastavení hlavního

Pokud právě začínáte a ještě jste nenastavili svůj master SaltStack, podívejte se na tento článek, který vysvětluje, jak začít se SaltStack.

Vzorec

Začneme vytvořením složky pro náš vzorec, která dále obsahuje soubory potřebné pro operace SaltStacku s našimi přisluhovači.

mkdir -p /srv/salt/nginx

Po vytvoření složky můžeme pokračovat v psaní init.slssouboru, který je nezbytnou součástí každého vzorce:

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

Jak jste si pravděpodobně všimli, SaltStack používá šablonovací engine Jinja pro generování dynamických konfiguračních souborů. To poskytuje širokou škálu možností v rámci našich souborů konfiguračních šablon, jako je přístup k nativnímu kódu Pythonu nebo nastavení proměnných a podobně. Dalším krokem je vytvoření šablony pro náš virtualhosts.confsoubor, přičemž nejprve musíme vytvořit složku:

mkdir -p /srv/salt/nginx/files

Jakmile je složka vytvořena, můžeme pokračovat v zápisu virtualhosts.jinjasouboru:

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

Pilíř

Po vytvoření vzorce můžeme pokračovat a nastavit naši základnu Pilíře:

mkdir -p /srv/pillar/

Jakékoli odkazy na hostitele odpovídající konkrétnímu souboru pilíře jsou zapsány do top.slssouboru v adresáři, který jsme právě vytvořili. V našem příkladu předpokládáme, že existují dva minioni s názvem hostitele, nginxwww1a přitom nginxwww2jim oběma přiřadíme jedinečné soubory pilířů:

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

Dále budeme pokračovat vytvořením souboru pilíře pro, nginxwww1zatímco vytvoříme vhost naslouchající na portu 81 pro doménu example.com, kořen dokumentu /var/www/example_com/a soubory indexu jsou index.shtml:

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

Budeme pokračovat vytvářením pilířového souboru pro, nginxwww2zatímco vytvoříme vhost naslouchající na portu 82 pro doménu example2.com, kořen dokumentu /var/www/example2_com/a indexové soubory jsou index.jsa index.css:

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

Poznámka: Soubory Pillar jsou uloženy uvnitř/srv/pillar/

Nasazení

Nyní můžeme dokončit náš první pokus s pilíři jejich aktualizací na našich minionech:

salt '*' saltutil.refresh_pillar

Poté můžeme spustit vzorec SaltStack:

salt '*' state.sls nginx

Potvrzení

Jakmile je SaltStack vzorec byl běh a dokončena bez chyb, měli bychom být schopni vidět nginxnaslouchá na portu 81na nginxwww1i na portu 82na nginxwww2jako potvrzení.

Závěr

Tento poměrně lehký, ale již výkonný vzorec SaltStack lze dále rozšířit o podporu pro HTTPS, případně o integraci Let's Encrypt, podporu pro CGI nebo PHP backendy a vše, co můžete dělat také ručně. Tato příručka by vám měla poskytnout základní představu o vzorcích a pilířích SaltStack používaných pro nasazení konfiguračních souborů. Šťastnou automatizaci!