Deploy#

This documentation is split into:

Development Guides

Instructions on getting set-up and making changes to the deploy repository.

Deployment Guides

Instructions for specific deployment tasks.

Maintenance Guides

Instructions for specific maintenance tasks.

User Guides

Documentation for users of our services.

Reference

Infrequently accessed reference material.

Development Guides#

Follow the Get started guide before following any of the Deployment Guides. If you’re new to Salt, Learn Salt.

To make changes to the deploy repository, read the Make changes and following guides.

Deployment Guides#

If you need to perform a specific deployment task, follow the relevant how-to guide. This section focuses on deploying the changes you made in the previous section.

All changes to servers should be made using Salt to ensure that changes are documented and reproducible; changes should not be made manually, which is undocumented and error-prone.

Maintenance Guides#

This section describes how to perform tasks that don’t involve changes in Salt.

User Guides#

This section contains documentation specific to our deployment of a given service. For generic documentation of a given service that we authored, follow the Docs links on this page.

Reference#

This section describes facts about our servers and deployments.