Използване на SaltStack с стълбове в Ubuntu 17.04

Докато SaltStack е страхотен инструмент за изпълнение на операции на много сървъри едновременно, той също така поддържа дефинирани за всеки хост предварително зададени конфигурации, съхранявани в уникален файл, които по-нататък се наричат ​​"стълб". В това ръководство ще напишем малка формула на SaltStack за инсталиране на Nginx и автоматизиране на разполагането на виртуални хостове с помощта на стълбове.

Изисквания

• Vultr екземпляр, работещ с Ubuntu 17.04 (главен)
• Два екземпляра на Vultr, работещи с Ubuntu 17.04 (миньони)

Майстор за настройка

Ако тепърва започвате и все още не сте настроили своя главен файл SaltStack, вижте тази статия, която обяснява как да започнете със SaltStack.

Формула

Започваме със създаване на папката за нашата формула, която допълнително съхранява файловете, необходими за операциите на SaltStack върху нашите миньони.

mkdir -p /srv/salt/nginx

След като създадем папката, можем да продължим с писането на init.slsфайла, който е съществена част от всяка формула:

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

Както вероятно сте забелязали, SaltStack използва механизма за шаблони Jinja за генериране на динамични конфигурационни файлове. Това предоставя широк спектър от възможности в рамките на нашите конфигурационни шаблонни файлове, като достъп до собствен код на Python или променливи за настройка и други подобни. Следващата стъпка се състои в създаване на шаблона за нашия virtualhosts.confфайл, докато първо трябва да създадем папката:

mkdir -p /srv/salt/nginx/files

След като папката е създадена, можем да продължим с записването на virtualhosts.jinjaфайла:

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

Стълб

След като създадем формулата, можем да продължим и да настроим нашата база за стълб:

mkdir -p /srv/pillar/

Всички препратки за хостове, съответстващи на конкретен файл на стълб, се записват във top.slsфайла в директорията, която току-що създадохме. В нашия пример приемаме, че съществуват два миньона с името на хоста nginxwww1и nginxwww2като има предвид, че ще им присвоим и двата уникални файла за стълб:

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

След това ще продължим със създаването на стълбов файл за, nginxwww1докато ще създадем vhost, слушащ на порт 81 за домейна example.com, като коренът на документа е /var/www/example_com/и индексните файлове са index.shtml:

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

Ще продължим със създаването на стълбов файл за, nginxwww2докато ще създадем vhost, слушащ на порт 82 за домейна example2.com, като коренът на документа е /var/www/example2_com/и индексните файлове са index.jsи index.css:

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

Забележка: Pillar файловете се съхраняват вътре/srv/pillar/

Разгръщане

Вече можем да завършим първия си опит със стълбове, като ги актуализираме на нашите миньони:

salt '*' saltutil.refresh_pillar

След това можем да изпълним формулата SaltStack:

salt '*' state.sls nginx

Потвърждаване

След като формулата за SaltStack се управлява и да приключи без никакви грешки, трябва да сме в състояние да видите nginxслушане на порт 81на nginxwww1и на порт 82за nginxwww2потвърждение.

Заключение

Тази доста лека, но вече мощна формула на SaltStack може да бъде разширена допълнително, за да добави поддръжка за HTTPS, вероятно с интеграция на Let's Encrypt, поддръжка за CGI или PHP бекендове и всичко, което можете да правите ръчно. Това ръководство трябваше да ви даде основна представа за формулите и стълбовете на SaltStack, използвани за разполагане на конфигурационни файлове. Приятно автоматизиране!