52 lines
1.6 KiB
Markdown
52 lines
1.6 KiB
Markdown
# Ansible Role: Ansible
|
|
|
|
[![Build Status](https://travis-ci.org/geerlingguy/ansible-role-ansible.svg?branch=master)](https://travis-ci.org/geerlingguy/ansible-role-ansible)
|
|
|
|
An Ansible Role that installs Ansible on Linux servers.
|
|
|
|
## Requirements
|
|
|
|
If using on a RedHat/CentOS-based host, make sure you've added the EPEL repository (it can easily be installed by including the `geerlingguy.repo-epel` role on Ansible Galaxy).
|
|
|
|
## Role Variables
|
|
|
|
Available variables are listed below, along with default values (see `defaults/main.yml`):
|
|
|
|
ansible_install_method: package
|
|
|
|
Whether to install Ansible via the system `package` manager (`apt`, `yum`, `dnf`, etc.), or via `pip`. If set to `pip`, you need to make sure Pip is installed prior to running this role. You can use the `geerlingguy.pip` module to install Pip easily.
|
|
|
|
ansible_install_version_pip: ''
|
|
|
|
If `ansible_install_method` is set to `pip`, the specific Ansible version to be installed via Pip. If not set, the latest version of Ansible will be installed.
|
|
|
|
## Dependencies
|
|
|
|
None.
|
|
|
|
## Example Playbook
|
|
|
|
Install from the system package manager:
|
|
|
|
- hosts: servers
|
|
roles:
|
|
- role: geerlingguy.ansible
|
|
|
|
Install from pip:
|
|
|
|
- hosts: servers
|
|
vars:
|
|
ansible_install_method: pip
|
|
ansible_install_version_pip: "2.7.0"
|
|
roles:
|
|
- role: geerlingguy.pip
|
|
- role: geerlingguy.ansible
|
|
|
|
## License
|
|
|
|
MIT / BSD
|
|
|
|
## Author Information
|
|
|
|
This role was created in 2014 by [Jeff Geerling](https://www.jeffgeerling.com/), author of [Ansible for DevOps](https://www.ansiblefordevops.com/).
|