Assert conditions; task fails if conditions are not met.
| Parameter | Description | Type | Required | Default |
|---|---|---|---|---|
| that | Assertion conditions, supports template syntax | array or string | Yes | - |
| success_msg | Message to stdout when assertion is true | string | No | True |
| fail_msg | Message to stderr when assertion is false | string | No | False |
| msg | Same as fail_msg, lower priority than fail_msg | string | No | False |
1. Single condition (string)
- name: assert single condition
assert:
that: eq 1 1- stdout:
"True" - stderr:
""
2. Multiple conditions (array)
- name: assert multi-condition
assert:
that:
- eq 1 1
- eq 1 2- stdout:
"False" - stderr:
"False"
3. Custom success message
- name: assert is succeed
assert:
that: eq 1 1
success_msg: "It's succeed"- stdout:
"It's succeed" - stderr:
""
4. Custom failure message
- name: assert is failed
assert:
that: eq 1 2
fail_msg: "It's failed"
msg: "It's failed!"- stdout:
"False" - stderr:
"It's failed"