ansible-bender

ansible-playbook + buildah = a sweet container image

MIT License

Downloads
8.8K
Stars
677
Committers
30

ansible-bender

This tool bends containers using Ansible playbooks and turns them into container images. It has a pluggable builder selection it is up to you to pick the tool which will be used to construct your container image. Right now the only supported builder is buildah. More to come in the future. Ansible-bender (ab) relies on Ansible connection plugins for performing builds.

tl;dr Ansible is the frontend, buildah is the backend.

The concept is described in following blog posts:

Looking for maintainers

This project doesn't have an active maintainer right now that would watch issues daily.

If you are a user of ansible-bender and are familiar with Python, please consider becoming a maintainer.

Features

  • You can build your container images with buildah as a backend.
  • Ansible playbook is your build recipe.
  • You are able to set various image metadata via CLI or as specific Ansible vars:
    • working directory
    • environment variables
    • labels
    • user
    • default command
    • exposed ports
  • You can do volume mounts during build.
  • Caching mechanism:
    • Every task result is cached as a container image layer.
    • You can turn this off with --no-cache.
    • You can disable caching from a certain point by adding a tag no-cache to a task.
  • You can stop creating new image layers by adding tag stop-layering to a task.
  • If an image build fails, it's committed and named with a suffix -[TIMESTAMP]-failed (so
    you can take a look inside and resolve the issue).
  • The tool tries to find python interpreter inside the base image.
  • You can push images you built to remote locations such as:
    • a registry, a tarball, docker daemon, ...
    • podman push is used to perform the push.

Documentation

You can read more about this project in the documentation:

Package Rankings
Top 9.59% on Alpine-edge
Top 5.47% on Pypi.org
Top 30.0% on Conda-forge.org
Badges
Extracted from project README's
PyPI version Documentation
Related Projects