Add debug strategy plugin

[ks888]

ISSUE TYPE

• Feature Pull Request

ANSIBLE VERSION

ansible 2.1.0 (add-debug-strategy-plugin db83400d71) last updated 2016/03/24 01:47:52 (GMT +900)
  lib/ansible/modules/core: (detached HEAD 7efc09ef08) last updated 2016/03/24 01:12:49 (GMT +900)
  lib/ansible/modules/extras: (detached HEAD 7f9cdc0350) last updated 2016/03/24 01:13:10 (GMT +900)
  config file =
  configured module search path = Default w/o overrides

SUMMARY

Add "debug" strategy. It enables you to invoke a debugger when a task is failed, and check several info, such as the value of a variable. Also, it is possible to update module arguments in the debugger, and run the failed task again with new arguments to consider how you can fix an issue.

There is a post about this strategy:
https://groups.google.com/forum/#!topic/ansible-project/IzjDLiIORlw

[sivel]

This should probably have some associated documentation included with it.

[bcoca]

We can get docs from the readme https://github.com/ks888/ansible-playbook-debugger

[coveralls]

Changes Unknown when pulling 77c044c on ks888:add-debug-strategy-plugin into * on ansible:devel*.

[coveralls]

Changes Unknown when pulling b75f48b on ks888:add-debug-strategy-plugin into * on ansible:devel*.

[ks888]

@sivel @bcoca I've added usage document. It's a part of "Playbooks: Special Topics" and almost same as the original readme https://github.com/ks888/ansible-playbook-debugger, but written in reST.

[jpic]

Awesome !!! I just wanted to let you know it works for me:

$ cat test.yml 
- hosts: localhost
  connection: local
  strategy: debug
  gather_facts: no
  vars:
    var1: value1
  tasks:
    - name: wrong variable
      ping: data={{ wrong_var }}

$ ansible-playbook -i localhost, test.yml
PLAY [localhost] ***************************************************************

TASK [wrong variable] **********************************************************
fatal: [localhost]: FAILED! => {"failed": true, "msg": "'wrong_var' is undefined"}
Debugger invoked
(debug) p result
{'failed': True, 'msg': u"'wrong_var' is undefined"}
(debug) p task.args
{u'data': u'{{ wrong_var }}'}
(debug) redo
fatal: [localhost]: FAILED! => {"failed": true, "msg": "'wrong_var' is undefined"}
Debugger invoked
(debug) task.args['data'] = '{{ var1 }}'
(debug) redo
ok: [localhost]

PLAY RECAP *********************************************************************
localhost                  : ok=1    changed=0    unreachable=0    failed=0   

Perhaps some tests would be nice to have.

[abadger]

I think I recently fixed the bug which made you have to inherit directly from StrategyBase. Try just leaving in linear.StrategyModule and see if it now works.