docs(ansible): Document basic functionality

ansible/group_vars/all/vars.yml.example

@@ -0,0 +1 @@
+ansible_user: 'root'

ansible/hosts.yml.example

@@ -0,0 +1,8 @@
+all:
+  children:
+    groupone:
+      hosts: 
+        fully.qualified.domain.name:
+    grouptwo:
+      hosts:
+        anotherfully.qualified.domain.name

ansible/playbook.yml

@@ -0,0 +1,4 @@
+- name: 'Upgrade packages and reboot where needed'
+  hosts: all
+  roles:
+    - '20-common-40-package-upgrades'

ansible/roles/20-common-40-package-upgrades/tasks/40-packages.yml

@@ -0,0 +1,17 @@
+- name: 'Upgrade the OS (apt-get dist-upgrade)'
+  ansible.builtin.apt:
+    update_cache: 'yes'
+    upgrade: 'dist'
+
+
+
+- name: 'Check if reboot required'
+  register: reboot_required_file
+  ansible.builtin.stat:
+    path: '/var/run/reboot-required'
+
+
+
+- name: 'Reboot if required'
+  when: '(reboot_required_file.stat.exists == true)'
+  ansible.builtin.reboot:

ansible/roles/20-common-40-package-upgrades/tasks/main.yml

@@ -0,0 +1 @@
+- import_tasks: '40-packages.yml'