Docker module state argument

Archives Ansible Project
1

Community,

I’m using the docker module and the documentation appears to be wrong. I’m not sure where the right place is to bring this up.
I’m running ansible version 1.8.2.

Ansible Documentation:
http://docs.ansible.com/docker_module.html

parameter | required | default | choices |

  • | - | - | - |

state | no | started |
- present
- started
- reloaded
- restarted
- stopped
- killed
- absent
|

  • | - | - | - |

Task:

  • name: START | Start container
    docker:
    image={{item.value.image}}
    name={{item.value.name}}
    hostname={{item.value.name}}
    ports={{item.value.ports_fwd}}
    expose={{item.value.ports_exp}}
    publish_all_ports=True
    state=started

Error:

TASK: [startContainers | START | Start containers] ***************************
failed: [dockerhost2] => (item=(0, ‘tier1_node1’)) => {“failed”: true, “item”: [0, “tier1_node1”]}
msg: value of state must be one of: absent,present,running,stopped,killed,restarted, got: started

I assume the documentation has gotten out of date, but there should be a note on the page for the module.

Thanks!
Chip

2

I can’t say whether it’s right or not, but this is a perfect opportunity to make a pull request with a recommended change. All of the docs are in Github. Docs live here:

https://github.com/ansible/ansible/tree/devel/docsite/rst

–g

3

I believe this was added to the latest docker module (devel) but the documentation was update w/o a ‘version added’.