Tegundir fullyrðinga

Kanonísk tilvísun fyrir fullyrðingar sem keyrðar eru í tilbúnu prófunar-VM. Nema annað sé tekið fram er markmiðið primary. Hver fullyrðing þarf einnig læsilegt svæði description.

Stöðugar gestafullyrðingar

Tegund	Skyldur `params`	Valfrjáls hegðun
`user_exists`	`username`	Keyrir `id`
`user_password`	`username`	Staðfestir að ólæst lykilorðshash sé til staðar; reynir ekki gagnvirka innskráningu
`user_in_group`	`username`, `group`	Tekur við stjórnunarjafngildum Vyatta við athugun á `sudo`/`admin`
`file_exists`	`path`	Tekur við skrá eða möppu
`file_contains`	`path`, `pattern` eða `content`	Notar `grep`; gildið er grep-mynstur, ekki eingöngu bókstafleg samanburður
`file_permissions`	`path`, `mode`	Ber saman áttundamáta sem `stat` skilar
`service_running`	`service`	Athugar systemd active state; þekkir lítið safn alias milli dreifinga
`service_enabled`	`service`	Athugar systemd enablement
`package_installed`	`package`	Athugar stuðning gagnagrunn pakkestjóra gesta
`port_listening`	`port`	`protocol` getur verið `tcp` eða `udp`; sjálfgefið er TCP
`command_succeeds`	`command`	Exit code verður að vera núll; `timeout_seconds`/`timeout` er takmarkað við 1–1 800 sekúndur
`command_output`	`command` auk regex í `expected_pattern`, `pattern`, `expected`, eða fullyrðingarstigs `expected`	Passar við stdout með Python regular-expression merkingu
`network_reachable`	`host`	`count` sjálfgefið 3; notar ICMP ping
`http_responds`	`url`	`status` sjálfgefið 200

Dæmi:


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

Skipun og fenginn úttak geta orðið prófunarsönnun. Ekki fella inn leyni.

GUI-fullyrðingar

GUI-athuganir treysta á virka skjásetu og skjáskot eða inntakshjálpara runner. Þær eru viðkvæmari fyrir umhverfi en skipanaathuganir gesta.

Tegund	Aðalbreytur	Hvað er athugað
`gui_application_opens`	`application` (kanónísk); handler tekur einnig við valkostum fyrir ræsingu	Ræsir forrit og leitar að glugga
`gui_window_visible`	titils- eða samsvörunarbreyturnar sem handler notar	Leitar að glugga sem er til
`gui_execute_command`	`command`	Keyrir skjáborðsskipun; getur tekið skjáskot
`gui_application_process`	`process_name`	Leitar að ferlinum sem headless varaleið
`gui_screenshot_matches`	`reference_id`; valfrjáls `threshold`, crop/mask svæði	Ber saman núverandi skjáskot við geymda reference
`gui_wallpaper_matches`	`wallpaper_path`; valfrjáls þröskuldar og svæði	Athugar stillta veggfóðursleið og sjónrænt útkomu
`desktop_wallpaper_matches`	`wallpaper_path`	Keyrir strangari desktop wallpaper provenance/configuration/visual athugun
`gui_click_element`	`x`, `y`	Sendir hnitbundin bendilsvið
`gui_form_fill`	`fields`	Fyllir inn hnitlýst eyðublaðsreiti
`gui_text_visible`	`text`, `contains`, eða `ocr_contains`	Notar OCR á skjá eða valið svæði

Framkvæmdarinn tekur einnig við samhæfisalias fyrir sum OCR og wallpaper tegundir. Veldu kanónísk nöfn hér að ofan í nýjum recipes. Hnitpróf eru upplausn viðkvæm; notaðu OCR eða útkomuathuganir þar sem hægt er.

Benchmark-athuganir eru sérstakt snið

cis_benchmark er í sögulegu fullyrðingaorðaforði uppskriftar, en venjulegur assertion dispatcher hefur engan cis_benchmark handler. CIS og aðrar benchmark-athuganir koma sem benchmark-færslur með audit_script og keyra í gegnum benchmark runner. Notaðu CIS benchmark verkflæði, ekki custom assertion með type: "cis_benchmark".

Túlkun á niðurstöðu

Vantar skyldugögn skilar error, eða planner getur sleppt fullyrðingunni með viðvörun áður en keyrt er.
Óaðgengilegt on_vm markmið skilar skipped.
Niðurstaða sem passar ekki skilar failed.
Aðeins passed er staðfestingarsönnun fyrir þessa fullyrðingu.

Sjá Custom assertions fyrir leiðbeiningar við höfund.