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.

AutomatyzacjaWindows Server

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ń.

ZadanieAnsibleLepsze narzędzie lub uwaga
Pakiety, pliki konfiguracyjne, usługi, konta, reguły zaporyTakRdzeń zastosowań; moduły są idempotentne
Zadania operacyjne na wielu maszynach: rotacja certyfikatów, aktualizacje w ustalonej kolejnościTakserial ogranicza wielkość partii, order ustala kolejność, --limit zasięg
Integracje przez API: rejestr obrazów, system zgłoszeń, platforma CITakModuł ansible.builtin.uri albo dedykowana kolekcja
Windows Server tam, gdzie GPO nie sięgaTakWinRM lub PSRP i kolekcja ansible.windows; ustawienia stacji zostają w GPO
Utrzymywanie stanu w czasie i korekta dryfuNieKontroler, który stale uzgadnia stan
Codzienne zarządzanie zasobami KubernetesNieManifesty w Git i kontroler GitOps
Tworzenie maszyn, sieci i wolumenówZwykle nieAnsible ma do tego moduły, ale Terraform lub OpenTofu daje plan zmian i stan
Złożona logika i transformacje danychNieSkrypt 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żkaZawartość
ansible.cfgdomyślne inventory i roles_path
requirements.txtprzypięte wersje ansible-core i ansible-lint
collections/requirements.ymlkolekcje z przypiętymi wersjami
inventories/prod/, inventories/test/hosts.yml z maszynami i grupami oraz group_vars/
inventories/<środowisko>/group_vars/all/vars.ymlzmienne wspólne
inventories/<środowisko>/group_vars/all/vault.ymlsekrety, zaszyfrowane
inventories/<środowisko>/group_vars/<grupa>.ymlróż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.mdsposó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ę:

  • creates z ścieżką pliku-znacznika pomija zadanie, gdy plik już istnieje (inicjalizacja katalogu danych aplikacji),
  • changed_when: false razem z check_mode: false oznacza zadanie wyłącznie odczytujące, które wykonuje się także w trybie --check (odczyt stanu migracji schematu),
  • when na 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.

AtrybutCo sprawdzaPrzykł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łszTest-Path -LiteralPath $_ -PathType Container
[ValidateRange(1, 3650)]zakres liczbyliczba dni
[ValidateSet('Archive', 'Delete')]wartość z listy, z podpowiadaniem w konsolitryb działania
[ValidatePattern('^srv-[a-z]+-\d{2}$')]wyrażenie regularnenazwa serwera
[ValidateNotNullOrEmpty()]brak pustej wartościkatalog 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 skrypcieZnaczenieWynik w harmonogramie
exit 0wszystko wykonane0x0
exit 1błąd krytyczny, praca przerwana0x1
exit 2wykonane częściowo, szczegóły w logu0x2
brak (nadaje harmonogram)zadanie jeszcze nie było uruchomione0x41303

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:

  1. 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”.
  2. Akceptacja w tym samym systemie, przez przełożonego lub właściciela zasobu, według istniejących reguł.
  3. Wywołanie API platformy automatyzacji po akceptacji, z zawartością formularza jako zmiennymi.
  4. Automatyzacja, czyli playbook, sprawdza dane, wykonuje zmianę i zbiera wynik.
  5. 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.

Rys. 1. Człowiek składa wniosek i go akceptuje, resztę wykonuje automat; błąd nie zamyka zgłoszenia, tylko wraca z pełnym komunikatem do kolejki.

Formularz

Każde pole formularza staje się zmienną w playbooku, dlatego od początku projektuje się je razem z regułą walidacji.

Pole formularzaZmiennaTyp w formularzuSprawdzenie w playbooku
Numer zgłoszeniarequest_iduzupełniany automatyczniezgodny ze wzorcem, np. REQ- i sześć cyfr
Udziałshare_namelista wyborunazwa na liście dozwolonych udziałów
Użytkownikuser_samwybór z katalogudozwolone znaki i długość nazwy konta
Poziom dostępuaccess_levelprzełącznikwyłącznie read albo modify
Tryb próbnydry_runukryte, ustawiane przez ITwartość 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:

  • assert stoi przed każdą zmianą, więc niepoprawne dane zatrzymują blok, zanim automatyzacja dotknie katalogu. W sekcji rescue numer zgłoszenia trafia do adresu URL tylko wtedy, gdy przeszedł walidację, bo to także dane z zewnątrz. Przy niepoprawnym request_id jedynym 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.group z members.add jest 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ścieKiedy ma sensOgraniczenie
