Использование 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 %}

Столб

После создания формулы мы можем продолжить и настроить нашу базу Pillar:

mkdir -p /srv/pillar/

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

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

Далее мы продолжим создание файла pillar для, 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

Мы продолжим создавать файл pillar для, 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, используемых для развертывания файлов конфигурации. Удачной автоматизации!