Awesome SaltStack

A collaborative curated list of awesome SaltStack resources, tutorials and other salted stuff.

SaltStack is the other configuration management system built with Python.
It takes a new approach to infrastructure management by developing software that is easy enough to get running in seconds, scalable enough to manage tens of thousands of servers, and fast enough to control and communicate with them in milliseconds.
SaltStack software manages system infrastructure and the application stacks that run on it and is used by web-scale application developers, DevOps teams and systems administrators.

A 💎 means really awesome / useful.

Contents

• Official resources
• Tutorials
• Code
• Books
• Videos
• Tools
• Presentations
• Blogposts and opinions
• Discussions
• Community
• Formulas
• Cheat sheets
• Uncategorized

Official resources

• SaltStack site - Company website.
• GitHub repo - Salt's source code, issues discussion and collaboration.
• SaltStack Documentation - Official documentation.
• Salt in 10 minutes - Official walkthrough.
• SaltStack Get Started - These tutorials walk you through the basics of getting SaltStack up and running. 💎
• Training and certification - Official training.
• Jinja2 documentation - This official documentation covers the used templating language in Salt.

Tutorials

• Salt - Beginners Tutorial - One of the best tutorials to get you started. 💎
• About SaltStack - Extensive blogpost with lots of in-depth information. 💎
• Managing Linux server configs with the SaltStack - Managing Linux server configs with the SaltStack.
• A dive into SaltStack - SaltStack uncovered - Configuration management has been a big leap forward for System Engineers.
• How To Install Salt on Ubuntu 12.04 - Part 1 of 2 in the series An Introduction to Salt.
• How To Create Your First Salt Formula - Part 2 in the series An Introduction to Salt.
• Automated Provisioning of DigitalOcean Cloud Servers with Salt Cloud on Ubuntu 12.04 - Walkthrough on automated provisioning of DigitalOcean Cloud Servers with Salt Cloud on Ubuntu 12.04.
• How To Install and Configure Salt Master and Minion Servers on Ubuntu 14.04 - SaltStack installation walkthrough for Ubuntu 14.04.
• How To Use Salt Cloud Map Files to Deploy App Servers and an Nginx Reverse Proxy - Walkthrough on how to use Salt Cloud Map Files to deploy application servers and an Nginx reverse proxy.
• An Introduction to SaltStack Terminology and Concepts - Part 1 of 6 in the series Managing Development Environments with SaltStack.
• SaltStack Infrastructure: Installing the Salt Master - Part 2 of 6 in the series Managing Development Environments with SaltStack.
• SaltStack Infrastructure: Configuring Salt-Cloud to Spin Up DigitalOcean Resources - Part 3 of 6 in the series Managing Development Environments with SaltStack.
• SaltStack Infrastructure: Creating Salt States for Nginx Web Servers - Part 4 of 6 in the series Managing Development Environments with SaltStack.
• SaltStack Infrastructure: Creating Salt States for HAProxy Load Balancers - Part 5 of 6 in the series Managing Development Environments with SaltStack.
• SaltStack Infrastructure: Creating Salt States for MySQL Database Servers - Part 6 in the series Managing Development Environments with SaltStack.
• Getting Started with SaltStack - the Other Configuration Management System Built with Python - A Linux Journal "Getting started" from 2013.
• Create an army of Salt minions on DigitalOcean - Combine the simplicity of Salt with DigitalOcean's snapshot and image feature.
• Vagrant & SaltStack Quickstart Tutorial - Getting started with SaltStack and Vagrant.
• Salt-API, A Crash Course - Get a barebones salt-api proof of concept up and running.
• Revised Getting Started with SaltStack - Part 1 - Simple setup and play around on the command line.
• SaltStack Examples - Will teach you some of default functions in a quick way.
• Masterless Saltstack - A simple guide on how to use SaltStack in masterless mode.
• Getting Started with Saltstack and salt-workspace - Learning SaltStack by setting up a salt-workspace.
• Getting started with Salt Structure - Learn how to setup a structured SaltStack workspace.
• Writing a custom Salt Grain - Writing a custom Salt Grain, and why you might want to.
• Building Self-Healing Applications - Automate the detection and first action to correct errors in your infrastructure.
• Introduction to SaltStack - A two day course designed to quickly introduce System Administrators and Application Developers on how to start using Saltstack.
• The Simplest Way to Learn SaltStack - Start to learn the basics of SaltStack by setting it up in Docker.
• SaltStack - Quick Guide - Part of the larger "Learn SaltStack"-tutorial at Tutorials Point.
• A Comprehensive Introduction to Salt - Architectural overview and how to use Salt as a full infrastructure management tool.

Code

• zulily/alkali - A collections of SaltStack states and pillar data that provide just the basics for provisioning Linux instances that may be built upon.
• zulily/buoyant - Leverages docker to provide an alternative to VM-centric SaltStack development environments.
• valentin2105/Kubernetes-Saltstack - Saltstack recipe to deploy Kubernetes cluster from scratch.
• madflojo/masterless-salt-base - Quickly bootstrap a generic(ish) Ubuntu server. One that is ready to host Docker containers.

