forked from thunix/documentation
Adding ansible man
This commit is contained in:
parent
62c4a2bb4a
commit
d9d3ffe36d
|
@ -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)
|
Loading…
Reference in New Issue