homelab/ansible-collection
0
0
Fork 0
Code Issues 1 Pull requests 1 Releases 159 Activity Actions
A collection of Ansible roles to manage the various tasks in my homelab.
290 commits 3 branches 214 tags 739 KiB
Find a file
commit-and-tag 3084585f2a
All checks were successful
Create Release / Create Release (push) Successful in 4s
Details
chore(release): 3.1.1
2024-11-24 00:45:23 +00:00
.forgejo/workflows chore(deps): update actions/forgejo-release action to v2.4.0 2024-11-18 22:33:24 +00:00
meta feat(caddy): add more useable caddy role & instructions 2024-11-23 18:21:36 -06:00
roles fix(caddy): add docs, rate limiting example, fixed perms 2024-11-23 18:45:15 -06:00
.renovaterc.json5 chore: consistency sweeping with host-* repos 2024-06-20 08:19:46 -05:00
galaxy.yml chore(release): 3.1.1 2024-11-24 00:45:23 +00:00
LICENSE.md chore: consistency sweeping with host-* repos 2024-06-20 08:19:46 -05:00
README.md fix(caddy): add docs, rate limiting example, fixed perms 2024-11-23 18:45:15 -06:00

README.md

Ansible Collection auengun.homelab

A collection of Ansible roles to manage the various tasks in my homelab.

Collection Installation

Python/Poetry Dependencies

TODO: Document these better in version control with renovate.

If using Poetry, this is an example pyproject.toml snippet to install the required Python dependencies.

[tool.poetry.dependencies]
python = "^3.10"
ansible = "^9.2"
ansible-core = "^2.16"
jmespath = "^1.0.1"
passlib = "^1.7.4"

Ansible Galaxy - requirements.yml

Add the following snippet to Ansible Galaxy's requirements.yml file.

collections:
- name: ssh://git@git.auengun.net/homelab/ansible-collection.git
  type: git
  # Note: it's better to pin to a commit than main.
  version: main

Then install using ansible-galaxy.

ansible-galaxy collection install -r requirements.yml

Roles

auengun.homelab.caddy

A systemd service wrapping a custom caddy binary enabling some rate limiting and other features for my common services.

Read the README.md for usage and configuration details.

auengun.homelab.common

A set of shifting common tasks for bootstrapping and setting up the many physical and virtual machines in my homelab.

Read the README.md for usage and configuration details.

auengun.homelab.dcaass

Wraps a docker-compose.yml with a systemd service and easy user overrides of the .yml config.

Read the README.md for usage and configuration details.

auengun.homelab.cron_healthcheck_script

Quickly wrap a basic shell script with a crontab schedule and Healthchecks.io alert.

Read the README.md for usage and configuration details.