Ansible role for installing an AWS CLI (awscli) into a Python3 VirtualEnv.
This role has been tested on Ansible 2.7.0+ against the following Linux Distributions:
- Amazon Linux 2
- CentOS 8
- CentOS 7
- Debian 10
- Fedora 29
- Fedora 30
- Fedora 31
- Ubuntu 18.04 LTS
If you have any problems please create a GitHub issue, I maintain this role in my spare time so I cannot promise a speedy fix delivery.
| Variable | Description | Default Value |
|---|---|---|
awscli_version |
Use a specific version of awscli, eg. 1.16.309. Specify false for latest. |
false |
awscli_install_dir |
Installation directory to put awscli virtual environments. | $HOME/.virtualenvs |
awscli_venv_name |
Name for the currently active awscli Virtualenv. | awscli |
awscli_venv_suffix |
Add a custom suffix to virtualenv. | awscli_version |
awscli_venv_site_packages |
Allow venv to inherit packages from global site-packages. | false |
awscli_install_venv_helper |
Install a venv helper to launch venv executables from a "bin" directory. | true |
awscli_bin_dir |
"bin" directory to install venv-helpers to. | $HOME/bin |
awscli_install_os_dependencies |
Allow role to install OS dependencies. | false |
awscli_python3_path |
Specify a path to a specific python version to use in virtualenv. | NULL |
No dependencies on other roles.
Example playbook for installing to single user:
- hosts: awscli_hosts
roles:
- { role: xanmanning.awscli, awscli_version: 1.16.309 }Example playbook for installing the latest awscli version globally:
---
- hosts: awscli_hosts
become: true
vars:
awscli_install_os_dependencies: true
awscli_install_dir: /opt/awscli/bin
awscli_bin_dir: /usr/bin
awscli_venv_name: current
roles:
- role: xanmanning.awscliYou need to activate the python3 virtual environment to be able to access aws.
This is done as per the below:
source {{ awscli_install_dir }}/{{ awscli_venv_name }}/bin/activateIn the above example global installation playbook, this would look like the following:
source /opt/awscli/bin/current/bin/activate