Sérsniðnar fullyrðingar

Sérsniðnar fullyrðingar breyta kröfu í skipun sem VM harness getur keyrt. Notaðu þær fyrir hegðun sem litla sjálfgefna prófunarsett styður ekki.

Bygging

Hver custom-test hópur þarf lýsingu og eina eða fleiri skipulagðar fullyrðingar:

{
  "description": "Verify the web service",
  "category": "application",
  "assertions": [
    {
      "type": "service_running",
      "description": "Nginx is active",
      "params": { "service": "nginx" },
      "expected_visual": "The evidence panel shows nginx active"
    },
    {
      "type": "http_responds",
      "description": "Local health endpoint responds",
      "params": { "url": "http://localhost/health", "status": 200 }
    }
  ]
}

description er skylt bæði á hópnum og hverri fullyrðingu. on_vm velur VM auðkenni í fjöl-VM prófunarumhverfi; án þess notar keyrslan primary. expected_visual gefur ætlaða stöðu skjámyndar þegar sjónrænu sönnunargögnin hliðin eru virk.

Hannaðu fullyrðingar utan um niðurstöður

• Athugaðu þjónustu með service_running, ekki bara hvort pakki sé til staðar.
• Athugaðu staðbundinn endpoint áður en ytri leið er prófuð.
• Notaðu file_contains fyrir einn stöðugan stillingarstaðreynd, ekki heila skrána sem brotnar við saklausan snið.
• Notaðu command_succeeds aðeins með ákveðnum, ógagnvirkum skipunum.
• Gefðu löngum skipunum timeout_seconds aðeins þegar þörf er á. Framkvæmdin takmarkar timeout skipana við 1–1,800 sekúndur.
• Settu aldrei auðkenni í skipanir, lýsingar, ætlaðan úttak eða URL; þessir reitir geta birst í sönnunargögnum og annálum.

Merking bilunar

Óþekkt tegund er nú tekin gild af recipe líkaninu en verður error þegar framkvæmdin finnur ekki handler. Þekktar fullyrðingar sem vantar skyldubundna færibreytur geta verið felldar út við samsetningu prófunaráætlunar með viðvörun. Því skaltu staðfesta recipe og skoða materialized prófunaráætlun áður en build hefst.

Ef on_vm nefnir VM sem er ekki til er fullyrðingin skipped. Ekki telja skipped eða error sem tókst staðfestingu.

Dæmi með mörgum VM

{
  "description": "Client reaches the API node",
  "assertions": [
    {
      "type": "http_responds",
      "description": "API health is reachable from the client",
      "on_vm": "client",
      "params": { "url": "http://api:8080/health", "status": 200 }
    }
  ],
  "environment": {
    "vms": [
      { "vm_id": "client", "role": "client", "networks": ["lan"] },
      { "vm_id": "api", "role": "server", "networks": ["lan"] }
    ],
    "networks": [
      { "network_id": "lan", "type": "isolated", "dhcp": true }
    ]
  }
}

Leiðrétting VM nafna fer eftir prófunartopology og fundnum vistföngum hennar. Staðfestu myndaða topology og leystu skipun fullyrðingarinnar í keyrslu sönnunargögnum.

Fyrir hverja studda tegund og færibreytu, sjá Tegundir fullyrðinga.