Automatyzacja administracji
Zakres zastosowań Ansible i układ repozytorium, skrypty PowerShell uruchamiane z Harmonogramu zadań oraz realizacja zgłoszeń przez AWX lub Ansible Automation Platform.
Automatyzacja administracji zawodzi najczęściej nie przez brak narzędzi, lecz przez brak granic i obudowy: playbook przejmuje zadania, do których Ansible nie służy, skrypt bez logu i kodu wyjścia pokazuje w harmonogramie sukces mimo błędu, a powtarzalne wnioski czekają dni na ręczną obsługę. Dokument opisuje trzy powiązane elementy: zakres zastosowań Ansible i układ repozytorium, budowę skryptu PowerShell uruchamianego bez nadzoru oraz przepływ od zgłoszenia w systemie ITSM do wykonanego zadania w AWX lub Ansible Automation Platform.
Zakres zastosowań Ansible
Ansible łączy się z maszyną przez SSH, a z hostami Windows przez WinRM lub PSRP, wykonuje listę zadań i kończy pracę. Z tego modelu wynika podział zastosowań.
| Zadanie | Ansible | Lepsze narzędzie lub uwaga |
|---|---|---|
| Pakiety, pliki konfiguracyjne, usługi, konta, reguły zapory | Tak | Rdzeń zastosowań; moduły są idempotentne |
| Zadania operacyjne na wielu maszynach: rotacja certyfikatów, aktualizacje w ustalonej kolejności | Tak | serial ogranicza wielkość partii, order ustala kolejność, --limit zasięg |
| Integracje przez API: rejestr obrazów, system zgłoszeń, platforma CI | Tak | Moduł ansible.builtin.uri albo dedykowana kolekcja |
| Windows Server tam, gdzie GPO nie sięga | Tak | WinRM lub PSRP i kolekcja ansible.windows; ustawienia stacji zostają w GPO |
| Utrzymywanie stanu w czasie i korekta dryfu | Nie | Kontroler, który stale uzgadnia stan |
| Codzienne zarządzanie zasobami Kubernetes | Nie | Manifesty w Git i kontroler GitOps |
| Tworzenie maszyn, sieci i wolumenów | Zwykle nie | Ansible ma do tego moduły, ale Terraform lub OpenTofu daje plan zmian i stan |
| Złożona logika i transformacje danych | Nie | Skrypt w Pythonie wywołany jako jedno zadanie |
Ansible może przygotować klaster albo zainstalować w nim kontroler GitOps, ale nie prowadzi go na co dzień: moduł kubernetes.core.k8s stosuje stan idempotentnie, lecz nie uzgadnia go w sposób ciągły i nie zostawia historii zmian w repozytorium. Playbook z pętlami w pętlach, warunkami zależnymi od wyników poprzednich zadań i filtrami Jinja2 na kilka linii jest programem napisanym w niewłaściwym języku, którego nie da się ani czytać, ani testować. Taką logikę przenosi się do skryptu w Pythonie z własnymi testami, a playbook wywołuje go jako jedno zadanie i sprawdza wynik.
Układ repozytorium i role
Struktura katalogów jest pierwszą dokumentacją, dlatego układ jest stały dla każdego projektu.
| Ścieżka | Zawartość |
|---|---|
ansible.cfg | domyślne inventory i roles_path |
requirements.txt | przypięte wersje ansible-core i ansible-lint |
collections/requirements.yml | kolekcje z przypiętymi wersjami |
inventories/prod/, inventories/test/ | hosts.yml z maszynami i grupami oraz group_vars/ |
inventories/<środowisko>/group_vars/all/vars.yml | zmienne wspólne |
inventories/<środowisko>/group_vars/all/vault.yml | sekrety, zaszyfrowane |
inventories/<środowisko>/group_vars/<grupa>.yml | różnice dla grupy, np. web.yml |
playbooks/ | cienkie playbooki: grupa docelowa i lista ról, np. web.yml |
roles/<rola>/ | defaults/main.yml, tasks/main.yml, handlers/main.yml, templates/, README.md |
README.md | sposób uruchomienia i miejsce sekretów |
Playbook nie zawiera zadań, tylko grupę docelową (hosts: web) i listę ról; logika żyje w rolach. W ansible.cfg domyślne inventory wskazuje środowisko testowe (inventory = inventories/test/hosts.yml), a roles_path = roles katalog ról. Testowe inventory jako domyślne jest tanim bezpiecznikiem: polecenie uruchomione bez -i trafia w maszyny testowe, a produkcja wymaga świadomego -i inventories/prod/hosts.yml. Wpis roles_path jest potrzebny, bo playbooki leżą w podkatalogu, a bez niego Ansible szuka ról w katalogu roles/ obok pliku playbooka i w ścieżkach domyślnych.
Rola instaluje i konfiguruje jedną rzecz: serwer WWW, agenta monitoringu, synchronizację czasu. Rola „serwer aplikacyjny”, która robi dwadzieścia rzeczy, nie nadaje się do ponownego użycia ani do testowania. Każda zmienna roli ma wartość domyślną i komentarz w defaults/main.yml (np. nginx_worker_processes: auto); to kontrakt roli, bo użycie jej wymaga przeczytania jednego pliku. Zadania roli instalują pakiet, wgrywają szablon i uruchamiają usługę, a handler przeładowuje ją tylko wtedy, gdy szablon faktycznie się zmienił. Pełne nazwy modułów (ansible.builtin.template zamiast template) usuwają wątpliwość, z której kolekcji pochodzi moduł.
Zmienne roli zaczynają się od jej nazwy: nginx_worker_processes, a nie worker_processes. Bez prefiksu dwie role prędzej czy później użyją tej samej nazwy do różnych celów i wygra wartość o wyższym pierwszeństwie; konwencję pilnuje reguła ansible-lint var-naming[no-role-prefix].
Zmienne, sekrety i idempotentność
Ansible ma 22 poziomy pierwszeństwa zmiennych, więc w praktyce wystarczą trzy miejsca: defaults/main.yml w roli oraz group_vars/ i host_vars/ w inventory. Hasła i klucze nie leżą w repozytorium jawnym tekstem: podstawą jest Ansible Vault (zaszyfrowany group_vars/all/vault.yml ze zmiennymi z prefiksem vault_), a gdy te same sekrety są potrzebne w kilku narzędziach, zewnętrzny menedżer sekretów.
Playbook uruchomiony dwa razy z rzędu ma za drugim razem zgłosić zero zmian, a każde changed w drugim przebiegu jest zadaniem do poprawki. Moduły package, template czy service zapewniają to same. Problem tworzą command i shell, które dla Ansible zawsze oznaczają zmianę:
createsz ścieżką pliku-znacznika pomija zadanie, gdy plik już istnieje (inicjalizacja katalogu danych aplikacji),changed_when: falserazem zcheck_mode: falseoznacza zadanie wyłącznie odczytujące, które wykonuje się także w trybie--check(odczyt stanu migracji schematu),whenna zarejestrowanym wyniku (register) uruchamia zadanie zmieniające tylko wtedy, gdy odczyt wykazał potrzebę, np. oczekujące migracje.
--check --diff symuluje przebieg bez zmian i pokazuje, co zmieniłoby się w plikach, najlepiej z --limit do jednego serwera. Moduły bez obsługi trybu próbnego nic nie raportują, więc jest to przewidywanie, a nie gwarancja. ansible-inventory --host <host> wypisuje zmienne z group_vars i host_vars po scaleniu, czyli odpowiada na pytanie, która wartość wygrała.
Minimum, które da się utrzymać bez osobnego środowiska testowego: przy każdej zmianie w repozytorium uruchamiają się ansible-playbook --syntax-check oraz ansible-lint, z wersjami przypiętymi w requirements.txt. W GitLab CI jest to jedno zadanie na obrazie Pythona: pip install -r requirements.txt, ansible-galaxy collection install -r collections/requirements.yml, a następnie oba polecenia kontrolne z inventory testowym. Profil basic (w pliku .ansible-lint jako profile: basic) obejmuje typowe błędy kodowania i standardowy styl, nie zasypując starszego repozytorium setkami uwag. Po uporządkowaniu kodu podnosi się go do moderate, a potem do production.
Skrypt PowerShell uruchamiany z Harmonogramu zadań
Harmonogram zadań pokazuje wynik 0x0, czyli sukces, także wtedy, gdy skrypt nie zrobił nic z tego, co miał zrobić, na przykład po zmianie litery dysku, gdy błąd został wypisany i nikt go nie widzi. Skrypt uruchamiany bez nadzoru jest usługą produkcyjną i wymaga tego samego co usługa: zadeklarowanych wymagań, sprawdzonych danych wejściowych, trybu próbnego, logu, czytelnego wyniku i braku haseł w kodzie. Skrypt przechodzi kolejno przez cztery etapy: parametry z atrybutami walidacji, tryb -WhatIf (ShouldProcess), działanie w bloku try oraz log z kodem wyjścia. Błąd z dowolnego etapu trafia do catch, a wynik, także błędny, kończy się wpisem w logu i kodem różnym od zera.
Szkielet skryptu
Logika skryptu jest prosta celowo; ważna jest obudowa, którą można skopiować do każdego skryptu uruchamianego z harmonogramu.
#Requires -Version 5.1
<#
.SYNOPSIS
Usuwa pliki eksportu starsze niż podana liczba dni.
.DESCRIPTION
Uruchamiany z Harmonogramu zadań. Kody wyjścia: 0 sukces,
1 błąd krytyczny, 2 część plików nie została usunięta.
.EXAMPLE
.\Remove-OldExports.ps1 -Path D:\Export -OlderThanDays 30 -WhatIf
#>
[CmdletBinding(SupportsShouldProcess)]
param(
[Parameter(Mandatory)]
[ValidateScript({ Test-Path -LiteralPath $_ -PathType Container })]
[string]$Path,
[ValidateRange(1, 3650)]
[int]$OlderThanDays = 30,
[ValidateNotNullOrEmpty()]
[string]$LogDirectory = 'C:\ProgramData\Scripts\Logs'
)
$ErrorActionPreference = 'Stop'
Set-StrictMode -Version Latest
# Log zapisuje się także w trybie -WhatIf
New-Item -ItemType Directory -Path $LogDirectory -Force -WhatIf:$false | Out-Null
$logFile = Join-Path $LogDirectory ('Remove-OldExports_{0:yyyyMMdd}.log' -f (Get-Date))
function Write-Log {
param(
[string]$Message,
[ValidateSet('INFO', 'WARN', 'ERROR')][string]$Level = 'INFO'
)
$line = '{0:yyyy-MM-dd HH:mm:ss} [{1}] {2}' -f (Get-Date), $Level, $Message
Add-Content -LiteralPath $logFile -Value $line -Encoding UTF8 -WhatIf:$false
Write-Verbose $line
}
$exitCode = 0
try {
Write-Log "Start: $Path, starsze niż $OlderThanDays dni, WhatIf: $WhatIfPreference"
$cutoff = (Get-Date).AddDays(-$OlderThanDays)
$files = @(Get-ChildItem -LiteralPath $Path -File | Where-Object LastWriteTime -lt $cutoff)
Write-Log "Plików do usunięcia: $($files.Count)"
foreach ($file in $files) {
if ($PSCmdlet.ShouldProcess($file.FullName, 'Usuń plik')) {
try {
Remove-Item -LiteralPath $file.FullName
Write-Log "Usunięto: $($file.FullName)"
}
catch {
Write-Log "Nie usunięto: $($file.FullName): $($_.Exception.Message)" -Level WARN
$exitCode = 2
}
}
}
}
catch {
Write-Log "Błąd: $($_.Exception.Message)" -Level ERROR
$exitCode = 1
}
finally {
Write-Log "Koniec, kod wyjścia: $exitCode"
}
exit $exitCode
Nagłówek i parametry z walidacją
#Requires sprawdza warunki, zanim wykona się pierwsza linia: -Version 5.1, -Modules ActiveDirectory, -RunAsAdministrator. Skrypt kończy się wtedy jednym czytelnym komunikatem zamiast błędem w połowie pracy. Blok pomocy z .SYNOPSIS, .DESCRIPTION i .EXAMPLE jest dokumentacją, która nie odkleja się od kodu (Get-Help .\Remove-OldExports.ps1 -Full), a opis kodów wyjścia odpowiada na pierwsze pytanie przy wyniku 0x2 w harmonogramie.
Atrybuty walidacji działają, zanim skrypt cokolwiek zrobi: błędna wartość przerywa uruchomienie z komunikatem wskazującym parametr.
| Atrybut | Co sprawdza | Przykład użycia |
|---|---|---|
[Parameter(Mandatory)] | parametr musi być podany; w trybie -NonInteractive brak kończy się błędem | ścieżka katalogu |
[ValidateScript({ … })] | dowolny warunek zwracający prawdę lub fałsz | Test-Path -LiteralPath $_ -PathType Container |
[ValidateRange(1, 3650)] | zakres liczby | liczba dni |
[ValidateSet('Archive', 'Delete')] | wartość z listy, z podpowiadaniem w konsoli | tryb działania |
[ValidatePattern('^srv-[a-z]+-\d{2}$')] | wyrażenie regularne | nazwa serwera |
[ValidateNotNullOrEmpty()] | brak pustej wartości | katalog logów |
Tryb -WhatIf
[CmdletBinding(SupportsShouldProcess)] dodaje do skryptu parametry -WhatIf i -Confirm. Każda zmiana jest opakowana w $PSCmdlet.ShouldProcess(cel, operacja), który w trybie -WhatIf zwraca fałsz i wypisuje, co zostałoby zrobione. Skutki skryptu na produkcji można więc sprawdzić, zanim zostaną wykonane. Odpowiednikiem w Ansible jest tryb --check.
Błędy i log
Domyślna wartość $ErrorActionPreference to Continue. Wiele błędów w poleceniach, na przykład Get-ChildItem na nieistniejącej ścieżce, jest wtedy błędem niekończącym: PowerShell wypisuje komunikat i wykonuje kolejne linie, a blok catch się nie uruchamia. Stąd wynik 0x0 mimo błędu. $ErrorActionPreference = 'Stop' zamienia każdy błąd w wyjątek, który trafia do catch. Set-StrictMode -Version Latest dodaje drugi bezpiecznik: odwołanie do nieistniejącej zmiennej jest błędem, więc literówka nie zamienia się po cichu w pustą wartość.
Start-Transcript -Path <plik> -Append jest najprostszą drogą dla istniejącego skryptu, ale daje log rozwlekły i trudny do przeszukiwania. Własna funkcja, taka jak Write-Log w szkielecie, zapisuje jedną linię na zdarzenie z datą i poziomem, którą łatwo porównać między dniami i wysłać do centralnego systemu logów. Write-Verbose służy do szczegółów widocznych przy ręcznym uruchomieniu z -Verbose.
Kody wyjścia dla harmonogramu
Harmonogram zadań nie czyta logu. Widzi tylko kod, z którym zakończył się proces powershell.exe, i pokazuje go w zapisie szesnastkowym.
| Kod w skrypcie | Znaczenie | Wynik w harmonogramie |
|---|---|---|
exit 0 | wszystko wykonane | 0x0 |
exit 1 | błąd krytyczny, praca przerwana | 0x1 |
exit 2 | wykonane częściowo, szczegóły w logu | 0x2 |
| brak (nadaje harmonogram) | zadanie jeszcze nie było uruchomione | 0x41303 |
Kod dociera do harmonogramu, gdy skrypt jest uruchamiany przez -File; przy -Command może zostać spłaszczony do 0 albo 1. Zadanie rejestruje się poleceniami New-ScheduledTaskAction -Execute 'powershell.exe' -Argument '-NoProfile -NonInteractive -File ...', New-ScheduledTaskTrigger i New-ScheduledTaskPrincipal z kontem gMSA (-LogonType Password), a następnie Register-ScheduledTask. -NonInteractive sprawia, że każde pytanie o brakujący parametr kończy się błędem zamiast zawieszenia zadania na zawsze.
Sekrety w skrypcie
Przy uruchomieniu z harmonogramu skrypt działa na koncie usługi zarządzanej przez grupę (gMSA), np. gmsa-scripts$, które samo ma uprawnienia do udziału lub obiektów w katalogu (przy ręcznym uruchomieniu wystarcza Get-Credential). Hasła nie zna nikt, a domena zmienia je automatycznie, domyślnie co 30 dni. Konto tworzy New-ADServiceAccount (wymaga klucza głównego KDS w domenie), a na serwerze trzeba je zainstalować (Install-ADServiceAccount) i sprawdzić (Test-ADServiceAccount). Konto potrzebuje prawa „Logowanie w trybie wsadowym” (Log on as a batch job), a serwer musi być wpisany w PrincipalsAllowedToRetrieveManagedPassword.
Tokeny i klucze do zewnętrznych API pochodzą z modułu Microsoft.PowerShell.SecretManagement z rozszerzeniem magazynu, np. Microsoft.PowerShell.SecretStore, albo z magazynu zewnętrznego, np. Azure Key Vault. W skrypcie zostaje tylko odwołanie (Get-Secret -Name 'ExportApiToken' -Vault 'Automation' -AsPlainText). SecretStore jest przypisany do użytkownika, więc konfiguruje się go w kontekście konta uruchamiającego zadanie, z Interaction ustawionym na None. Moduły SecretManagement i SecretStore są uznane za kompletne i dostają tylko poprawki bezpieczeństwa.
ConvertTo-SecureString 'Haslo123' -AsPlainText -Force w treści skryptu nie chroni hasła, tylko zmienia jego typ: hasło leży jawnie w pliku, w repozytorium i w każdej kopii zapasowej. To samo dotyczy haseł w argumentach zadania harmonogramu.
Jakość i podpis
PSScriptAnalyzer (Invoke-ScriptAnalyzer) wychwytuje aliasy, hasła jako zwykły tekst i funkcje zmieniające stan bez ShouldProcess, więc kod przechodzi przez niego przed wdrożeniem. Polityka wykonywania nie jest granicą bezpieczeństwa, ale przy AllSigned podpis (Set-AuthenticodeSignature, certyfikat podpisu kodu zaufany na serwerach) działa jak kontrola zmian: edycja pliku na serwerze unieważnia podpis, więc poprawki muszą przejść przez repozytorium.
Automatyzacja realizacji zgłoszeń
Powtarzalny wniosek, na przykład dostęp tylko do odczytu do udziału z raportami, to kilka minut pracy i dni oczekiwania w kolejce. Czas oczekiwania nie wynika z trudności zadania, tylko z tego, że człowiek musi je zauważyć, przeczytać i obsłużyć ręcznie. Ten etap usuwa połączenie systemu zgłoszeń (ITSM) z platformą automatyzacji, taką jak AWX lub Ansible Automation Platform. Wzorzec składa się z pięciu kroków:
- Formularz w systemie zgłoszeń ze stałymi polami: lista udziałów, wybór użytkownika z katalogu, przełącznik odczyt lub modyfikacja, a nie pole „opisz, czego potrzebujesz”.
- Akceptacja w tym samym systemie, przez przełożonego lub właściciela zasobu, według istniejących reguł.
- Wywołanie API platformy automatyzacji po akceptacji, z zawartością formularza jako zmiennymi.
- Automatyzacja, czyli playbook, sprawdza dane, wykonuje zmianę i zbiera wynik.
- Zapis wyniku w zgłoszeniu: co zostało zrobione albo jaki wystąpił błąd. Udane zgłoszenie zamyka się samo, nieudane wraca do kolejki dla człowieka.
Człowiek pojawia się w dwóch miejscach: przy akceptacji i przy błędzie.
Formularz
Każde pole formularza staje się zmienną w playbooku, dlatego od początku projektuje się je razem z regułą walidacji.
| Pole formularza | Zmienna | Typ w formularzu | Sprawdzenie w playbooku |
|---|---|---|---|
| Numer zgłoszenia | request_id | uzupełniany automatycznie | zgodny ze wzorcem, np. REQ- i sześć cyfr |
| Udział | share_name | lista wyboru | nazwa na liście dozwolonych udziałów |
| Użytkownik | user_sam | wybór z katalogu | dozwolone znaki i długość nazwy konta |
| Poziom dostępu | access_level | przełącznik | wyłącznie read albo modify |
| Tryb próbny | dry_run | ukryte, ustawiane przez IT | wartość logiczna |
Lista dozwolonych udziałów leży w repozytorium projektu, w pliku obok playbooka (allowed_shares.yml, np. Finanse, Kadry, Projekty), a nie w formularzu ani w zmiennych: formularz pomaga wybrać, ale o tym, co jest dozwolone, decyduje automatyzacja. Dostęp nadaje się przez członkostwo w grupie, nie przez wpis konta w uprawnieniach udziału, dzięki czemu automatyzacja potrzebuje prawa do zmiany członkostwa grup, a nie do zmiany ACL na serwerze plików.
Wywołanie szablonu zadania przez API
W AWX i Ansible Automation Platform playbook uruchamia się przez szablon zadania (job template), który łączy playbook, inventory i poświadczenia. Po akceptacji system zgłoszeń wysyła jedno żądanie POST /api/v2/job_templates/<id>/launch/ z nagłówkiem Authorization: Bearer <token>, typem application/json i ciałem {"extra_vars": {"request_id": "REQ-004211", "share_name": "Finanse", "user_sam": "jkowalska", "access_level": "read", "dry_run": false}}. Odpowiedź zawiera identyfikator uruchomionego zadania (pole job), który system zgłoszeń zapisuje przy wniosku. Stan zadania odczytuje się z GET /api/v2/jobs/<id>/, a pole status przyjmuje między innymi wartości successful, failed, error i canceled. W Ansible Automation Platform 2.5 i nowszych to samo API controllera jest dostępne pod ścieżką /api/controller/v2/.
Szablon przyjmie extra_vars z żądania tylko wtedy, gdy ma włączone pytanie o zmienne przy uruchomieniu (ask_variables_on_launch) albo ankietę (survey) z tymi polami. W przeciwnym razie platforma uruchomi zadanie bez nich, a pominięte pola pokaże w ignored_fields. Jednocześnie extra_vars mają w Ansible najwyższy priorytet i nadpisują każdą zmienną zdefiniowaną w playbooku, w inventory czy w roli. Bezpieczna konfiguracja to ankieta z polami formularza (survey_enabled: true) przy wyłączonym ask_variables_on_launch: przechodzą tylko pola z ankiety. Oba ustawienia na false oznaczają, że zmienne z żądania są ignorowane.
Playbook: walidacja, zmiana, wynik
Formularz można zmienić, obejść albo wywołać API bezpośrednio, więc playbook sprawdza każde pole sam. Cały wniosek jest jednym blokiem: po walidacji i zmianie playbook zapisuje wynik w zgłoszeniu modułem ansible.builtin.uri (notatka i zmiana statusu na resolved, a w trybie próbnym open), delegowanym do localhost, bo moduł działa tylko na platformie posix; dla hosta Windows odpowiednikiem jest ansible.windows.win_uri. Jeśli którykolwiek krok się nie powiedzie, sekcja rescue zapisuje błąd w zgłoszeniu, przekazuje je do kolejki dla ludzi i kończy zadanie niepowodzeniem przez ansible.builtin.fail. Adres API systemu zgłoszeń i nazwy pól w body zależą od konkretnego produktu; zmienna awx_job_id w notatce wiąże zgłoszenie z pełnym logiem zadania.
- name: Dostęp do udziału na podstawie zgłoszenia
hosts: ad_management
gather_facts: false
tasks:
- name: Obsłuż wniosek
block:
- name: Sprawdź dane z formularza
ansible.builtin.assert:
that:
- request_id is match('^REQ-[0-9]{6}$')
# lista z pliku, nie ze zmiennej: extra_vars jej nie nadpiszą
- share_name in (lookup('ansible.builtin.file', 'allowed_shares.yml') | from_yaml)
- access_level in ['read', 'modify']
- user_sam is match('^[a-z][a-z0-9.]{1,19}$')
fail_msg: Dane wniosku nie przeszły walidacji
quiet: true
- name: Dodaj użytkownika do grupy dostępu
microsoft.ad.group:
name: "GG-Share-{{ share_name }}-{{ access_level }}"
members:
add:
- "{{ user_sam }}"
state: present
check_mode: "{{ dry_run | bool }}"
register: share_access_result
- name: Zapisz wynik w zgłoszeniu
ansible.builtin.uri:
url: "https://itsm.example.com/api/requests/{{ request_id }}/notes"
method: POST
headers:
Authorization: "Bearer {{ itsm_token }}"
body_format: json
body:
status: "{{ 'open' if dry_run | bool else 'resolved' }}"
note: "{{ 'Tryb próbny, dostęp nie został nadany' if dry_run | bool else 'Dostęp nadany' }}, zadanie AWX {{ awx_job_id }}"
delegate_to: localhost
no_log: true
rescue:
- name: Zapisz błąd w zgłoszeniu i przekaż do ludzi
ansible.builtin.uri:
url: "https://itsm.example.com/api/requests/{{ request_id }}/notes"
method: POST
headers:
Authorization: "Bearer {{ itsm_token }}"
body_format: json
body:
status: open
assigned_group: it-service-desk
note: "Błąd: {{ ansible_failed_result.msg | default('nieznany') }}, zadanie AWX {{ awx_job_id }}"
when: request_id | default('') is match('^REQ-[0-9]{6}$')
delegate_to: localhost
no_log: true
- name: Zakończ zadanie niepowodzeniem
ansible.builtin.fail:
msg: Wniosek nie został wykonany, szczegóły w zgłoszeniu
Decyzje widoczne w przykładzie:
assertstoi przed każdą zmianą, więc niepoprawne dane zatrzymują blok, zanim automatyzacja dotknie katalogu. W sekcjirescuenumer zgłoszenia trafia do adresu URL tylko wtedy, gdy przeszedł walidację, bo to także dane z zewnątrz. Przy niepoprawnymrequest_idjedynym sygnałem jest status zadania w AWX, który system zgłoszeń odpytuje i na tej podstawie oznacza wniosek jako wymagający człowieka.- Moduł
microsoft.ad.groupzmembers.addjest idempotentny: jeśli użytkownik już jest w grupie, zadanie kończy się bez zmian, więc ponowne uruchomienie tego samego wniosku nie jest błędem i nie tworzy duplikatów. - Lista dozwolonych udziałów jest czytana z pliku wprost w warunku, bez nazwy zmiennej, którą dałoby się podstawić przez
extra_vars.
Tryb próbny, uprawnienia i miary
Nowa automatyzacja przez pierwsze tygodnie działa z dry_run: true: waliduje dane, sprawdza w trybie check_mode, co by zmieniła, i zapisuje to w zgłoszeniu, a wniosek realizuje człowiek, porównując raport z własnym działaniem. Kryterium wyjścia (np. dwadzieścia kolejnych zgodnych wniosków) ustala się przed startem.
W przepływie biorą udział trzy tożsamości i każda dostaje tylko to, czego potrzebuje:
- token systemu zgłoszeń w AWX: osobny użytkownik z rolą Execute na jednym szablonie i zakresem
write(uruchomienie zadania jest operacją zapisu), bez dostępu do innych szablonów, inventory i poświadczeń, - konto, którym playbook działa w Active Directory: delegacja „Modify the membership of a group” na jednostce organizacyjnej z grupami dostępu do udziałów, nie administrator domeny,
- token API systemu zgłoszeń używany przez playbook: dodawanie notatek i zmiana statusu, bez uprawnień administracyjnych.
Pierwsza automatyzacja obsługuje wniosek o największym wolumenie i najmniejszych konsekwencjach błędu, zwykle dostęp do udziału albo do grupy dystrybucyjnej, a nie najbardziej skomplikowany. Mierzy się dwie liczby: czas od złożenia wniosku do realizacji oraz odsetek wniosków danego typu wykonanych bez udziału człowieka. Pierwsza pokazuje efekt dla użytkowników, druga to, gdzie automatyzacja jeszcze zawodzi i dlaczego.
Decyzje i alternatywy
| Podejście | Kiedy ma sens | Ograniczenie |
|---|---|---|
| Ansible do konfiguracji i zadań wielomaszynowych | pakiety, usługi, konta, rotacje, integracje przez API | nie utrzymuje stanu w czasie; --check jest przewidywaniem, nie gwarancją |
| Terraform lub OpenTofu | tworzenie maszyn, sieci i wolumenów | plan zmian i stan, ale nie konfiguracja wnętrza systemu |
| Kontroler GitOps | codzienne zarządzanie zasobami Kubernetes | wymaga manifestów w Git; Ansible co najwyżej instaluje kontroler |
| Skrypt w Pythonie wywołany jednym zadaniem | złożona logika i transformacje danych | wymaga własnych testów poza playbookiem |
| Konto gMSA dla zadania harmonogramu | skrypt z dostępem do udziału lub katalogu | wymaga klucza KDS, prawa logowania wsadowego i wpisu serwera w PrincipalsAllowedToRetrieveManagedPassword |
| SecretManagement z SecretStore | tokeny i klucze do zewnętrznych API | magazyn przypisany do użytkownika; konfiguracja w kontekście konta zadania |
Ankieta w szablonie przy ask_variables_on_launch: false | wywołanie z systemu zgłoszeń | przechodzą tylko pola ankiety |
ask_variables_on_launch: true | zmienne dowolne, wywołujący zaufany | wywołujący nadpisze każdą zmienną playbooka, razem z walidacją |
Podpis skryptów (AllSigned) | skrypty na serwerach pod kontrolą zmian | wymaga certyfikatu podpisu kodu zaufanego na serwerach |
Wdrożenie
- Ustalenie granic: Ansible dla konfiguracji i zadań wielomaszynowych, Terraform dla tworzenia zasobów, kontroler GitOps dla Kubernetes, logika złożona w skrypcie Pythona. Kontrola skutków: w playbookach nie ma zadań
commandz logiką w Jinja2 anishell: kubectl apply. - Układ repozytorium według tabeli ścieżek, z testowym inventory jako domyślnym i sekretami w Vault. Kontrola: każdy plik Vault zaszyfrowany (
grep -L '^\$ANSIBLE_VAULT'na plikachvault.yml). - Zadanie CI z
ansible-playbook --syntax-checkiansible-lintna profilubasic, podniesionym stopniowo doproduction. Kontrola: drugie uruchomienie playbooka nie zgłasza żadnegochanged. - Skrypty harmonogramu na szkielecie z walidacją,
-WhatIf, logiem i kodem wyjścia, uruchamiane przez-Filena koncie gMSA. Kontrola: zadania spoza katalogu Microsoft (Get-ScheduledTaskzGet-ScheduledTaskInfo) bez kodów błędu wLastTaskResult(kody SCHED_S_ to stany, nie błędy), uruchamiane zgodnie z harmonogramem, na koncie SYSTEM albo gMSA, bez haseł osobowych zapisanych w zadaniach. - Szablon zadania w AWX z ankietą i
ask_variables_on_launch: false, osobny użytkownik z rolą Execute i tokenem o zakresiewrite. Kontrola: odczyt konfiguracji szablonu przezGET /api/v2/job_templates/<id>/(wystarcza token z zakresemread) pokazuje w polachsurvey_enablediask_variables_on_launchwartościtrueifalse. - Pierwszy typ wniosku z
dry_run: truedo spełnienia kryterium wyjścia, a następnie przełączenie na wykonanie i pomiar czasu realizacji oraz odsetka wniosków obsłużonych bez człowieka.
Ograniczenia i pułapki
-WhatIfbez logu.-WhatIfprzenosi się na wszystkie polecenia skryptu, które go obsługują, także naNew-ItemiAdd-Contentzapisujące log. Bez-WhatIf:$falseprzy tych dwóch poleceniach przebieg próbny nie zostawia logu, a właśnie on jest jego wynikiem.- Kody wyjścia programów zewnętrznych.
$ErrorActionPreferencenie obejmuje kodów wyjścia programów, więc po wywołaniu na przykładrobocopytrzeba sprawdzić$LASTEXITCODE; dla robocopy wartości od 8 w górę oznaczają błąd (if ($LASTEXITCODE -ge 8) { throw "robocopy: kod $LASTEXITCODE" }). W PowerShell 7.4 i nowszym$PSNativeCommandUseErrorActionPreferenceustawione na$truezamienia niezerowe kody w błędy, ale robocopy używa ich także dla sukcesu, a Windows PowerShell 5.1 tej zmiennej nie ma. - Kodowanie pliku skryptu. Windows PowerShell 5.1 czyta plik bez BOM w stronie kodowej systemu i zamienia polskie znaki w komunikatach na przypadkowe symbole; skrypty z polskimi znakami zapisuje się jako UTF-8 z BOM.
- Walidacja z listą w zmiennej. Walidacja w formularzu jest wygodą dla użytkownika, nie zabezpieczeniem: każdy, kto ma token, wywoła szablon z dowolnymi wartościami. Lista dozwolonych wartości przechowywana jako zmienna playbooka zostanie nadpisana przez
extra_varsprzyask_variables_on_launch: true, razem z całą walidacją, dlatego jest czytana z pliku, a dane wejściowe traktowane jako niezaufane. rescuebezfail. Blok z obsłużonym błędem kończy zadanie statusemsuccessful, więc system zgłoszeń sprawdzający tylko status nie zauważy problemu. Końcoweansible.builtin.failwrescueprzywraca status błędu.