29 lines
681 B
Markdown
29 lines
681 B
Markdown
# Custom roles guide
|
||
|
||
This repo is designed to be extended by adding new roles under `roles/`.
|
||
|
||
## Role structure
|
||
|
||
Follow the standard Ansible role layout:
|
||
|
||
```
|
||
roles/<role_name>/
|
||
├── defaults/main.yml
|
||
├── handlers/main.yml
|
||
├── tasks/main.yml
|
||
├── templates/
|
||
├── files/
|
||
└── README.md
|
||
```
|
||
|
||
## Where to wire a new role
|
||
|
||
- Add it to the relevant playbook under `playbooks/` (or create a new playbook if it’s a major concern).
|
||
- Prefer tagging the role at inclusion time so `make <feature>` targets can use `--tags`.
|
||
|
||
## Standards (canonical)
|
||
|
||
- `project-docs/standards.md`
|
||
- `project-docs/decisions.md` (add an ADR entry for significant changes)
|
||
|