The ansible-container project is now officially deprecated. We will no longer be maintaining this repo or accepting any issues or pull requests.
The ansible-container project did two things, broadly speaking: it built containers, and it deployed containers to Kubernetes. Now there are new successor projects that perform these tasks.
For people who have been using ansible-container to build containers, we recommend using the ansible-bender project: https://github.com/ansible-community/ansible-bender
For people who have been using ansible-container to deploy containers to Kubernetes, we recommend using Ansible Operators:
Thanks to all those who have used and contributed to ansible-container.
Original README below
Ansible Container is a tool for building Docker images and orchestrating containers using Ansible playbooks.
How it works
Use Ansible Container to manage the container lifecycle from development, through testing, to production:
Creates files in the current directory to get you started. Read the comments, and edit to suit your needs.
Downloads Ansible-Container-ready roles from Ansible Galaxy, and installs them in your project.
Creates images from your Ansible playbooks.
Launches the containers specified in the orchestration document, container.yml, for testing the built images. The format of container.yml is nearly identical to Docker Compose.
Pushes the project's container images to a registry of your choice, and generates a playbook capable of deploying the project on a supported cloud provider.
Install using pip, the Python package manager:
$ sudo pip install "ansible-container[docker,openshift]"
Or, to install without root privileges, use virtualenv to first create a Python sandbox:
$ virtualenv ansible-container $ source ansible-container/bin/activate $ pip install "ansible-container[docker,openshift]"
For more details, prerequisite, and instructions on installing the latest development release, please view our Installation Guide.
For examples and a quick tour of Ansible Container visit Getting Started at our docs site.
Visit the Ansible Container Demo for a complete walk-through of managing an application from development through cloud deployment.
- Visit Community Information and Contributing for all kinds of ways to contribute to and interact with the project. We welcome your feedback and ideas!
- Review CONTRIBUTORS.md, if you're considering submitting code.
- Join the mailing list
- Open an issue
- Join the #ansible-container channel on irc.freenode.net.
- The develop branch is the release actively under development.
- The master branch corresponds to the latest stable release available at PyPi.
- Submit pull requests for bug fixes and new features to develop.
- View the roadmap for a list of features currently under development.
- Contributors welcome! Get started by reviewing CONTRIBUTORS.md.
View AUTHORS for a list contributors to Ansible Container. Thanks everyone!
Ansible Container is an Ansible by Red Hat sponsored project.