Skip to content

Evolix/ansible-roles

Folders and files

NameName
Last commit message
Last commit date

Latest commit

71e8b4e · Jan 31, 2025
Jun 1, 2023
Apr 17, 2024
Jul 3, 2023
Nov 29, 2024
Jan 24, 2025
Nov 8, 2024
Sep 23, 2024
Jan 28, 2025
Mar 20, 2023
Sep 6, 2024
Jan 3, 2025
Mar 20, 2023
Mar 20, 2023
Oct 4, 2024
Jul 30, 2024
Feb 7, 2024
Mar 20, 2023
Oct 30, 2024
Oct 2, 2024
Aug 16, 2024
Jan 7, 2025
Jan 23, 2025
Jan 31, 2025
Dec 20, 2024
Jan 24, 2025
Oct 15, 2024
Dec 17, 2024
Nov 20, 2024
Nov 19, 2024
Oct 30, 2024
Mar 30, 2023
Oct 17, 2024
Sep 26, 2023
Jul 25, 2023
Nov 19, 2024
Jun 17, 2024
Jan 31, 2025
Feb 7, 2024
Jan 23, 2025
Nov 29, 2024
Jun 17, 2024
Jan 9, 2025
Jun 5, 2024
Jan 14, 2025
Nov 19, 2024
Nov 14, 2017
Dec 3, 2024
Jan 31, 2025
Dec 18, 2023
Jun 28, 2023
Jan 29, 2025
Jun 28, 2023
Jan 23, 2025
Jan 15, 2025
Mar 20, 2023
Mar 20, 2023
Jul 25, 2023
Dec 30, 2024
Jun 12, 2024
Mar 20, 2023
Jul 20, 2023
Nov 19, 2024
Dec 18, 2024
Jul 25, 2023
Jun 5, 2023
Jan 9, 2025
Jun 12, 2023
Apr 17, 2024
Nov 19, 2024
Dec 24, 2024
Sep 5, 2024
Nov 19, 2024
Oct 12, 2023
Nov 19, 2024
Jul 3, 2023
Feb 7, 2024
Sep 9, 2024
Dec 5, 2024
Oct 17, 2024
Jun 28, 2023
Dec 26, 2024
Jun 28, 2023
Jan 6, 2025
Jan 20, 2025
Dec 19, 2023
Sep 26, 2023
Jun 28, 2023
May 13, 2024
Jan 24, 2025
Dec 27, 2022
Jun 15, 2023
Oct 14, 2023
Jan 31, 2025
Dec 20, 2024
Jan 5, 2017
Feb 4, 2021
Mar 20, 2018
Jun 11, 2018

Repository files navigation

Ansible-roles

A repository for Ansible roles used by Evolix on Debian GNU/Linux 9 (stretch) servers. Few roles are also be compatible with Debian GNU/Linux 8 (jessie) servers.

It contains only roles, everything else is available at https://gitea.evolix.org/evolix/ansible-public

Branches

The stable branch contains roles that we consider ready for production.

The unstable branch contains not sufficiently tested roles (or evolutions on existing roles) that we don't consider ready for production yet.

Many feature branches may exist in the repository. They represent "work in progress". They may be used, for testing purposes.

Install and usage

First, check-out the repository :

$ cd ~/GIT/
$ git clone https://gitea.evolix.org/evolix/ansible-roles

Then, add its path to your ansible load path :

$ vim ~/.ansible.cfg
[defaults]
roles_path = $HOME/GIT/ansible-roles

Then, include roles in your playbooks :

- hosts: all
  gather_facts: yes
  become: yes
  roles:
    - etc-git
    - evolinux-base

Contributing

Contributions are welcome, especially bug fixes and "ansible good practices". They will be merged in if they are consistent with our conventions and use cases. They might be rejected if they introduce complexity, cover features we don't need or don't fit "style".

Before starting anything of importance, we suggest contacting us to discuss what you'd like to add or change.

Our conventions are available in the "ansible-public":https://gitea.evolix.org/evolix/ansible-public repository, in the CONVENTIONS.md file.

All modifications should be documented in the CHANGELOG file, to help review releases. We encourage atomic commits, on a single role, and with the CHANGELOG in the same commit.

Workflow

The ideal and most typical workflow is to create a branch, based on the "unstable" branch. The branch should have a descriptive name (a ticket/issue number is great). The branch can be treated as a pull-request or merge-request. It should be propery tested and reviewed before merging into "unstable".

Changes that don't introduce significant changes — or that must go faster that the typical workflow — can be commited directly into "unstable".

Hotfixes, can be prepared on a new branch, based on "stable" or "unstable" (to be decided by the author). When ready, it can be merged back to "stable" for immediate deployment and to "unstable" for proper backporting.

Other workflow are not forbidden, but should be discussed in advance.