Ansible do konfiguracji i zadań wielomaszynowychpakiety, usługi, konta, rotacje, integracje przez APInie utrzymuje stanu w czasie; --check jest przewidywaniem, nie gwarancją
Terraform lub OpenTofutworzenie maszyn, sieci i wolumenówplan zmian i stan, ale nie konfiguracja wnętrza systemu
Kontroler GitOpscodzienne zarządzanie zasobami Kuberneteswymaga manifestów w Git; Ansible co najwyżej instaluje kontroler
Skrypt w Pythonie wywołany jednym zadaniemzłożona logika i transformacje danychwymaga własnych testów poza playbookiem
Konto gMSA dla zadania harmonogramuskrypt z dostępem do udziału lub kataloguwymaga klucza KDS, prawa logowania wsadowego i wpisu serwera w PrincipalsAllowedToRetrieveManagedPassword
SecretManagement z SecretStoretokeny i klucze do zewnętrznych APImagazyn przypisany do użytkownika; konfiguracja w kontekście konta zadania
Ankieta w szablonie przy ask_variables_on_launch: falsewywołanie z systemu zgłoszeńprzechodzą tylko pola ankiety
ask_variables_on_launch: truezmienne dowolne, wywołujący zaufanywywołujący nadpisze każdą zmienną playbooka, razem z walidacją
Podpis skryptów (AllSigned)skrypty na serwerach pod kontrolą zmianwymaga certyfikatu podpisu kodu zaufanego na serwerach

Wdrożenie

  1. 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ń command z logiką w Jinja2 ani shell: kubectl apply.
  2. 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 plikach vault.yml).
  3. Zadanie CI z ansible-playbook --syntax-check i ansible-lint na profilu basic, podniesionym stopniowo do production. Kontrola: drugie uruchomienie playbooka nie zgłasza żadnego changed.
  4. Skrypty harmonogramu na szkielecie z walidacją, -WhatIf, logiem i kodem wyjścia, uruchamiane przez -File na koncie gMSA. Kontrola: zadania spoza katalogu Microsoft (Get-ScheduledTask z Get-ScheduledTaskInfo) bez kodów błędu w LastTaskResult (kody SCHED_S_ to stany, nie błędy), uruchamiane zgodnie z harmonogramem, na koncie SYSTEM albo gMSA, bez haseł osobowych zapisanych w zadaniach.
  5. Szablon zadania w AWX z ankietą i ask_variables_on_launch: false, osobny użytkownik z rolą Execute i tokenem o zakresie write. Kontrola: odczyt konfiguracji szablonu przez GET /api/v2/job_templates/<id>/ (wystarcza token z zakresem read) pokazuje w polach survey_enabled i ask_variables_on_launch wartości true i false.
  6. Pierwszy typ wniosku z dry_run: true do 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

  • -WhatIf bez logu. -WhatIf przenosi się na wszystkie polecenia skryptu, które go obsługują, także na New-Item i Add-Content zapisujące log. Bez -WhatIf:$false przy 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. $ErrorActionPreference nie obejmuje kodów wyjścia programów, więc po wywołaniu na przykład robocopy trzeba 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 $PSNativeCommandUseErrorActionPreference ustawione na $true zamienia 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_vars przy ask_variables_on_launch: true, razem z całą walidacją, dlatego jest czytana z pliku, a dane wejściowe traktowane jako niezaufane.
  • rescue bez fail. Blok z obsłużonym błędem kończy zadanie statusem successful, więc system zgłoszeń sprawdzający tylko status nie zauważy problemu. Końcowe ansible.builtin.fail w rescue przywraca status błędu.

Źródła