Update READMEs

This commit is contained in:
2020-11-23 14:45:00 -05:00
parent b9843a5d99
commit e4ccaf4bd9
8 changed files with 105 additions and 35 deletions

View File

@@ -1,24 +1,12 @@
# Ansible
A few simple roles / plays I've been able to piece together in learning how to use Ansible.
A few simple roles / plays I've put together in learning how to use Ansible can be found under their corresponding directories.
Playbooks
- apt-up.yml - Playbook to update servers / groups ad hoc
Examples
- core.yml - Playbook example for using core configuration role
- docker.yml - Playbook example for using docker install role (Debian / Ubuntu)
- hosts - Sample / partially default ansible hosts file
- make-host.yml - Playbook example for using multiple roles together to create a new host
- nginx.yml - Playbook example for using nginx role
- fail2ban.yml - Playbook example for using fail2ban role
- postifx.yml - Playbook example for using postfix role
- bookstack-backup.yml - Playbook example for taking a backup of BookStack
- hexo-backup.yml - Playbook example for taking a backup of Hexo
- hexo-install.yml - Playbook example to install and deploy the Hexo site generator
Roles
- core - Role to configure a new host with basic authentication / package settings
- docker - Role to install docker, docker-compose, configure docker user group (Debian / Ubuntu)
- nginx - Role to install and configure a new nginx webserver on a host
- fail2ban - Role to install and configure fail2ban on a new host
- postfix - Role to install and configure postfix on a new host
- postfix.yml - Playbook example for using postfix role

8
ansible/plays/README.md Normal file
View File

@@ -0,0 +1,8 @@
# Plays
Playbooks
- apt-up.yml - Playbook to update servers / groups ad hoc
- bookstack-backup.yml - Playbook example for taking a backup of BookStack
- hexo-backup.yml - Playbook example for taking a backup of Hexo
- hexo-install.yml - Playbook example to install and deploy the Hexo site generator

View File

@@ -1,11 +1,13 @@
# Roles
Some simple Ansible roles created with `ansible-galaxy init <role> --offline` command
Ansible roles created with `ansible-galaxy init <role> --offline` command
klips/ansible/roles/...
Roles
- core - Role to configure a new host with basic authentication / package settings
- docker - Role to install docker, docker-compose, configure docker user group
- docker - Role to install docker, docker-compose, configure docker user group (Debian / Ubuntu)
- fail2ban - Role to install and configure fail2ban on a new host
- nginx - Role to install and configure a new nginx webserver on a host
- postfix - Role to install and configure postfix on a new host
All of these roles assume you are using the apt package manager, and running a Debian / Ubuntu system.
@@ -13,7 +15,7 @@ All of these roles assume you are using the apt package manager, and running a D
core
------------
A simple role for configuring a set of packages / settings on a new Ubuntu host using Ansible.
A role for configuring a set of packages / settings on a new Ubuntu host using Ansible.
### Packages Added / Configured
@@ -33,19 +35,7 @@ Vim
docker
------------
A simple role for installing Docker and Docker Compose on a new Ubuntu host using Ansible.
nginx
------------
A simple role for installing and configuring nginx on a new Ubuntu host using Ansible. Supports templates for index.html and custom nginx.conf
postfix
------------
A simple role for installing and configuring the postfix MTA on a new Ubuntu host using Ansible. Supports templates for main.cf and custom sasl_passwd
Install and configure Docker and Docker Compose on a new Ubuntu host using Ansible.
fail2ban
@@ -54,3 +44,14 @@ fail2ban
A simple role for installing and configuring fail2ban on a new Ubuntu host using Ansible. Supports templates for jail.local settings and provides a custom filter.d directory copy custom filters to the remote host.
nginx
------------
Install and configure nginx on a new Ubuntu host using Ansible. Supports templates for index.html and custom nginx.conf
postfix
------------
Install and configure the postfix MTA on a new Ubuntu host using Ansible. Supports templates for main.cf and custom sasl_passwd