salt.example.com
Ops Handbook for08/04/2016
_To understand how to use this living handbook template there is a _ short guide you should read first .
This is a gentle tutorial to SaltStack, a python tool for infrastructure management, orchestration and all the other buzzwords for configuring servers and deploying code. The guide introduces the fundamentals of SaltStack by giving it the inception treatment, bootstrapping a master and minion with the salt-ssh command. It also aims to explore some sustainable 12factorapp conventions for small projects to structure and manage a saltstack project.
A github repository accompanies this guide with a branch for each part if you wish to clone and replace the variables with your own. I encourage you to report bugs, add feature requests, and even ask for help as an issue if something is unclear.
It also makes better sense to follow these docs on notion .
SaltStack automation for CloudOps, ITOps & DevOps at scale
Part 2 - Creating a Baseline Environment
Part 3 - Installing a masterless minion
... more to come .. probably slowly.
Authors note
I am not a SaltStack expert or orchestration professional, so this is an entry level guide written by a beginner. I have prior experience with Fabric and more recently Ansible , and was keen to try SaltStack but found the documentation pretty haphazard; a side-effect no-doubt of it's rapid evolution.
This small project serves a few purposes. The first was to experiment with notion.so as a tool for writing company procedures and operational handbooks; the second, to explore a different process for documentation driven projects that improve the transfer and re-transfer of knowledge. Finally, of course I wanted to better understand the world of salt.
— Brett
Copyright
Brett Haydon 2016