Väite tüübid

Kanooniline viide väidetele, mis käivitatakse ettevalmistatud test-VM-is. Kui pole märgitud teisiti, on sihtmärk primary. Iga väide vajab ka inimloetavat välja description.

Stabiilsed külalise väited

Tüüp	Kohustuslikud `params`	Valikuline käitumine
`user_exists`	`username`	Käivitab `id`
`user_password`	`username`	Kontrollib, et lukustamata parooliräsi on olemas; ei proovi interaktiivset sisselogimist
`user_in_group`	`username`, `group`	Aktsepteerib Vyatta administraatori vasted `sudo`/`admin` kontrollimisel
`file_exists`	`path`	Aktsepteerib faili või kataloogi
`file_contains`	`path`, `pattern` või `content`	Kasutab `grep`; väärtus on grep muster, mitte ainult sõnasõnaline võrdlus
`file_permissions`	`path`, `mode`	Võrdleb `stat` teatatud kaheksandmist režiimi
`service_running`	`service`	Kontrollib systemd active state; tunneb väikest alias hulka distrode vahel
`service_enabled`	`service`	Kontrollib systemd enablement
`package_installed`	`package`	Kontrollib külalise toetatud pakihalduri andmebaasi
`port_listening`	`port`	`protocol` võib olla `tcp` või `udp`; vaikimisi TCP
`command_succeeds`	`command`	Väljumiskood peab olema null; `timeout_seconds`/`timeout` piiratakse 1–1 800 sekundini
`command_output`	`command` pluss regex väljades `expected_pattern`, `pattern`, `expected` või väite tasemel `expected`	Sobitab stdout Python regular-expression semantikaga
`network_reachable`	`host`	`count` vaikimisi 3; kasutab ICMP ping
`http_responds`	`url`	`status` vaikimisi 200

Näide:


{
  "type": "command_output",
  "description": "Application reports the expected release",
  "params": {
    "command": "/opt/acme/bin/acme --version",
    "expected_pattern": "^acme 2\\.4\\.[0-9]+$"
  }
}

Käsk ja salvestatud väljund võivad muutuda testitõendiks. Ära pane salajasi andmeid sisse.

GUI väited

GUI kontrollid sõltuvad toimivast ekraaniseansist ja runneri ekraanipildi või sisendabilist. Need on keskkonnatundlikumad kui külalise käsukontrollid.

Tüüp	Peamised parameetrid	Mida kontrollitakse
`gui_application_opens`	`application` (kanooniline); handler aktsepteerib ka käivitusele spetsiifilisi valikuid	Käivitab rakenduse ja otsib akent
`gui_window_visible`	akna pealkirja või sobivusparameetrid, mida handler kasutab	Otsib olemasolevat akent
`gui_execute_command`	`command`	Käivitab töölauakäsu; võib teha ekraanipildi
`gui_application_process`	`process_name`	Otsib protsessi headless varuvariandina
`gui_screenshot_matches`	`reference_id`; valikuline `threshold`, crop/mask piirkonnad	Võrdleb praegust ekraanipilti salvestatud reference-ga
`gui_wallpaper_matches`	`wallpaper_path`; valikulised läved ja piirkonnad	Kontrollib seadistatud taustapildi teed ja visuaalset tulemust
`desktop_wallpaper_matches`	`wallpaper_path`	Käivitab rangema desktop wallpaper provenance/configuration/visual kontrolli
`gui_click_element`	`x`, `y`	Saadab koordinaatidel põhineva pointeri sisendi
`gui_form_fill`	`fields`	Täidab koordinaatidega kirjeldatud vormiväljad
`gui_text_visible`	`text`, `contains` või `ocr_contains`	Kasutab OCR-i ekraanil või valitud piirkonnas

Täitja aktsepteerib ka ühilduvusaliasi mõne OCR ja wallpaper tüübi jaoks. Uutes recipes eelista ülalolevaid kanoonilisi nimesid. Koordinaattestid on eraldusvõime tundlikud; kasuta võimalusel OCR-i või tulemuse kontrolle.

Benchmark kontrollid on eraldi vorming

cis_benchmark on retsepti ajaloolises väite sõnavaras, kuid tavalisel assertion dispatcheril puudub cis_benchmark handler. CIS ja teised benchmark kontrollid tarnitakse benchmark kirjetena koos audit_script-iga ja käivitatakse benchmark runneri kaudu. Kasuta CIS benchmark töövoogu, mitte custom assertionit, kus type: "cis_benchmark".

Tulemuse tõlgendamine

Puuduvad kohustuslikud andmed annavad error, või planner võib väite enne käivitamist hoiatusega eemaldada.
Kättesaamatu on_vm sihtmärk annab skipped.
Mittevastav tulemus annab failed.
Ainult passed on kinnitav tõend selle väite kohta.

Vaata Custom assertions juhiseid koostamiseks.