We use Salt (a.k.a. SaltStack) to deploy apps to servers, and to otherwise manage servers.
All changes to servers should be made as documented here to ensure that changes are documented and reproducible; changes should not be made manually, which is undocumented and error-prone.
We use Agentless Salt (i.e. using the
salt-ssh command). This avoids having to run Salt minions on servers, and requires only SSH to connect to the server and Python to run operations on it.
To orient you to the repository: When you run the
salt-ssh command, it reads
Saltfile, which directs it to read the
salt-config/master directs it to read the
pillar directories. The
top.sls file in each directory serves as an index to the other SLS files, which in turn refer to the files in sub-directories.
- How-To Guides
- Get started
- Deploy an app
- Update server configurations
- Maintain a server
- Create a server
- Delete a server
- Kingfisher tasks
- OCDS documentation tasks