infrastructure/mono-infrastructure
7
0
Fork 0
mirror of https://github.com/rocky-linux/infrastructure synced 2024-11-28 16:06:28 +00:00
Code Issues Projects Releases Wiki Activity

update readme for ansible

Browse Source
This commit is contained in:
nazunalika 2020-12-11 03:30:37 -07:00
parent 1f0b0b6cae
commit 3ab07302dd
1 changed files with 11 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
ansible/README.md
View File

@ -36,8 +36,11 @@ Loosely copied from the CentOS ansible infrastructure. This structure is represe
What each folder represents What each folder represents
``` ```
files -> As the name implies, non-templated files go here files -> As the name implies, non-templated files go here. Files that are
group_vars -> Group Variables go here if they are not fulfilled in an inventory dropped somewhere on the file system should be laid out in a way
that represents the file system (eg. ./etc/sysconfig/)
group_vars -> Group Variables go here if they are not fulfilled in an inventory.
Recommended that group_vars be used over inventory vars.
host_vars -> Host variables go here host_vars -> Host variables go here
inventory -> All static inventories go here inventory -> All static inventories go here
roles -> Custom roles can go here roles -> Custom roles can go here
@ -51,21 +54,24 @@ vars -> Global variables that are called with vars_files go here. This
``` ```
init-* -> Starting infrastructure playbooks that run solo or import other init-* -> Starting infrastructure playbooks that run solo or import other
playbooks that start with import- playbooks that start with import-
adhoc -> These playbooks are one-off playbooks that can be used on the CLI or
in AWX. These are typically for basic tasks.
import -> Playbooks that should be imported from the top level playbooks import -> Playbooks that should be imported from the top level playbooks
role-* -> These playbooks call roles specifically for infrastructure tasks. role-* -> These playbooks call roles specifically for infrastructure tasks.
Playbooks that do not call a role should be named init or adhoc based Playbooks that do not call a role should be named init or adhoc based
on their usage. on their usage.
adhoc -> These playbooks are one-off playbooks that can be used on the CLI or
in AWX
``` ```
## Designing Playbooks ## Designing Playbooks
### Pre flight and post flight ### Pre flight and post flight
At a minimum, there should be `pre_tasks` and `post_tasks` that can judge whether ansible has been can or has been run on a system. Some playbooks will not necessarily need this (eg if you're running an adhoc playbook to create a user). But operations done on a host should at least have these in the playbook. At a minimum, there should be `pre_tasks` and `post_tasks` that can judge whether ansible has been can or has been run on a system. Some playbooks will not necessarily need this (eg if you're running an adhoc playbook to create a user). But operations done on a host should at least have these in the playbook, with an optional handlers include.
``` ```
handlers:
- include: handlers/main.yml
pre_tasks: pre_tasks:
- name: Check if ansible cannot be run here - name: Check if ansible cannot be run here
stat: stat:
@ -87,8 +93,6 @@ At a minimum, there should be `pre_tasks` and `post_tasks` that can judge whethe
state: touch state: touch
``` ```
If you need to use handlers, you will need to include them in the playbook.
### Roles ### Roles
If you are using roles that are not part of this repository in the `roles` directory, you will need to list them in the `requirements.yml`. For example, we use the IPA role. If you are using roles that are not part of this repository in the `roles` directory, you will need to list them in the `requirements.yml`. For example, we use the IPA role.