Skip to main content

ansible-bender

PyPI version GitHub Release Date PyPI - Status GitHub PyPI - Downloads

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:

Metadata

Release files for ansible-bender 0.10.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ansible-bender 0.10.1
File Size Uploaded
ansible-bender-0.10.1.tar.gz 6.8 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for ansible-bender 0.10.1
File Interpreter ABI Platform
ansible_bender-0.10.1-py2.py3-none-any.whl Python 3, Python 2 none any Details

Total release size: 6.8 MB

Release files / ansible-bender-0.10.1.tar.gz

Download URL ansible-bender-0.10.1.tar.gz
Size 6.8 MB
Tags Source
SHA-256 checksum
How to use checksums
2b2786e870106e22e17123b8cd6fa900ee7a72f6fbefbf8bd57aaee909c95089
BLAKE2b-256 checksum
How to use checksums
19d521a2f32d2fcd76dd2064b697b5fc40ab4a2b3cd1cf3128e23be6fe09c776
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.11.1

Release files / ansible_bender-0.10.1-py2.py3-none-any.whl

Download URL ansible_bender-0.10.1-py2.py3-none-any.whl
Size 40.0 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
717fd6200ec079cab7c01d7c494d35d149b113ca2222928d572741ad0433b8b0
BLAKE2b-256 checksum
How to use checksums
bfb1af4d50bbe34a7e91823adc40bff918a6b331235ea68579a5b8e814ec6ce9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.11.1

Release history Release notifications | RSS feed

This release

0.10.1 This release

2 release files

0.9.0

2 release files

0.8.1

2 release files

0.8.0

2 release files

0.7.0

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.3

2 release files

0.5.2

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.1

2 release files

0.2.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page