Merge calpolydatascience/jupyterhub-deploy-data301#5

notes from a test deployment

README.md

@@ -63,8 +63,13 @@ End users of the deployment should be able to:
   - Make sure there is a valid DNS entry for the server.
   - If you not going to use letsencrypt, obtain a trusted SSL certificate and
     key for the server at that FQDN.
+  - Install ansible ≥ 2.0, which has not been released as of January 2016.
+    To get ansible from master:
+
+        pip install git+https://github.com/ansible/ansible#egg=ansible
+
 2. Edit the `./hosts` file to lists the FQDN's of the hosts in the jupyterhub_hosts
-   group.
+   group. See `./hosts.example` for an example.
 2. For each host, create a file in `./host_vars` with the name of the host, starting
    from `./host_vars/hostname.example`.
 3. Create a `./security/cookie_secret` file by doing:

host_vars/hostname.example

@@ -11,7 +11,7 @@
 home_dir: /home
 
 # The users that should be jupyterhub admins
-jupyterhub_admins:
+jupyterhub_admin_users:
   - instructor
 
 # The regular users able to use jupyterhub

hosts.example

@@ -0,0 +1,2 @@
+[jupyterhub_hosts]
+fqdn.goes.here

roles/common/tasks/hostname.yml

@@ -0,0 +1,5 @@
+---
+
+- name: set the hostname
+  hostname: name="{{inventory_hostname}}"
+  become: yes

roles/common/tasks/main.yml

@@ -1,5 +1,6 @@
 ---
-
+
+- include: hostname.yml
 - include: ntp.yml
 - include: packages.yml
 - include: mounts.yml

roles/jupyterhub/tasks/supervisor.yml

@@ -3,3 +3,6 @@
 - name: install supervisor config for jupyterhub
   template: src=jupyterhub.conf.j2 dest=/etc/supervisor/conf.d/jupyterhub.conf owner=root group=root mode=0600 backup=yes
   become: true
+
+- name: start jupyterhub with supervisor
+  supervisorctl: name=jupyterhub state=restarted