From 7f0e89a2f6ed7904a507c206cb718402c14ef147 Mon Sep 17 00:00:00 2001 From: Michael DeHaan Date: Sat, 1 Jun 2013 17:41:31 -0400 Subject: [PATCH] Explain when statements with |failure and |success. --- docsite/latest/rst/playbooks2.rst | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docsite/latest/rst/playbooks2.rst b/docsite/latest/rst/playbooks2.rst index 72dd864733c..67356cbf17d 100644 --- a/docsite/latest/rst/playbooks2.rst +++ b/docsite/latest/rst/playbooks2.rst @@ -284,6 +284,20 @@ Don't panic -- it's actually pretty simple:: action: command /sbin/shutdown -t now when: ansible_os_family == "Debian" +A number of Jinja2 "filters" can also be used in when statements, some of which are unique +and provided by ansible. Suppose we want to ignore the error of one statement and then +decide to do something conditionally based on success or failure:: + + tasks: + - action: command /bin/false + register: result + ignore_errors: True + - action: command /bin/something + when: result|failed + - action: command /bin/something_else + when: result|sucess + + As a reminder, to see what derived variables are available, you can do:: ansible hostname.example.com -m setup