ansible-playbooks

Ansible playbook for my home lab.

RunMe Playbook

This and other read-me files in this repo are RunMe Playbooks.

Use this playbook step/task to update the RunMe CLI.

If you don't have RunMe installed, you'll need to copy/paste the command. :)

go install github.com/stateful/runme/v3@v3

Setup command auto-completion:

if [[ -d ~/.bash_libs.d ]]; then
    runme completion bash > ~/.bash_libs.d/19.00-completion-runme.sh
    printf "Don't forget to run: %s\n" "source ~/.bash_libs.d/19.00-completion-runme.sh"
else
    runme completion bash >> ~/.bash_completion_runmme.sh
    printf "%s\n" "source ~/.bash_completion_runmme.sh" >> ~/.bashrc
    printf "Don't forget to run: %s\n" "source ~/.bashrc"
fi

Install Playbook dependencies:

go install github.com/keewek/ansible-pretty-print@latest
go install github.com/charmbracelet/gum@latest
go install github.com/mikefarah/yq/v4@latest

Dev Container

This project has a dev-container to make it easier to run ansible commands from any workstation, it just needs Docker and the Dev Container CLI installed to get setup to run ansible playbooks.

To install the Dev Containers CLI:

npm install -g @devcontainers/cli

The rest of the Dev Container notes are located in DEVCONTAINER.md.

Ansible

The Ansible notes are located in the file ANSIBLE.md.