Ansible Role - Ansible
Go to file
Jeff Geerling 8c85339f21 A wee bit of modernization. 2024-01-24 21:59:18 -06:00
.github A wee bit of modernization. 2024-01-24 21:59:18 -06:00
defaults Fixes for epel repo name, and allow to specify a pip executable name (#25) 2023-04-27 14:19:21 -05:00
meta Remove official support for RHEL. Rocky/Alma/Stream support is best-effort. 2023-06-23 10:55:50 -05:00
molecule/default Make local dev with molecule a little easier. 2024-01-24 21:47:54 -06:00
tasks Fixes for epel repo name, and allow to specify a pip executable name (#25) 2023-04-27 14:19:21 -05:00
.ansible-lint Make ansible-lint work again. 2021-02-22 16:12:10 -06:00
.gitignore Make ansible-lint work again. 2021-02-22 16:12:10 -06:00
.yamllint Stale bot is now Stale GitHub Action. 2023-07-10 17:47:23 -05:00
LICENSE Add a LICENSE file for MIT license. [ci skip] 2017-03-31 11:23:00 -05:00
README.md Fixes for epel repo name, and allow to specify a pip executable name (#25) 2023-04-27 14:19:21 -05:00

README.md

Ansible Role: Ansible

CI

An Ansible Role that installs Ansible on Linux servers.

Requirements

If using on a RedHat/CentOS/Rocky Linux-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.

ansible_install_pip_extra_args: ''

If ansible_install_method is set to pip, the extra arguments to be given to pip are listed here. If not set, no extra arguments are given.

ansible_pip_executable: ''

if ansible_install_method is set to pip, this is the path to the pip executable, in case your platform doesn't find the right name.

ansible_epel_repo_name: 'epel'

if ansible_install_method is set to package and you are on a RHEL machine, and your local satellite server admins decided to name the epel repository something other than epel, this variable gives you the opportunity to provide the right name.

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"
    ansible_install_pip_extra_args: "--user"
  roles:
    - role: geerlingguy.pip
    - role: geerlingguy.ansible

License

MIT / BSD

Author Information

This role was created in 2014 by Jeff Geerling, author of Ansible for DevOps.