Project: ansible-bender (GitHub Link)

ansible-bender-master
- ansible.cfg
- .packit.yaml
- Makefile
- ansible_bender
  - db.py
  - exceptions.py
  - cli.py
  - builders
    - __init__.py
    - buildah_builder.py
    - base.py
  - schema.py
  - constants.py
  - api.py
  - __main__.py
  - okd.py
  - __init__.py
  - utils.py
  - callback_plugins
    - __init__.py
    - snapshoter.py
  - conf.py
  - core.py
  - builder.py
- LICENSE
- simple-playbook.yaml
- CONTRIBUTING.md
- .gitattributes
- .git_archival.txt
- release-conf.yaml
- CHANGELOG.md
- setup.py
- Vagrantfile
- ansible-bender.spec
- setup.cfg
- README.md
- .fmf
  - version
- tests
  - functional
    - test_buildah.py
    - test_conf.py
    - test_cli.py
    - __init__.py
  - integration
    - test_buildah.py
    - test_conf.py
    - __init__.py
    - test_api.py
    - test_core.py
  - ci.fmf
  - spellbook.py
  - data
    - dont_cache_playbook_pre.yaml
    - v_f.yaml
    - p_w_vars_files.yaml
    - file_caching.yaml
    - playbook_with_unknown_keys.yaml
    - a_bag_of_fun
    - dont_cache_playbook.yaml
    - role.yaml
    - small_basic_playbook.yaml
    - full_conf_pb.yaml
    - non_ex_pb.yaml
    - multiplay.yaml
    - change_layering.yaml
    - buildah_inspect.json
    - pb_wrong_type.yaml
    - roles
      - train
        files
        ticket
        tasks
        main.yml
    - basic_playbook_with_volume.yaml
    - b_p_w_vars.yaml
    - basic_playbook.yaml
    - bad_playbook.yaml
  - __init__.py
  - unit
    - test_utils.py
    - test_buildah.py
    - test_ansibla.py
    - test_cli.py
    - __init__.py
    - test_api.py
    - test_okd.py
  - conftest.py
- .gitignore
- docs
  - Makefile
  - source
    - okd.rst
    - cacheandlayer.rst
    - interface.rst
    - usage.rst
    - index.rst
    - conf.py
    - configuration.rst
    - contributing.rst
    - installation.rst
  - build
    - html
      - interface.html
      - installation.html
      - cacheandlayer.html
      - searchindex.js
      - okd.html
      - usage.html
      - .buildinfo
      - objects.inv
      - configuration.html
      - genindex.html
      - index.html
      - search.html
      - _static
        jquery.js
        basic.css
        pygments.css
        searchtools.js
        documentation_options.js
        language_data.js
        doctools.js
        fonts
        fontawesome-webfont.woff2
        fontawesome-webfont.woff
        fontawesome-webfont.eot
        RobotoSlab-Bold.ttf
        Lato
        lato-bold.woff2
        lato-bolditalic.woff2
        lato-italic.woff2
        lato-regular.woff2
        RobotoSlab
        roboto-slab-v7-bold.woff2
        roboto-slab-v7-regular.eot
        roboto-slab-v7-bold.ttf
        roboto-slab-v7-bold.eot
        roboto-slab-v7-regular.woff
        roboto-slab-v7-bold.woff
        roboto-slab-v7-regular.ttf
        roboto-slab-v7-regular.woff2
        Inconsolata.ttf
        Inconsolata-Bold.ttf
        RobotoSlab-Regular.ttf
        fontawesome-webfont.ttf
        Inconsolata-Regular.ttf
        underscore-1.3.1.js
        js
        theme.js
        modernizr.min.js
        underscore.js
        css
        badge_only.css
        theme.css
      - contributing.html
  - .nojekyll
  - configuration.md
  - requirements.txt
  - index.html
  - md_docs
    - okd.md
    - usage.md
    - configuration.md
    - cacheandlayer.md
    - interface.md
    - contributing.md
    - installation.md
- contrib
  - ab-pod.yml.tmpl
  - pre-setup.yml
  - post-setup.yml
  - okd-template.yml
  - run-in-okd.yml
  - entry.sh
  - check-in-okd.yml
- ci.yaml

ansible-bender

GitHub Release Date PyPI - Status GitHub PyPI - Downloads

This is a tool which 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:

You may be asking: why not ansible-container? Ansible bender is actually heavily inspired by ansible-container: the main distinction is that ansible-container covers the complete lifecycle of a containerized application while ab takes care of image builds only.

Status: ready to be used

Ansible-bender was recently moved to the ansible-community organization. \o/

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: