mirror of https://github.com/roles-ansible/ansible_role_epel.git synced 2024-08-16 14:49:49 +02:00

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

ansible-role centos enterprise-linux epel epel-release package rhel role-ansible

Find a file

L3D b018fae6d0 update github actions		2021-03-12 14:47:22 +01:00
.github	update github actions	2021-03-12 14:47:22 +01:00
defaults	improve docs	2020-03-02 15:44:58 +01:00
meta	rpm_key fingerprint is available since ansible 2.9	2020-02-26 14:46:55 +01:00
tasks	Add condition for OS warning	2020-03-02 21:19:49 +01:00
vars	improve docs	2020-03-02 15:44:58 +01:00
.travis.yml	repair travis permissions	2020-03-02 16:22:14 +01:00
LICENSE	Update LICENSE and FOUNDING	2020-02-20 15:42:27 +01:00
README.md	Finalize docs	2020-03-02 21:16:16 +01:00

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