sukaato-ansible/README.md

SUKAATO Ansible

This repository is for automating the management of the configuration of, and the provisioning of software for, my virtual private servers using Ansible. This repository is especially useful for setting up the virtual private server(s) that is(/are) to host and serve my website(s). It is also meant to be useful for provisioning of software and the configuration of that software for personal or household LAN computers.

Installation and Use

All files with file extension .example must be converted to YAML files that follow their semantics and naming (or follow the minimum bare "namespace" nesting for dictionaries or lists thereof) prior to executing any given play or task. For more on semantics and naming conventions see the mini-documentation.

Important

Keep in mind files with the .example extension may also be present recursively under given role directories (i.e., under path ${SUKAATO_ANSIBLE_PROJECT}/.ansible/roles/**/**/).

Mini-Documentation

Available Roles

To surmise, the available or planned roles are as follows (and are all found under ${SUKAATO_ANSIBLE_PROJECT}/.ansible/roles):

role name	purpose
lockdown	creating initial sudo-capable user, disabling system/SSH root login, setting up key-based SSH authentication, transferring GPG keys, configuring environment, hardening system
bootstrap	installing programming language and server/container packages, installing extra system managers and essential utilities, configuring and running servers/services/containers
postinstall	installing and configuring custom sets of packages, largely non-server related and not essential

TBC This README is yet unfinished. Check back later.