--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/deploy/README.md	Wed Nov 28 15:45:37 2018 +0100
@@ -0,0 +1,21 @@
+# build and deployment
+
+- install Ansible
+- Create a new deployment profile:
+    - add a new deplyment host list by creating a `hosts/hosts.<profile>` file:
+    - `cp hosts/hosts.tmpl hosts/hosts.<profile>`
+    - define the profile vars: `cp group_vars/group_vars.yml.tmpl group_vars/<profile>.yml`, customize it
+    - create the necessary host vars in `host_vars/<machine>/base.yml`. Use ansible vaults to edit them and do not expose any secret.
+    - deploy with the command `deploy.sh`: `./deploy.sh <profile> <version>`
+
+## Create new version
+Launch the command:
+- `set-version.sh <version>`
+- commit, tag and push as needed.
+
+## Launch local django command on the managed host
+
+```
+DJANGO_SETTINGS_MODULE=irinotes.settings IRINOTES_CONFIG_BASE=/etc/www/irinotes django-admin <command>
+```
+