40 lines
1.7 KiB
Markdown
40 lines
1.7 KiB
Markdown
# Ansible Collection - `dede.common`
|
||
```
|
||
_ _
|
||
__| | ___ __| | ___ ___ ___ _ __ ___ _ __ ___ ___ _ __
|
||
/ _` |/ _ \/ _` |/ _ \ / __/ _ \| '_ ` _ \| '_ ` _ \ / _ \| '_ \
|
||
| (_| | __/ (_| | __/| (_| (_) | | | | | | | | | | | (_) | | | |
|
||
\__,_|\___|\__,_|\___(_)___\___/|_| |_| |_|_| |_| |_|\___/|_| |_|
|
||
```
|
||
|
||
this ansible collection primarily aims to provide common roles that i've been building
|
||
for either my home or the wululu web network and systems.
|
||
by publishing it i hope it can be useful for anyone looking for inspiration
|
||
or even roles ready-to-go.
|
||
please mind that everything in this collection mainly focuses debian as a server operating system.
|
||
thus i will not add features specific to other operating systems unless i really need to.
|
||
if you have any questions or suggestions feel free to get in touch with me.
|
||
|
||
## contents
|
||
|
||
### roles
|
||
* **test** – a simple test role which runs a `debug` task printing 'hello world'
|
||
* **locale_config** – role to configure system locale and language settings [🠞README](roles/locale_config/README.md)
|
||
* **docker** – a docker install role to install docker-ce engine [🠞README](roles/docker/README.md)
|
||
|
||
### playbooks
|
||
* **test_connection.yml** – a playbook to test ansible and connectivity by running the `test` and the role
|
||
|
||
## usage
|
||
to use a **playbook** provided with this collection you can use `import_playbook`:
|
||
```yaml
|
||
- ansible.builtin.import_playbook: dede.common.test_connection.yml
|
||
```
|
||
|
||
to use a **role** provided with this collection just reference it using the collection name as a prefix:
|
||
```yaml
|
||
- hosts: all
|
||
roles:
|
||
- dede.common.test
|
||
```
|