Skip to content

Commit 5f245c1

Browse files
tomy0000000claude
andauthored
📖 [docs][ansible] Add README (#91)
https://claude.ai/code/session_019mL7JrivCV6PskSdt7TMhP --------- Co-authored-by: Claude <noreply@anthropic.com>
1 parent 690920c commit 5f245c1

1 file changed

Lines changed: 22 additions & 0 deletions

File tree

pkg/ansible/README.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# `ansible`
2+
3+
Deploys Ansible configuration and a starter inventory file into `$HOME`.
4+
5+
## Installs
6+
7+
This package does not install Ansible — it only manages configuration. Install
8+
Ansible separately (e.g. `pip install ansible` or via your OS package manager).
9+
10+
## Configures
11+
12+
- `~/.ansible.cfg` (stow) — sets `inventory = ~/.ansible/hosts`,
13+
`gathering = explicit`, and `nocows = True`
14+
- `~/.ansible/hosts` (stow) — starter inventory template with a placeholder
15+
group and default `ansible_user` / `ansible_python_interpreter` vars
16+
17+
## Notes
18+
19+
- Edit `~/.ansible/hosts` to replace the `name`/`ip.or.hostname` placeholder
20+
with real hosts before running any playbooks.
21+
- `gathering = explicit` means facts are only collected when explicitly
22+
requested, which speeds up playbook runs.

0 commit comments

Comments
 (0)