/saltstack-ops-handbook

An unofficial SaltStack Ops Handbook

Primary LanguageSaltStackOtherNOASSERTION

Ops Handbook for salt.example.com

08/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 0 - Pre-requisites

Part 1 - Project setup

Part 2 - Creating a Baseline Environment

Part 3 - Installing a masterless minion

Part 4 - Installing a master

... 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

https://creativecommons.org/licenses/by/4.0/