Operations grimoire/Deploy with Salt

2016-11-07T20:24:39Z

2001:470:1F13:D91:3113:262:4553:BBAF: /* Salt commands */

== Where to work? ==
* We deploy from Ysul using:
** /opt/nasqueron-operations as our local copy of rOPS, authoritative for Salt
** /opt/staging for web application content
* You need to belong to the <code>salt</code> group to be able to control Salt
* You need to belong to the <code>deploy</code> group to be able to update /opt/staging (salt is a member of deploy)
* You want this alias: <code>alias salt sudo -u salt salt</code> (tcsh syntax)
* Check salt-master is run, if not <code>service salt-master start</code>

== Deployment workflow ==
=== Apply a new Salt state ===
# On your laptop, prepare and upload a change to Differential against rOPS repository
# Get the change on Ysul: <code>arc patch D607</code>
# Ask Salt to apply the change
# Log on #nasqueron-operations something like <code>[Eglide] New user account: amj (D607)</code>
# Once working, you can merge it to master
=== Deploy a web site ===
# Commit as needed
# Go to /opt/staging relevant subdirectory and fetch code
# Ask Salt to apply the matching state (if in doubt, a full run is <code>salt '*' state.highstate</code>)

== Salt commands ==
To apply one state or a directory:

<code>salt eglide state.apply roles/shellserver/users</code>

To apply all:

<code>salt eglide state.highstate</code>

Replace <code>eglide</code> by the server name, or <code>*</code> to target all machines.

When you've a new state, ensure it's called from <code>top.sls<code> file, as the repository root.

Nasqueron Agora - User contributions [en]

Operations grimoire/Deploy with Salt