Używanie SaltStack z filarami na Ubuntu 17.04

• Wymagania
• Konfigurowanie mistrza
• Formuła
• Filar
• Wdrażanie
• Potwierdzenie
• Wniosek

Chociaż SaltStack jest doskonałym narzędziem do jednoczesnego uruchamiania operacji na wielu serwerach, obsługuje również predefiniowane ustawienia konfiguracyjne dla poszczególnych hostów przechowywane w unikalnym pliku, które są dalej nazywane „filarem”. W tym przewodniku napiszemy małą formułę SaltStack do instalowania Nginx i automatyzacji wdrażania wirtualnych hostów za pomocą filarów.

Wymagania

• Instancja Vultr z systemem Ubuntu 17.04 (master)
• Dwie instancje Vultr z systemem Ubuntu 17.04 (stwory)

Konfigurowanie mistrza

Jeśli dopiero zaczynasz i nie skonfigurowałeś jeszcze swojego mistrza SaltStack, zapoznaj się z tym artykułem, który wyjaśnia, jak zacząć korzystanie z SaltStack.

Formuła

Zaczynamy od utworzenia folderu dla naszej formuły, który dodatkowo przechowuje pliki wymagane do operacji SaltStack na naszych stworach.

mkdir -p /srv/salt/nginx

Po utworzeniu folderu możemy kontynuować zapisywanie init.slspliku, który jest niezbędną częścią każdej formuły:

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 zapewne zauważyłeś, SaltStack używa silnika szablonów Jinja do generowania dynamicznych plików konfiguracyjnych. Zapewnia to szeroki zakres możliwości w naszych plikach szablonów konfiguracji, takich jak dostęp do natywnego kodu Python lub ustawianie zmiennych i tym podobne. Kolejny krok polega na utworzeniu szablonu dla naszego virtualhosts.confpliku, ale najpierw musimy utworzyć folder:

mkdir -p /srv/salt/nginx/files

Po utworzeniu folderu możemy kontynuować zapisywanie virtualhosts.jinjapliku:

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

Filar

Po utworzeniu formuły możemy przystąpić do konfiguracji bazy Pillar:

mkdir -p /srv/pillar/

Wszelkie odniesienia do hostów pasujących do konkretnego pliku filaru są zapisywane w top.slspliku w właśnie utworzonym katalogu. W naszym przykładzie zakładamy, że istnieją dwa stwory z nazwą hosta nginxwww1i nginxwww2podczas gdy przypiszemy im oba unikalne pliki filarów:

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

Następnie będziemy kontynuować tworzenie pliku filaru, nginxwww1podczas gdy utworzymy vhost nasłuchujący na porcie 81 dla domeny example.com, przy czym katalog główny dokumentu /var/www/example_com/to index.shtml:

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

Będziemy kontynuować tworzenie pliku filaru dla, nginxwww2podczas gdy stworzymy vhost nasłuchujący na porcie 82 dla domeny example2.com, przy czym /var/www/example2_com/katalogiem głównym jest plik plików indeksu index.jsi index.css:

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

Uwaga: Pliki filarów są przechowywane w/srv/pillar/

Wdrażanie

Możemy teraz zakończyć naszą pierwszą próbę filarami, aktualizując je na naszych stworach:

salt '*' saltutil.refresh_pillar

Następnie możemy uruchomić formułę SaltStack:

salt '*' state.sls nginx

Potwierdzenie

Gdy formuła SaltStack był prowadzony i zakończony bez żadnych błędów, powinniśmy być w stanie zobaczyć nginxnasłuchuje na porcie 81na nginxwww1i na porcie 82na nginxwww2jako potwierdzenie.

Wniosek

Ta dość lekka, ale już potężna formuła SaltStack może zostać rozszerzona w celu dodania obsługi HTTPS, być może dzięki integracji Let's Encrypt, obsłudze backendów CGI lub PHP i wszystkiego, co możesz zrobić ręcznie. Ten przewodnik powinien dać ci podstawowe pojęcie o formułach i filarach SaltStack używanych do wdrażania plików konfiguracyjnych. Miłej automatyzacji!