4.3 KiB
common
The purpose of this role is to configure common things on your system.
| GitHub | GitLab | Quality | Downloads | Version |
|---|---|---|---|---|
 |
 |
 |
 |
 |
Example Playbook
This example is taken from molecule/resources/converge.yml and is tested on each push, pull request and release.
---
- name: Converge
hosts: all
become: yes
gather_facts: yes
roles:
- role: robertdebock.common
The machine needs to be prepared in CI this is done using molecule/resources/prepare.yml:
---
- name: Prepare
hosts: all
gather_facts: no
become: yes
roles:
- role: robertdebock.bootstrap
Also see a full explanation and example on how to use these roles.
Role Variables
These variables are set in defaults/main.yml:
---
# defaults file for common
# The selected hostname.
common_hostname: "{{ inventory_hostname }}"
# A list of nameservers to configure.
# common_nameservers:
# - 1.1.1.1
# - 1.0.0.1
# Fill /etc/hosts with all hosts in the play.
common_hosts: "{{ groups.all }}"
# Do you want to reboot on a hostname change?
common_reboot: yes
Requirements
- pip packages listed in requirements.txt.
Status of requirements
The following roles are used to prepare a system. You may choose to prepare your system in another way, I have tested these roles as well.
| Requirement | GitHub | GitLab |
|---|---|---|
| robertdebock.bootstrap |  |
 |
Context
This role is a part of many compatible roles. Have a look at the documentation of these roles for further information.
Here is an overview of related roles:
Compatibility
This role has been tested on these container images:
| container | tags |
|---|---|
| alpine | all |
| amazon | Candidate |
| el | 7, 8 |
| debian | buster, bullseye |
| fedora | all |
| opensuse | all |
| ubuntu | focal, bionic |
The minimum version of Ansible required is 2.10, tests have been done to:
- The previous version.
- The current version.
- The development version.
Exceptions
Some variarations of the build matrix do not work. These are the variations and reasons why the build won't work:
| variation | reason |
|---|---|
| amazonlinux | set hostname: [Errno 2] No such file or directory: '/etc/sysconfig/network' |
If you find issues, please register them in GitHub
License
Apache-2.0
Contributors
I'd like to thank everybody that made contributions to this repository. It motivates me, improves the code and is just fun to collaborate.
Author Information
Please consider sponsoring me.