Ansible Version Manager (AVM) is a tool to manage multi Ansible installation by creating a python virtual environment for each version.

• Running multiple version of Ansible on the same host.
• Using the development version of ansible for testing and using stable version for production.
• Make your CI run multiple versions for testing i.e. travis, concourse, jenkins, ... or test-kitchen or molecule.
• Create a wrapper script to manage Ansible within your teams and make upgrading roll back easier for many users with different OS and shells.
• If you need add python packages to and make it accessible to Ansible without effecting your global python installation. i.e. boto, dnspython, netaddr or others

• Change in variable names
• Stopped using bash arrays i.e. ANSIBLE_VERSIONS[0] to be more Posix and use flat variables i.e. ANSIBLE_VERSIONS_0

For more info check Setup variables

You have two options using a setup script or command to install

Create a wrapper script this would be useful for CI or if you want your team to have unified installation.

#!/bin/sh set -e # What version of AVM setup to use export AVM_VERSION="v1.0.0" ## Install Ansible 1.9.6 using pip and label it 'v1.9' export ANSIBLE_VERSIONS_0="1.9.6" export INSTALL_TYPE_0="pip" export ANSIBLE_LABEL_0="v1.9" ## Install Ansible 2.2.3.0 using pip and label it 'v2.2' export ANSIBLE_VERSIONS_1="2.2.3.0" export INSTALL_TYPE_1="pip" export ANSIBLE_LABEL_1="v2.2" ## Install Ansible 2.3.1.0 using pip and label it 'v2.3' export ANSIBLE_VERSIONS_2="2.3.1.0" export INSTALL_TYPE_2="pip" export ANSIBLE_LABEL_2="v2.3" ## Install Ansible from devel using git and label it 'devel' export ANSIBLE_VERSIONS_2="devel" export INSTALL_TYPE_2="git" export ANSIBLE_LABEL_2="devel" # Whats the default version export ANSIBLE_DEFAULT_VERSION="v1.9" ## Create a temp dir to download avm avm_dir="$(mktemp -d 2> /dev/null || mktemp -d -t 'mytmpdir')" git clone https://github.com/ahelal/avm.git "${avm_dir}" > /dev/null 2>&1 ## Run the setup /bin/sh "${avm_dir}/setup.sh" exit 0

You would need first to install avm

git clone https://github.com/ahelal/avm.git cd avm ./setup.sh

then you can use the avm cli to install

# Install stable release (defaults to pip) avm install --version 2.2.0.0 --label production # Install development release avm install --version devel --label dev --type git # if you have some python lib to install in the virtual env you can also add python requirements.txt file avm install --version 2.0.0.0 --label legacy --requirements /path/to/requirements.txt

Once install you can use avm the cli to switch between version. for more info run avm --help

Usage: avm info avm list avm path <version> avm use <version> avm activate <version> avm install (-v version) [-t type] [-l label] [-r requirements] Options: info Show ansible version in use list List installed versions path <version> Print binary path of specific version use <version> Use a <version> of ansible activate <version> Activate virtualenv for <version> 

If you are using Setup wrapper script you can override any of the following variables in your script.

Currently tested under

• OSX
• Ubuntu 14.04, 16.04
• Alpine 3.4 (early support)

• bash
• dash
• zsh
• busybox ash

Experimental support for Alpine in docker

if your installing for non root user you require

apk add sudo echo "auth sufficient pam_rootok.so" > /etc/pam.d/su

if your creating an image that does not have python or gcc you can do a cleanup at the end

apk del build-dependencies

Setup verbosity could be empty or v, vv or vvv

i.e. AVM_VERBOSE="vv" your_setup.sh

v : Show verbose messages, but mute stdout, stderr vv : Show verbose messages and stdout, stderr vvv : Show verbose messages, stdout, stderr and set -x

By default avm uses the AVM_VERSION to download and checkout that branch. if you want to debug and change the script you can use AVM_VERSION=local to use a local version of avm.

License (MIT)

Your contribution is welcome.