From d9d3ffe36d3816672636440a33aea7281fb88a76 Mon Sep 17 00:00:00 2001 From: Ubergeek Date: Fri, 4 Jan 2019 01:35:58 +0000 Subject: [PATCH] Adding ansible man --- ansible.8 | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 ansible.8 diff --git a/ansible.8 b/ansible.8 new file mode 100644 index 0000000..030d5ef --- /dev/null +++ b/ansible.8 @@ -0,0 +1,37 @@ +.\" Manpage for Ansible on Thunix. +.\" Contact ubergeek@phoenix.thunix.cf to correct errors or typos. +.TH man 8 "03 January 2019" "1.0" "Ansible on Thunix man page" +.SH NAME +Ansible on Thunix \- how we manage the server +.SH SYNOPSIS +ansible-pull +.SH DESCRIPTION +We use ansible to manage the servers running the systems and services for Thunix. Ansible consists of a "playbook" of YAML files, that declare the state of the system. + +The first step is to clone the repo used to manage the environment: + +git clone git@ttm.sh:thunix/ansible.git +(You will need a tidegit account for this, and a key loaded into your account there) + +From there, the typical github-type workflow is used: + +* Create a local branch, to track your issue's changes. +* Commit changes to your local branch. +* Send a URI pointing to your repo, with branch name to someone with merge permissions + +Inside of the tildegit interface: + +* Create a new branch, selecting option to create a branch and pull request +* Make changes in your branch +* Update PR +* Wait for someone to merge your changes + +Hourly, a job runs that pulls the latest version of the repo, and the runs ansible-playbook against the playbook. A sudoer can manually run this job, if desired, and it's located at /etc/cron.hourly/ansible-pull. + + +.SH SEE ALSO +tildegit.org(8), git(8), ansible-playbook(8) +.SH BUGS +No known bugs. +.SH AUTHOR +Uber Geek (ubergeek@phoenix.thunix.cf)