Projektant
Edycja formularzy, playbooków, inwentarzy i workflowów w przeglądarce
Dla autorów formularzy: sekcje projektanta i to, co pokazuje każda z ich kart.
Projektant wymaga opcji roli showDesigner. Edytuje jeden element naraz, formularz, playbook lub plik workflow, a jego sekcje są w lewym menu. Każdy rodzaj pliku wymaga też własnej opcji, wszystkie domyślnie włączone: allowPlaybookDesign dla Playbooki, allowWorkflowDesign dla Przepływy pracy, allowInventoryDesign dla Inwentarze i allowVarsFileDesign dla Pliki zmiennych. Bez niej sekcja jest tylko do odczytu, a serwer odmawia zapisywania, tworzenia, usuwania i wypychania jej plików; formularze i workflowy nadal mogą je wybierać. Formularze, Kategorie i Stałe w ten sam sposób wymagają allowFormDesign: bez niej są tylko do odczytu, a serwer odmawia ich zapisywania, pobierania (pull) i wypychania (push). Edytować może tylko jedna osoba naraz: zobacz Blokada projektanta. Rola może też ukryć formularze, playbooki i workflowy innych zespołów: zobacz Ograniczeni projektanci.
Sekcje
Każda sekcja edytuje jeden rodzaj pliku, przechowywany lokalnie lub w repozytorium:
| Sekcja | Co edytuje |
|---|---|
| Formularze | Pliki formularzy |
| Kategorie | Kategorie z config.yaml |
| Stałe | Stałe z config.yaml |
| Pliki zmiennych | Pliki zmiennych ładowane przez formularze |
| Playbooki | Playbooki uruchamiane przez formularze i workflowy |
| Inwentarze | Inwentarze: inventory.yaml, group_vars i host_vars |
| Przepływy pracy | Pliki workflow |
Sekcje z plikami wyświetlają je w eksploratorze plików i otwierają pierwszy z nich; sekcja, która nie ma jeszcze plików, informuje o tym. Sekcja Formularze i każda sekcja plików mają na początku paska narzędzi przycisk Nowy plik: w Inwentarzach tworzy on nowy inwentarz, w Przepływach pracy nowy, pusty workflow. Lupa eksploratora otwiera pole, które filtruje jego pliki po nazwie.
Pole wyszukiwania w wierszu tytułu znajduje tekst w otwartym YAML: zaznacza każde miejsce, w którym się pojawia. Działa na karcie YAML, gdy blokada projektanta należy do ciebie.
Karty
Każda sekcja ma te same trzy karty, wszystkie na tym samym YAML: zmiana w jednej jest widoczna w pozostałych, a Zapisz ją zapisuje.
- YAML to plik w takiej postaci, w jakiej jest zapisany.
- Wizualny edytuje go za pomocą pól. Zmieniają się tylko klucze, których dotyczy edycja, więc komentarze i reszta pozostają bez zmian.
- Podgląd pokazuje, co plik robi, i niczego nie edytuje.
Co pokazują karty Wizualny i Podgląd w poszczególnych sekcjach:
| Sekcja | Wizualny | Podgląd |
|---|---|---|
| Formularze | Ustawienia formularza i jego pola, z listami playbooków, inwentarzy i workflowów projektanta | Formularz w obecnej postaci, łącznie z niezapisanymi zmianami; jego wysłanie niczego nie uruchamia |
| Kategorie | Kategorie jako tabela, do edycji | Menu strony Formularze, zbudowane z nich |
| Stałe | Stałe jako konspekt, do edycji (klucz przesuwa się klawiszami strzałek) | Każda stała z odwołaniem do niej, $(NAME), do skopiowania, oraz formularze, które jej używają |
| Pliki zmiennych | Zmienne, do edycji | Każda zmienna z odwołaniem do niej w playbooku, {{ name }}, do skopiowania, oraz formularze, które ładują plik |
| Playbooki | Play: nazwa, hosty, Become, Zbieraj fakty i role każdego play oraz jego zadania, każde z modułem i argumentami | Konspekt playbooka: jego play z hostami, rolami i zadaniami oraz importowane przez niego playbooki |
| Inwentarze | Grupy, ich grupy podrzędne, ich hosty i zmienne ustawiane przez każde z nich | Inwentarz jako drzewo, z jego group_vars i host_vars |
| Przepływy pracy | Graf workflow, do edycji | Próbne uruchomienie: kliknij węzeł, aby zakończył się błędem |
Gdy YAML nie da się odczytać, karty Wizualny i Podgląd podają przyczynę, z przyciskiem Pokaż w YAML, który otwiera YAML w odpowiednim wierszu.
Ograniczeni projektanci
Od 7.5.0 trzy opcje roli ograniczają, które formularze, playbooki i workflowy pokazuje projektant, tak aby każdy zespół projektował własne. Wszystkie trzy są domyślnie włączone i zawsze włączone dla adminów:
| Opcja | Gdy jest wyłączona, projektant pokazuje tylko |
|---|---|
designAllForms (Edytować Wszystkie Formularze) | Formularze, których roles zawierają jedną z ról użytkownika, oraz podformularze, których nie używa żaden ukryty formularz |
designAllPlaybooks (Edytować Wszystkie Playbooki) | Playbooki uruchamiane przez formularze użytkownika oraz te, których nie używa jeszcze żaden formularz |
designAllWorkflows (Edytować Wszystkie Przepływy pracy) | Pliki workflow uruchamiane przez formularze użytkownika, łącznie z zagnieżdżonymi, oraz te, których nie używa jeszcze żaden formularz |
Formularz uruchamia playbook przez swój playbook, swoje kroki ansible i workflowy, które uruchamia. Czego ograniczony projektant nie może zrobić:
- Zobaczyć ukrytego pliku. Nigdy nie jest wyświetlany na liście ani wymieniany: otwarcie go odpowiada jak brakujący plik, a nowy plik o jego nazwie jak plik, który już istnieje.
- Wskazać na niego. Formularz, który wymienia ukryty formularz jako podformularz, nic z niego nie pokazuje, a formularz lub plik workflow, który wymienia ukryty playbook lub workflow, zostaje odrzucony.
- Zmienić wspólnego podformularza. Podformularz, którego używa też ukryty formularz, jest tylko do odczytu, a zapisany formularz musi zachować jedną z ról użytkownika.
- Ruszyć ukrytych formularzy pliku. Plik z kilkoma formularzami zachowuje przy zapisie ukryte bez zmian, a przywrócenie kopii zapasowej formularzy zostaje odrzucone.
- Dodać kodu, który uruchamia serwer. Zapisany formularz nie może zyskać wyrażenia ani zapytania uruchamianego przez serwer, a podgląd formularza jeszcze niezapisanego nie uruchamia żadnego własnego wyrażenia.
- Czytać nazw plików w wyjściu git. Wyjście pull lub push pomija wiersze, które wymieniają pliki.
allowFormDesign, allowPlaybookDesign i allowWorkflowDesign nadal decydują, czy pokazane pliki można zmieniać. Inwentarze, pliki zmiennych, kategorie i stałe pozostają widoczne dla każdego projektanta. Użytkownik z tylko częścią ustawień widzi tylko własne formularze i pliki workflow na kartach Formularze stron ustawień i na karcie Używane przez poświadczenia.