Metadata-Version: 2.1
Name: ansible-bender
Version: 0.8.2.dev24+geb9a06d
Summary: A tool which builds container images using Ansible playbooks
Home-page: https://github.com/TomasTomecek/ansible-bender
Author: Tomas Tomecek
Author-email: tomas@tomecek.net
License: MIT
Description: # ansible-bender
        [![PyPI version](https://badge.fury.io/py/ansible-bender.svg)](https://badge.fury.io/py/ansible-bender)
        ![GitHub Release Date](https://img.shields.io/github/release-date/ansible-community/ansible-bender?label=Latest%20release)
        ![PyPI - Status](https://img.shields.io/pypi/status/ansible-bender)
        ![GitHub](https://img.shields.io/github/license/ansible-community/ansible-bender)
        ![PyPI - Downloads](https://img.shields.io/pypi/dm/ansible-bender)
        
        This is a tool which bends containers using
        [Ansible](https://github.com/ansible/ansible)
        [playbooks](https://docs.ansible.com/ansible/latest/user_guide/playbooks.html)
        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](https://github.com/containers/buildah).
        [More](http://github.com/ansible-community/ansible-bender/issues/25) [to
        come](http://github.com/ansible-community/ansible-bender/issues/26) in the future.
        Ansible-bender (ab) relies on [Ansible connection
        plugins](https://docs.ansible.com/ansible/2.6/plugins/connection.html) for
        performing builds.
        
        tl;dr Ansible is the frontend, buildah is the backend.
        
        The concept is described in following blog posts:
        * [Building containers with buildah and ansible](https://blog.tomecek.net/post/building-containers-with-buildah-and-ansible/).
        * [Ansible and Podman Can Play Together Now](https://blog.tomecek.net/post/ansible-and-podman-can-play-together-now/).
        
        You may be asking: why not
        [ansible-container](https://github.com/ansible/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](https://github.com/containers/libpod/blob/master/docs/podman-push.1.md) is used to perform the push.
        
        
        ## Documentation
        
        You can read more about this project in the documentation:
        * [Documentation home](https://ansible-community.github.io/ansible-bender/build/html/index.html)
        * [Interface](https://ansible-community.github.io/ansible-bender/build/html/interface.html)
        * [Installation](https://ansible-community.github.io/ansible-bender/build/html/installation.html)
        * [Configuration](https://ansible-community.github.io/ansible-bender/build/html/configuration.html)
        * [Usage](https://ansible-community.github.io/ansible-bender/build/html/usage.html)
        * [Caching and Layering mechanism](https://ansible-community.github.io/ansible-bender/build/html/cacheandlayer.html)
        * [Contribution guide](https://ansible-community.github.io/ansible-bender/build/html/contributing.html)
        * [Ansible-bender in OKD](https://ansible-community.github.io/ansible-bender/build/html/okd.html)
        
Keywords: ansible,containers,linux,buildah
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Software Development
Classifier: Topic :: Utilities
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: testing
