Adding jupyter notebook support to the AWX development environment

* Jupyter starts alongside the other awx services and is available on
  0.0.0.0:8888
* make target: make jupyter
* default settings in settings/development.py
* Added jupyter, matplotlib, numpy to dev dependencies

Makefile

@@ -334,18 +334,18 @@ receiver:
 	fi; \
 	$(PYTHON) manage.py run_callback_receiver
 
-socketservice:
-	@if [ "$(VENV_BASE)" ]; then \
-		. $(VENV_BASE)/awx/bin/activate; \
-	fi; \
-	$(PYTHON) manage.py run_socketio_service
-
 nginx:
 	nginx -g "daemon off;"
 
 rdb:
 	$(PYTHON) tools/rdb.py
 
+jupyter:
+	@if [ "$(VENV_BASE)" ]; then \
+		. $(VENV_BASE)/awx/bin/activate; \
+	fi; \
+	$(MANAGEMENT_COMMAND) shell_plus --notebook
+
 reports:
 	mkdir -p $@
 

awx/settings/development.py

@@ -19,6 +19,18 @@ from split_settings.tools import optional, include
 # Load default settings.
 from defaults import *  # NOQA
 
+# awx-manage shell_plus --notebook
+NOTEBOOK_ARGUMENTS = [
+    '--NotebookApp.token=',
+    '--ip', '0.0.0.0',
+    '--port', '8888',
+    '--allow-root',
+    '--no-browser',
+]
+
+# print SQL queries in shell_plus
+SHELL_PLUS_PRINT_SQL = False
+
 # show colored logs in the dev environment
 # to disable this, set `COLOR_LOGS = False` in awx/settings/local_settings.py
 LOGGING['handlers']['console']['()'] = 'awx.main.utils.handlers.ColorHandler'

requirements/requirements_dev.txt

@@ -13,3 +13,5 @@ pytest-mock
 logutils
 flower
 uwsgitop
+jupyter
+matplotlib

tools/docker-compose.yml

@@ -12,6 +12,7 @@ services:
       CELERY_RDB_HOST: 0.0.0.0
       AWX_GROUP_QUEUES: tower
     ports:
+      - "8888:8888"
       - "8080:8080"
       - "5555:5555"
       - "8013:8013"

tools/docker-compose/Procfile

@@ -5,3 +5,4 @@ celeryd:        make celeryd
 receiver:       make receiver
 flower:         make flower
 uwsgi:          make uwsgi
+jupyter:        make jupyter

tools/docker-compose/supervisor.conf

@@ -59,6 +59,14 @@ redirect_stderr=true
 stdout_logfile=/dev/fd/1
 stdout_logfile_maxbytes=0
 
+[program:jupyter]
+command = make jupyter
+autostart = true
+autorestart = true
+redirect_stderr=true
+stdout_logfile=/dev/fd/1
+stdout_logfile_maxbytes=0
+
 [group:awx-processes]
 programs=celeryd,receiver,runworker,uwsgi,daphne,nginx,flower
 priority=5