Books

• O'Reilly - Salt Essentials by Craig Sebenik, Thomas Hatch.
• O'Reilly - Network Automation at Scale by Mircea Ulinic and Seth House (an ebook sponsored by Cloudflare).
• Leanpub - SaltStack For DevOps by Aymen El Amri.
• Leanpub - Getting Started with SaltStack by Ben Hosmer.
• Packt - Learning SaltStack, 2nd ed. by Colton Myers.
• Packt - Mastering SaltStack, 2nd ed. by Joseph Hall.
• Packt - Extending SaltStack by Joseph Hall.
• Packt - Salt Cookbook by Anirban Saha.

Videos

• SaltStack - SaltStack's official YouTube channel.
• Managing Your Infrastructure with SaltStack - PyCon 2015 - April 11, 2015 - Colton Myers.
• Testing Salt States with Docker - SaltStack PDX - June 23, 2015 - Jason Denning.
• Beyond Configuration Management with SaltStack for Event-Driven Infrastructure - Southern California Linux Expo - January 23, 2016 - David Boucha.
• Automation and Orchestration with SaltStack and Twilio - Devops Chicago - March 2, 2016 - Nathan Brooks.
• SaltStack for FreeBSD - A 7-part video crash course on SaltStack for FreeBSD.
• SaltConf15 - YouTube - There were more than 60 talks delivered at SaltConf15 and we recorded all of them.
• SaltConf16 - YouTube - Video recordings of SaltConf16 presentations.
• SaltConf17 - YouTube - Video recordings of SaltConf17 presentations delivered by SaltStack customers and partners.

Tools

• SaltGUI - A web interface for managing SaltStack based infrastructure.
• Pepperboard - A simple and modular dashboard toolkit for SaltStack.
• Molten - Molten is a WebUI for the REST API exposed by Saltstack.
• salt-pepper - A CLI Frontend to the salt-api systems.

Presentations

• Getting Started with SaltStack - by Peter Baumgartner.
• An introduction to infrastructure management with SaltStack - by Aurelien Geron.
• Saltpad: A SaltStack Web GUI - by Boris Feld.
• Intro to SaltStack - by Justin Carmony.
• salt-deconstructed - Video and presentation (slides & PDF) by Carson Anderson.

Blogposts and opinions

• Docker with SaltStack - How-to use SaltStack on a virtual cloud server based on Debian or Ubuntu.
• Moving away from Puppet: SaltStack or Ansible? - Salt and Ansible as viable and excellent options for replacing Puppet.
• One week of Salt: frustrations and reflections - First hand experiences from a Chef user.
• Getting started with SaltStack by example: Automatically Installing nginx - A good getting started guide for both Salt master and minions.
• SaltStack: Manage entries in unmanaged files with File Blockreplace - How to use the SaltStack's core file.blockreplace.
• Docker Swarm 1.12 Cluster Orchestration with SaltStack - Let’s see how we can automate the spin-up of a cluster using SaltStack.
• SaltStack: Keeping Salt Pillar data encrypted using GPG - On secure encryption/decryption of pillar data.
• Secure Pillar in SaltStack with GPG - Encrypting your pillar data can be done with GPG.
• Network-Automation with Salt, NAPALM and Kubernetes - How to manage legacy devices that are not able to install software natively on themselves.
• Python development for infrastructure management using Salt - The overlooked side of Salt and some best practices.
• Using Salt like Ansible - How to use Salt in a way similar to Ansible.
• Using Salt with reclass - Use class inheritance to define nodes roles and avoid duplication.
• Text editor plugins for Salt states and YAML/Jinja - Covers plugins for different editors when writing Salt states.

Discussions

• Reddit: Vagrat, SaltStack, Ansible, Docker, Chef, Puppet, Packer.. Something - Discussion on Reddit, started Sept. 2014 in /r/sysadmin.

Community

• Salt IRC chat - IRC about Salt on Freenode.
• Twitter feed - Official Twitter account.
• Mailing list - Salt-users mailinglist on Google Groups.
• SaltStack Meetups - Worldwide Meetup groups.
• SaltConf - Annual user conference for SaltStack customers, users, partners, developers and community members.
• Facebook - Official Facebook account.

Formulas

• SaltStack Formulas - A central collection of formula repositories for SaltStack.
• Salt Formulas - A community developed SaltStack formulas ecosystem.
• Writing SaltStack formulas - An overview on writing SaltStack formulas.
• Salt Formulas - In-depth blogpost about Salt Formulas. 💎

Cheat sheets

• SaltStack Cheat Sheet Plus - by Facu de la Cruz.
• Salt Commands cheat sheet - List of common Salt commands.
• SaltStack Cheat Sheet - by Valentin Höbel.
• SaltStack Wiki - Cheat sheet in the SaltStack GitHub Wiki.

Uncategorized

• Salt (software) - Wikipedia (English).
• HubbleStack: Security for DevOps - Hubble is a modular, open-source security compliance framework built on top of SaltStack.

License

To the extent possible under law, Henk has waived all copyright and related or neighboring rights to this work.