optional arguments

Use the following optional arguments with the ansible-container command:

-h, --help

Show help message and exit.


Enable debug-level logging for all actions (inside and outside conductor).

--engine ENGINE_NAME

Select your container engine and orchestrator. Valid options are: docker, k8s, openshift. Defaults to docker.


Stops the ‘Z’ option from being added to any volumes that get automatically mounted to the build container. For example, the base path to the project is automatically mounted as /ansible-container:Z.

--project BASE_PATH, -p BASE_PATH

Specify a path to your project. Defaults to the current working directory.


Path to a YAML or JSON formatted file providing variables for Jinja2 template rendering in container.yml. Provide an absolute file path, or a path relative to the project BASE_PATH or relative to project BASE_PATH/ansible. If the file extension is one of ‘yml’ or ‘yaml’, the file will be parsed as YAML. Otherwise, it is parsed as JSON.


Enable “developer mode.” This is mostly useful for working on the ansible-container codebase to speed up testing changes. If you aren’t testing changes to the ansible-container codebase, it’s unlikely you need this option.

Instead of building ansible-container Python source into the conductor container, this option mounts the ansible-container from the host machine for every command. Mounting the source every time means you don’t have to rebuild the conductor container to update the code, speeding up the dev-test-run cycle immensely.