# Docker Modules Roadmap

**URL:** <https://forum.ansible.com/t/docker-modules-roadmap/20565>\
**Category:** Ansible Developer\
**Created:** [February 12, 2016, 8:54pm UTC](https://forum.ansible.com/t/docker-modules-roadmap/20565 "2016-02-12T20:54:00Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![Chris\_Houseknecht](https://avatars.discourse-cdn.com/v4/letter/c/c57346/32.png) [@Chris\_Houseknecht](https://forum.ansible.com/u/Chris_Houseknecht)\
**Post date:** [February 12, 2016, 8:54pm UTC](https://forum.ansible.com/t/docker-modules-roadmap/20565/1 "2016-02-12T20:54:00Z")

</div>

We’re excited to announce a clear roadmap to providing first-class support for container orchestration with Ansible. Over the coming months we will create a supported and maintainable solution that keeps pace with the fast moving world of containers.

The current Docker modules will be around for a while yet, but as the new container modules begin to take shape, we will deprecate the current modules.

To kick things off we identified a list of core modules Ansible must provide. The list appears below with a description of the module’s purpose and scope.

But before we get too far down the development path, we need to hear from you. We’ll be thinking and collaborating on the shape of each module here:

[https://public.etherpad-mozilla.org/p/9RQPFWC1Mv](https://public.etherpad-mozilla.org/p/9RQPFWC1Mv)

Have a look at the list of modules. Tells us what we missed. What could be better? We’ll take your input and shape the roadmap between now and 2/26 before officially kicking off development.

Thanks!

Chris Houseknecht

[@chouseknecht](https://twitter.com/chouseknecht)

[RedHat | Ansible](http://ansible.com)

## Core Docker Modules

docker\_container

Manage the container lifecycle through created, started, stopped, killed, paused and unpaused states. Development of this module will start with the current docker module and remove things falling outside of this scope. Functionality that can be shared by all modules will be moved to module\_utils.

docker\_files

Provide an interface to the docker cp and diff API endpoints.

docker\_image

Manage docker images using the build, list, pull, push, rmi, tag, and save image API endpoints. Development will begin with the current docker\_image module.

docker\_network

Manage docker networks through the network connect, create, disconnect, inspect, ls and rm endpoints.

docker\_volume

Manage docker volumes through the volume create, inspect, ls and rm API endpoints.

docker\_login

An interface to the login API endpoint. Development will begin with the current docker\_login module.

docker\_daemon

Manage the docker daemon through the docker daemon API endpoint.

docker inventory script

Develop an inventory script that provides comprehensive docker container facts and can connect to either a locally running or remote API.

---

<div class="post-metadata">

**Author:** ![alexk4work](https://avatars.discourse-cdn.com/v4/letter/a/a3d4f5/32.png) [@alexk4work](https://forum.ansible.com/u/alexk4work)\
**Post date:** [February 15, 2016, 6:58pm UTC](https://forum.ansible.com/t/docker-modules-roadmap/20565/2 "2016-02-15T18:58:17Z")

</div>

That’s great! I’m so tired to support my own local pile of patches to existing docker\* modules. Probably the team is very busy, but now it takes ages to push something to the upstream:(

I suggest to take a look on the docker\_facts module [https://github.com/CaptTofu/ansible-modules-extras/commit/c069b604ff386f70408d1dc5078e9fb867829d85](https://github.com/CaptTofu/ansible-modules-extras/commit/c069b604ff386f70408d1dc5078e9fb867829d85) as a base for your inventory script.

And don’t repeat the existing docker module behavior with ‘image’ as an obligate parameter.

---

<div class="post-metadata">

**Author:** ![Chris\_Houseknecht](https://avatars.discourse-cdn.com/v4/letter/c/c57346/32.png) [@Chris\_Houseknecht](https://forum.ansible.com/u/Chris_Houseknecht)\
**Post date:** [February 26, 2016, 2:06pm UTC](https://forum.ansible.com/t/docker-modules-roadmap/20565/3 "2016-02-26T14:06:04Z")

</div>

Been working on loose requirements for each modules. Originally had these in an etherpad, but oving to proposals. PRs for the proposal are below. All comments and idea are welcome. And if you’re inclined to help build these, let me know. Planning to start work on docker\_container module today. Would be awesome to have a few of these in the 2.1 release.

docker\_files, docker\_image, docker\_image\_facts:

[https://github.com/ansible/ansible/pull/14666](https://github.com/ansible/ansible/pull/14666)

docker\_container:

[https://github.com/ansible/ansible/pull/14644](https://github.com/ansible/ansible/pull/14644)

---

<div class="post-metadata">

**Author:** ![Kei\_Nohguchi](https://avatars.discourse-cdn.com/v4/letter/k/c57346/32.png) [@Kei\_Nohguchi](https://forum.ansible.com/u/Kei_Nohguchi)\
**Post date:** [February 26, 2016, 3:25pm UTC](https://forum.ansible.com/t/docker-modules-roadmap/20565/4 "2016-02-26T15:25:46Z")

</div>

Hi Chris,

> docker\_files, docker\_image, docker\_image\_facts:
> 
> [https://github.com/ansible/ansible/pull/14666](https://github.com/ansible/ansible/pull/14666)
> 
> docker\_container:
> 
> [https://github.com/ansible/ansible/pull/14644](https://github.com/ansible/ansible/pull/14644)

More than happy to play with it, as I'm one of cutting edge lovers. 🙂

Do you have actual modules in your ansible-module-core repo? I'll clone  
and start play with it, if there are.

I've subscribed your PRs. 🙂

Cheers,

Kei

---

<div class="post-metadata">

**Author:** ![Chris\_Houseknecht](https://avatars.discourse-cdn.com/v4/letter/c/c57346/32.png) [@Chris\_Houseknecht](https://forum.ansible.com/u/Chris_Houseknecht)\
**Post date:** [February 26, 2016, 3:32pm UTC](https://forum.ansible.com/t/docker-modules-roadmap/20565/5 "2016-02-26T15:32:52Z")

</div>

Nothing out there yet. The first iteration of docker\_container will appear between now and Monday. It’ll be rough and incomplete. But it will be started. I’ll update here when it’s available.

–c
