Installation
Requirements
To build images, you must install a containerization tool - either
podman
ordocker
- as well as theansible-builder
Python package.The
--container-runtime
option must correspond to the containerization tool you use.ansible-builder
version3.x
requires Python3.9
or higher.
Install from PyPI
$ pip3 install ansible-builder
Note
An alternative approach to installing ansible-builder
is using the ansible-dev-tools
package. Ansible Development Tools (ADT) is a single Python package that includes all necessary tools to set up a development environment, generate new collections, build and test the content.
# This also installs ansible-core if it is not already installed
$ pip3 install ansible-dev-tools
Install from Source
To install from the mainline development branch:
$ pip3 install https://github.com/ansible/ansible-builder/archive/devel.zip
To install from a specific tag or branch, replace <ref>
in the following example:
$ pip3 install https://github.com/ansible/ansible-builder/archive/<ref>.zip