ansible_role_epel/README.md

role_install-epel-release

Ansible role to install the Extra Packages for Enterprise Linux (EPEL) - Repository on RHEL and centos.

What do we do here?

• First we read the variables you configured and our default values.
• If enabled (default to false), we do a simple version-check that will validate that you never run a older version of this role after you run this role before.
• We validate that the GPG key of the EPEL repo for your distribution release is installed and match the fingerprint in the config.
• We install the epel repo from a remote URL.

example useage of this role

You can either use this role via ansible galaxy or by downloading this role manually.

ansible galaxy: install this role

ansible-galaxy install do1jlr.epel

ansible-galaxy: example playbook

---
- name: install epel release
  hosts: srv01.example.com
  roles:
    - do1jlr.epel

manual download role

# download to your roles directory
git clone https://github.com/roles-ansible/role_install-epel-release.git

manual example playbook

---
- name: Install epel release
  hosts: srv02.example.com
  tags:
   - epel
  vars:
    submodules_versioncheck: true
  roles:
    - role_install-epel-release

variables and configuration

Here a our default values you can overwrite:

# do we want a simple versionscheck? (true is recomended)
submodules_versioncheck: false

# epel repo
epel_repo:
  url: "https://dl.fedoraproject.org/pub/epel/epel-release-latest-{{ ansible_distribution_major_version }}.noarch.rpm"
  gpg_key_url: "https://dl.fedoraproject.org/pub/epel/RPM-GPG-KEY-EPEL-{{ ansible_distribution_major_version }}"
  gpg_key_path: "/etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-{{ ansible_distribution_major_version }}"
  fingerprint:
    '6': "8C3B E96A F230 9184 DA5C 0DAE 3B49 DF2A 0608 B895"
    '7': "91E9 7D7C 4A5E 96F1 7F3E 888F 6A2F AEA2 352C 64E5"
    '8': "94E2 79EB 8D8F 25B2 1810 ADF1 21EA 45AB 2F86 D6A1"

Testing

This role is tested with these github-action tests for different versions of centos. Linting is tested via travis-ci. If you want to find out more about our tests, please have a look at the github marketplace.

test status	Github Marketplace
	.travis.yml
	ansible test with centos:latest
	ansible test with centos 8
	ansible test with centos 7
	ansible test with centos 6
	ansible linting test