How-to guides¶
These guides solve specific tasks on a host you already deploy to with syslet. If you're new to syslet, start with the Tutorials.
Most guides show both a CUE repository and plain JSON specs; the secrets and CUE guides at the end only apply to a CUE repository.
Deploy¶
Getting specs to a host, and what to do when an apply goes wrong.
- Deploy over SSH
- Preview changes with --diff
- Check changes in CI
- Roll back a deployment
- Troubleshoot a failed apply
- Migrate hand-written quadlets
Containers¶
Changing what runs, and how it restarts.
- Manage containers
- Upgrade a container image
- Set environment variables
- Mount config files and dirs
- Pass a secret to a container
- Set systemd service options
- Add dependencies between containers
- Wait until a container is healthy
- Run a oneshot job
- Build a container image
Volumes¶
Volumes hold data, so these guides are about keeping it.
Networks¶
Secrets¶
Keeping secrets encrypted in the repository, and managing the keys that encrypt them.
- Set up SOPS in a CUE repository
- Rotate a secret
- Add a SOPS recipient
- Rotate the SSH host key
- Use a dedicated decryption key
CUE¶
Tools of the CUE schema for protecting entries, and for larger repositories.