ansible-role-coller/README.md
Julien Riou cc2db9930b
feat: First release
Signed-off-by: Julien Riou <julien@riou.xyz>
2025-08-22 19:31:43 +02:00

43 lines
1,012 B
Markdown

# ansible-role-coller
Ansible role to manage a [coller](https://git.riou.xyz/jriou/coller) instance.
## Installation
Clone the repository in your local Ansible roles directory:
```
git clone https://git.riou.xyz/jriou/ansible-role-coller.git ~/.ansible/roles/coller
```
See [Storing and finding
roles](https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_reuse_roles.html#storing-and-finding-roles).
## Configuration
See [Variable
precedence](https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_variables.html#ansible-variable-precedence)
to find where you should put your own variables.
Then define at least `coller_db_password` with a strong and secure password,
encrypted using
[ansible-vault](https://docs.ansible.com/ansible/latest/cli/ansible-vault.html).
See list of [default variables](defaults/main.yml).
## Usage
Example of a basic coller.yml playbook:
```yaml
- hosts: coller
roles:
- coller
```
Then run the playbook:
```
ansible-playbook coller.yml
```