Składnia YAML potrzebna w Ansible

Każdy playbook Ansible jest zapisany w formacie YAML, czyli zwykłym formacie tekstowym zaprojektowanym tak, aby ludzie mogli go łatwo czytać i tworzyć.

Plik YAML zwykle zaczyna się od trzech myślników. Ten zapis --- oznacza początek dokumentu, a Ansible oczekuje jego obecności.

YAML używa wcięć do przedstawiania struktury. Spacje oznaczają zagnieżdżenie, więc element wcięty pod danym wierszem należy do tego wiersza.

W YAML należy zawsze używać spacji do tworzenia wcięć. Dosłowny znak tabulacji jest nieprawidłowy, dlatego Ansible odmówi przetworzenia pliku.

Podstawą YAML jest mapowanie: klucz, dwukropek, spacja, a następnie wartość. W ten sposób ustawia się każdą opcję.

Ta pojedyncza spacja po dwukropku jest wymagana. Zapisanie name:value bez spacji dezorientuje parser, dlatego należy zachować odstęp.

Lista to zbiór elementów, z których każdy znajduje się w osobnym wierszu rozpoczynającym się od myślnika i spacji. Playbooki są w istocie tylko listami elementów play.

Zadania Ansible łączą oba te pojęcia: tworzą listę mapowań. Każdy myślnik rozpoczyna zadanie, a wcięte klucze je opisują.

Zwykłe wartości tekstowe zazwyczaj nie wymagają cudzysłowów. Cudzysłowów należy użyć tylko wtedy, gdy wartość zawiera dwukropki lub klamry albo zaczyna się od znaku specjalnego.

YAML odczytuje true, false i nieujęte w cudzysłowy cyfry jako wartości logiczne i liczbowe, a nie tekst. Dlatego yes i 22 są wartościami określonego typu, a nie łańcuchami znaków.

Wszystko, co znajduje się po znaku # w danym wierszu, jest komentarzem. Ansible go ignoruje, dlatego komentarze warto wykorzystywać do wyjaśniania działania poszczególnych zadań.

Należy utworzyć wcięcie zagnieżdżonego wiersza w playbooku. Czego należy użyć?

To cały niezbędny zestaw narzędzi: mapowania, listy i wcięcia tworzone za pomocą spacji. Opanowanie tych kilku zasad sprawi, że każdy playbook będzie czytelny. 🎉