How to trigger a custom error from inside a Jinja template?

Question

Though Ansible itself has a way for triggering a custom error, I can not find anything similar for Jinja.

My current method uses a syntax error:

{%  if 'ansible_mounts' in hostvars[host] %}
# {{ host }} knows its mount-points
{% else %}
# {% error!! No ansible_mounts listed for host - fact-gathering must've failed %}
{% endif %}

but those are rendered poorly at run-time -- one needs to look inside the template-file and search for the error (the rendering does not even include the line-number!).

Is there a way to output a neat failure message from inside Jinja-template?

You should write a plugin: https://stackoverflow.com/questions/21778252/how-to-raise-an-exception-in-a-jinja2-macro — Konstantin Suvorov, Aug 29 '17 at 15:52
Дякую пану. Якщо пан переробить свій коментар на _відповідь_, я її "прийму". — Mikhail T., Aug 29 '17 at 19:08

sabik · Answer 1 · 2020-07-13T00:58:31.373

3

Ansible adds the mandatory filter to Jinja, which can be used to do this:

{{ ('OK text' if condition_ok) | mandatory('Text of error message') }}

gives the failure:

fatal: [hostname]: FAILED! => {"msg": "Text of error message"}

(Replace condition_ok with the check that you need to make; 'OK text' can be just '' if nothing should be substituted.)

edited Jul 13 '20 at 00:58

answered Jul 13 '20 at 00:53

sabik

31
2

Didn't work for me, and looking at the [source](https://github.com/ansible/ansible/blob/989eeb243fcf9236bd54d4df60c01f6db4e642a7/lib/ansible/plugins/filter/core.py#L290) it actually checks that the thing passed in is undefined, not just false-y. – lost Sep 28 '21 at 09:25

score 3 · Accepted Answer · answered Aug 30 '17 at 05:40

3

Answer from the comment:

There is no easy way to accomplish this – only via custom plugin. For details see: https://stackoverflow.com/questions/21778252/how-to-raise-an-exception-in-a-jinja2-macro

answered Aug 30 '17 at 05:40

Konstantin Suvorov

3,836
1
11
13

score 1 · Answer 3 · edited Jan 05 '20 at 12:51

I have written a jinja2 extension-jinja2_error to raise error.

Firstly,

pip install jinja2_error

If you use it with ansible

ANSIBLE_JINJA2_EXTENSIONS=jinja2_error.ErrorExtension ansible-playbook site.yml -v

If you use it with jinja2 Environment

    from jinja2 import Environment

    from jinja2_error import jinja2_error

    if __name__ == '__main__':
        env = Environment(extensions=[jinja2_error.ErrorExtension])
        render_text = """
                {% if 1==1 %}
                  {% error "It's error" %}
                {% endif %}
                """
        template = env.from_string(render_text)
        result = template.render({"a": "b"})

If you want to know the details, please access

https://github.com/mumubin/jiaja2_error

score 0 · Answer 4 · answered Mar 18 '22 at 09:10

0

For those who looking for like mandatory filter but not using ansible

{%- if not param.columns %} 
{# use 'include' wrong way, so it raise a error #}
{% include "required 'params.columns' not found!" %}
{%- endif %}

answered Mar 18 '22 at 09:10

Han-Jong Ko

101
2

How to trigger a custom error from inside a Jinja template?

4 Answers4