A collection of delicious Salt states for Django project deployments.
SaltStack Python Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
_states
base
elasticsearch
fail2ban
forward_logs
locale
memcached
newrelic_npi
newrelic_sysmon
nginx
nodejs
postfix
postgresql
project
python
rabbitmq
salt
solr
sshd
statsd
sudo
supervisor
syslog
ufw
unattended_upgrades
users
vagrant
version-control
CHANGES.rst
LICENSE
README.rst

README.rst

Margarita

This repository holds a collection of states and modules for deployments using SaltStack. These exist primarily to support the Caktus Django project template.

License

These states are released under the BSD License. See the LICENSE file for more details.

Contributing

If you think you've found a bug or are interested in contributing to this project check out margarita on Github.

Development sponsored by Caktus Consulting Group, LLC.

Versions

See the CHANGES.rst file for a list of changes in each version of Margarita since we started applying version numbers. The version number in the top entry is the version of Margarita that you're looking at; it's not stored anywhere else for now.

NOTE: We never update the master branch of this repo to avoid causing unexpected upgrade problems for older projects which are tracking the master branch.

To make a new release:

  • Make sure you have no local uncommited changes

  • Make sure you have the latest develop branch locally:

    git checkout develop
    git pull origin develop
    
  • Pick a new version number, attempting to follow the guidelines of Semantic Versioning.

  • Edit CHANGES.rst with the new version number and the changes since the last release. Pay special attention to documenting any changes that could break projects using older versions of Margarita.

  • Commit those changes.

  • Tag your commit:

    git tag 'X.Y.Z'
    
  • Push the updated develop branch and the tag:

    git push origin develop --tags
    
  • If this release is ready to be used by new projects based on our project template, then update margarita_version to this new version in project.sls

States and Variables

There are multiple variables that can be configured for your project. There are also some optional states that are not included in every project by default. This list of states includes documentation about all of the available states and about which variables are configurable. Those variables would be configured in your pillar.

Enable Additional Services

Configuration of various useful services including Github, New Relic, Papertrail, Travis CI, Requires.io and BitHound is documented on our External Services page.