From ece1ab9983ec74bdd68ad4386b705165ff4290ad Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9gis=20Behmo?= <regis@behmo.com>
Date: Tue, 5 May 2020 16:30:06 +0200
Subject: [PATCH] Make xqueue actually do something

Xqueue was mostly broken in the previous releases. In this version, we
address the following issues:

- Proper initialisation by creating the right users
- Shift from 8040 to the more standard 8000 port
- Expose xqueue service on the internet for accessing its API
- Properly define the xqueue name ("openedx")
- Make sure that all logs go to the console
- Add convenient CLI for using the awkward Xqueue API
- Properly document how to use Xqueue
---
 README.rst                                    |  82 +++++++++-
 screenshots/correctanswer.png                 | Bin 0 -> 35328 bytes
 setup.py                                      |   2 +-
 tutorxqueue/__about__.py                      |   2 +-
 tutorxqueue/patches/https-create              |   1 +
 tutorxqueue/patches/k8s-deployments           |   2 +-
 tutorxqueue/patches/k8s-ingress-rules         |   6 +
 tutorxqueue/patches/k8s-ingress-tls-hosts     |   1 +
 tutorxqueue/patches/k8s-services              |   2 +-
 tutorxqueue/patches/nginx-extra               |  37 +++++
 tutorxqueue/patches/openedx-common-settings   |   2 +-
 tutorxqueue/plugin.py                         | 150 +++++++++++++++++-
 .../templates/xqueue/apps/settings/tutor.py   |  16 +-
 .../templates/xqueue/build/xqueue/Dockerfile  |   4 +-
 .../templates/xqueue/hooks/xqueue/init        |   1 +
 15 files changed, 291 insertions(+), 17 deletions(-)
 create mode 100644 screenshots/correctanswer.png
 create mode 100644 tutorxqueue/patches/https-create
 create mode 100644 tutorxqueue/patches/k8s-ingress-rules
 create mode 100644 tutorxqueue/patches/k8s-ingress-tls-hosts
 create mode 100644 tutorxqueue/patches/nginx-extra

diff --git a/README.rst b/README.rst
index b9888d2..764378a 100644
--- a/README.rst
+++ b/README.rst
@@ -6,7 +6,7 @@ This is a plugin for `Tutor <https://docs.tutor.overhang.io>`_ that provides the
 Installation
 ------------
 
-The plugin is currently bundled with the `binary releases of Tutor <https://github.com/overhangio/tutor/releases>`_. If you have installed Tutor from source, you will have to install this plugin from source, too::
+The plugin is currently bundled with the `binary releases of Tutor <https://github.com/overhangio/tutor/releases>`__. If you have installed Tutor from source, you will have to install this plugin from source, too::
   
     pip install tutor-xqueue
 
@@ -14,15 +14,89 @@ Then, to enable this plugin, run::
   
     tutor plugins enable xqueue
 
+Usage
+-----
+
+In the Open edX studio, edit a course and add a new "Advanced blank problem" ("Problem" 🠆 "Advanced" 🠆  "Advanced blank problem"). Then, click "Edit" and copy-paste the following in the editor::
+
+```
+<problem>
+  <coderesponse queuename="openedx">
+    <label>Write a program that prints "hello world".</label>
+    <textbox rows="10" cols="80" mode="python" tabsize="4"/>
+    <codeparam>
+      <initial_display>
+        # students write your program here
+        print ""
+      </initial_display>
+      <answer_display>
+        print "hello world"
+      </answer_display>
+      <grader_payload>
+        {"output": "hello world", "max_length": 2}
+      </grader_payload>
+    </codeparam>
+  </coderesponse>
+</problem>
+```
+
+.. note::
+    The queue name must be "openedx".
+
+Save and publish the created unit. Then, access the unit from the LMS and attempt to answer the problem. The answer is sent to the Xqueue service. If you know how to use the Xqueue API, you can access it at http(s)://xqueue.LMS_HOST (in production) or http://xqueue.localhost (in development). However, the Xqueue API is a bit awkward to use. Tutor provides a simple command-line interface to interact with the Xqueue service.
+
+Count the number of submissions that need to be graded::
+    
+    $ tutor xqueue submissions -u http://xqueue.localhost count
+    {
+      "content": 0,
+      "return_code": 0
+    }
+
+.. note::
+    By default, ``tutor xqueue submissions`` will hit the Xqueue API running at http(s)://xqueue.LMS_HOST. When running locally, you will want to interact with http://xqueue.localhost. To do so, you should pass the ``--url=http://xqueue.localhost`` option to the CLI.
+
+Show the first submission that should be graded::
+
+    $ tutor xqueue submissions show
+    {                                    
+      "id": 1,                                                                                                           
+      "key": "692c2896cdfc8bdc2d073bc3b3daf928",                    
+      "body": {                                                                                                            
+        "student_info": "{\"random_seed\": 1, \"anonymous_student_id\": \"af46c9d6c05627aee45257d155ec0b79\", \"submission_time\": \"20200504101653\"}",
+        "grader_payload": "\n        {\"output\": \"hello world\", \"max_length\": 2}\n      ",       
+        "student_response": "        # students write your program here\r\n        print \"42\"\r\n      "
+      },                                                                                            
+      "return_code": 0                                         
+    }                                                                                              
+
+Grade the submission (in this case, mark it as being correct)::
+
+    $ tutor xqueue submissions grade 1 692c2896cdfc8bdc2d073bc3b3daf928 0.9 true "Good job\!"
+    {
+      "content": "",
+      "return_code": 0
+    }
+
+.. warning::
+    When running locally, the Xqueue client will report back to the LMS at the production url, so there are great chances that it will not work. A workaround is to manually edit the Submission record stored in the Xqueue database and modify the ``lms_callback_url`` attribute, but this is for advanced users only.
+
+The submission should then appear as correct with the message that you provided on the command line:
+
+.. image:: https://github.com/overhangio/tutor-xqueue/raw/master/screenshots/correctanswer.png
+  :alt: Correct answer
+  :align: center
+
 Configuration
 -------------
 
 - ``XQUEUE_AUTH_PASSWORD`` (default: ``"{{ 8|random_string }}"``)
-- ``XQUEUE_MYSQL_PASSWORD`` (default: ``"{{ 8|random_string }}"``)
-- ``XQUEUE_SECRET_KEY`` (default: ``"{{ 24|random_string }}"``)
-- ``XQUEUE_DOCKER_IMAGE`` (default: ``"overhangio/openedx-xqueue:{{ TUTOR_VERSION }}"``)
 - ``XQUEUE_AUTH_USERNAME`` (default: ``"lms"``)
+- ``XQUEUE_DOCKER_IMAGE`` (default: ``"overhangio/openedx-xqueue:{{ TUTOR_VERSION }}"``)
+- ``XQUEUE_HOST`` (default: ``"xqueue.{{ LMS_HOST }}"``)
+- ``XQUEUE_MYSQL_PASSWORD`` (default: ``"{{ 8|random_string }}"``)
 - ``XQUEUE_MYSQL_DATABASE`` (default: ``"xqueue"``
 - ``XQUEUE_MYSQL_USERNAME`` (default: ``"xqueue"``)
+- ``XQUEUE_SECRET_KEY`` (default: ``"{{ 24|random_string }}"``)
 
 These values can be modified with ``tutor config save --set PARAM_NAME=VALUE`` commands.
diff --git a/screenshots/correctanswer.png b/screenshots/correctanswer.png
new file mode 100644
index 0000000000000000000000000000000000000000..bf5552834dd92cdafaf287a8f207a143f0127f3b
GIT binary patch
literal 35328
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%0DW-_Zy!XY|fA%_3T8iS!Bqcr(2
zvly1_*p4D8d(6BcQ}jT4f|P5dt?Ogho2oyQ1yBLVyO`U^s_H(OK2$xGK}h14V~l8v
z_l#L9!yHGZs@3#mha4QS)WW6wp7dHRKb~RcA~dBaHht;0m`ZiwTX!yAyy(4>v6E9;
zq&7%NNlxS3AM_j^lH~k7CZ1g3LDC6YOJq5Wur>pyE&Jv+ew5Yr%LPA7lJ4Op7Q~kH
z5y(v}Rmx@L2tAT*LQW*0dyv11LV9)W#4wNm`SScE%VA%4#c|=UW0CINttB#;$y7gW
zm=AIi9>AksySKIm$eqVMluU9qvQq#23}f{0VcZriS4n%nD%(xh2v|vb8lLVotRPMy
z-3RSFbu%4Zc&eYHmb9piFr?H=dQYGVNrjk-YW@NV<2;jG`@T9?&D}tWTu0h-EsKgL
z4|$|hvVwdZv&-Bp$S}`s;U4nfc$H{llCe?1H=nthIy8FK&2XYcsnyiht3{dL1O%(v
z8g+1<8fe@rDR9#bmRvCk7-MW@S9)oqU?p9XsxqnvcV`9H#&Nb8;;h5Q{<Op)Q(s6A
zlKh-IoP3}1rk}=CtRq501QBB^bA`u&a}UVFx2oWmiJRaX$esSssqwNLNp3%5&i%&9
z(Lb<@u<<6a6@JjlG#SlOf{hzS7wM=}`3ihF4F6OjvL>kAmxyNxZ;mPK8$vngT7hWh
zmT`5GF;q7Qs3PmQ3Z9mk@QhXUio!5AX$F^B3<pFv%9T5r<rI0@@hAmAFsotd*%W_f
zgm-6^Wpwii)~a&Z*w{uVXm2cvZ%cD7$Hc@;V9UZI7)BqgcZ52YsII3S9v%*D)5Q2v
zPmlItKP;PC4B*n+17r*r6ZujVR_gRFraAO#)xrl33T;X+NhVLF5sdV6`&_$vd#(r&
z-sdDz^Yism);XWu9<R}>qvq<>m1#_5+8{;sbqB3CAG<4;sBv@WYz6q|NOoUO+xyU<
zwir$?@b@qbrqc(f1Dza|I1fH(G8n@o!IURS7*_bTkm~oN1cepc_)HQ3#*YhWQF1AB
zobY4aMu{5^zx48`#@3v6A~v8LzD(&`Y_twdh7P=EotT)Y&lBW4WcJTZ(x*IKEiifL
zwdBo8T3OTfz!-Zadho1}*7Px~oXrAvt$dJqnv9%c-|Z{mY0d>TnbgE&%GAu<sbY@B
z6GC(90}~TzCMH5S<l-WWCLgA8pWIKZ_m-k$FeD*{doOI&?x-hIAat59Gh!_lWpgS~
zbI34S%zSYXe;EFRa@|}AHwF<exoW7g)9Yi-bmOQd0<;e0dvv~cCDme$3@cm+Wt9b?
zxxJIuT&Bq)TU~0LmscDF9Wm|g^6h3WCWyV~vJUk1yzhB=B`H}4ouVkVxm>_?T2+Ue
zet5?gS(;GXUBvtpuE}OY_NY=8lL>o~?)X8G#|tm5{Rf$jp<{qz2~=mE+HQf=s->?d
ztP4DgOZC);=N4P1)1<-OLGwn&RtZKfE_i?IWUtPZjLk(D-bJVFd9R8?*_07xW<_OR
z(Q&vgbErQ(*}{(npav_;^@5HRji>XU;=}npEj2|;Q1n6OhI01-8B{7YyIL~*?$yRd
z(iHtc=w%G1$5_Wa_!JB$@LYX+OUM#?jKMu9=P_MTA#0J+(J_o}s;}93Xc44^8C1Tn
z9?m5}Thc`w{V|9XsS%5aDXm64{vbC5^ZV=usNW14idmj!#>5p$A$(sSFePZJDQ6j-
z3hUgu6aEcp{!?@sE-jMuJv?kV)s~vJXy;G70?l9DF*dWwq#C(7_GU3fSN4Gf;E&&S
zAe#|{3bUcy+yGOgrn>YF*#0-yW5*0+05x_lAP+rfXUV~dfz&9$v{F_EKd`Iqu*-{g
zF>HL$cxo_HTAdYcp?Jl~R#~+?ca?9%Q*V1a*QteNE=AltySPGBTEC!t{&yu)oudK2
z;}QkhZhpAZ95L?jiqVvh{6gL*_VH#pmCZ8d)?PMO^ir<P&SdK~e^60hF@wy{esrNt
zOvlAc8%eO${bo8moZC>K?#8OH98)#oiyX}^Uj99@xL99b1&8<dZTph%TwuKHte&0u
zOlP=K8P@yKTFJ>VAD@QXbsc!uaG80ORNPIuBGau1N<r(n^<{R_ji5&?N1+)|%8jK~
z@y51o`IoQ{`MD}N{Z$o!2S&CkcvV(cS{G$_;ZYV=-A8B}pugm0veQ3iGHQ~Y*Qk)j
zT3;L<C^IubE7A^f0;%YR7X$qr#?P)I{&)elf+#Te-d0sq0dBY!mZ%q5#V_MgBG@Of
zi=p`|M#jrs$YSc93H#oz>QU0fSR$k#o>WeBB(K)_7Cq@546k*Y+0bA)_H^gz`je-p
z2b~;sun|&0>l=krHPRDRZv6xfm(A7rf*p;|ZdklnRzE&^q6`iSsH^tq$0PknQYG4c
zTDa<sakZx4JBl6?ab&XKc$J;0S=CNn9nI4)he29f>LT=|u^vny*I<BRMU6dAAy}~A
zi2GPdUz(EBeAw{bifA-cTEBY>4LkDJB;e$GGm%DC_T;pq`<d2_!u(1e{RHM!zH8-%
zgz>(Uz`jJ&ocuB+H_5C%g5cD6sXcMlCxG4AHMcJvi9<mwsG|ktcAJ?r{BCP`5OqBI
zP9}x4w5qp)s>*h^%w?x$tNUZP(ImIN{HkZ5!L)w2iE=od<~q|P&2Jm1!X*oii@`us
zHOB76CuS&#09{ne|0da6G<w1OSI07=3jjSh?hG`#L^iMuXBU-@;xjkNZiGUGtQxN~
z@#^`3*B0LGj`L2L_IB#SsW^gY?7}!l+D^p|-l;rz{;wi+GO9P#G$SS#669_5WdvlC
zxX(8X^{_-W+te#h1gv(^qOpWINC8eYM`Lh@lg@8!#k^*1q%g#vo~c6jcbK2ow;1&M
zM$30LN|m;#b+-5SrF6xRn?#z#Fw414mWxPvS(uuv>qMNOY89kyum@K`ZdqE+p!~3m
zdRV8R{QRE5;W{~&>b3hjF=UY%LM(Y&85Rs*4mN{~m*s7?65PhCg6wS`F<cc_yWTQo
zexhj`T|&A)_&t1ciw#yniRLe3-sw^9PmfzW`s0PQRd<SBLGz`>m5b$D-5ldp_8@=P
ziML|OijH8YrK5pr1Ua_TTT>)2JM<pJlAo7Y>ZIhbSp_GqcB?U3r%(70JLDCLwW0f~
zLs?*CT*5`%gV7{HM;;sTZ~lgR%#}e8__6S!MmBpH%-SZUYhIt3y7Pt91=E>Pt&aXw
z)DTisJ4gpy1hpAYXCA@IHi^qei9=IVC5cI*@I?m6x>ikBr5-n7s}ltATh5({v(PG;
zo-VLojF(dLM7<r7S4*K63#3IvWS8eCuha$OCbAMG@{Pc%>H)o(p)J|@_A+$}Y=lwA
z_6Spp;R^Y_Mus+8Ey+|NRb?gOxw>Ij)HrZ(U@ZMrfKpC_yBW_UeDQ5~aFiMa*_&pS
zL?CcmR5>%v(r~u>ey>Q@0qwqTwWGe3xH0(?|AFkGeeOa;U9ObvAS#0wjJiysSR{AQ
zX@;{#5+!<mU^t<_j(qL?moaPq&Vxi$8m?@$Ns6M4DR2ftMjCqSR-be%CM`Ck5g_hb
z#wc^CzSd%Op9{miDG48dzVEzh-N_A!N(y<9@$ah^jVi|cxrDMW`OV%27x85M`7*+g
zObztg8>E=ElG3ImYOvyOD0yX7TO!|B$<2T;$`z<PQA0`v)=T!J@e*jchlv<TW1yd-
z<LHhPsYS^lIu#ja;bt+?a5+FJ*$C)kLl_pEQ-A31?~a0jbb8XtLhN*djpCN;NT~{W
za{4{2C)j_6r;jqRW$EUcs)MS@c^ggj2@&Yja^^)@oL<ZvT|kEoQk5X4uP<%UR3om=
zOskj}b{FC$6WE!Kedii%adJ=G!(FF`DhgdD8KN65nJO3?YcBr2gZO-_xQJey_O@)(
z9n(;o1a-H`Y?rLV+2-r{O>OmNAi({qC?+HNYC=*yry6=?Jq!jh9a7{~Z3L5;!<Dsv
z6DlsNmY3FEchMOHmK?4&Huu~kd<YBEs|~QYm{r&Vf6>@f`tAom%5uO~imIno2DE<U
z?mfNbTsfHE%#EhZoXdZG7wZ4=!@SHNv4ia)H92UrPieD<`Rku``A2}gE|51yJa0h+
zpd3WsVgJ{-1SFex+hwWDEjpP?az6$Y(<Ppl9?v{<u1w!eZzvr(iyxi;u{(B_L2wY#
z+J1IAHgqG>Hht;OpOx|5D7TQutsl9*Evf#fbZ5z-Pf_FAubmd1ng7~X`@c0KgX~en
zZuK5sWCjDoRy)!8;o|(JspZa^sry)LPhWDB`oQ9kC6RPb0B-$BKq$3HvsW5HwZ`Pa
zWvW9-n|r&vbK?x0=Hi}HW)FGpqoMD!JD*hxngijPXpe42a{7`bv-MN1d@iTJiVgl+
z*nkiEAY(CTb((F{-^6!Lw00Gb&FI2}x$pSwQCz0)FB|#_Gh4K<j)!~pf1I*lm?M&C
z80@01?S(%CxW_goMN(n&PI7+Ky;QYrV67KfB*?w9MKm-;D{D`Wj395j9*j&{ACbD1
z5zCW>(-{qiJIz_$95a}h<jn35VOWRdy#ybIh~{|x^vd3x5`oZx)$3c>6eA9f9^DdB
z_H2VC?|q->(PL~yP3|TUsr!aaNnr&?`ewd<kalSz@n92+-D7t5#f61A%myn!YbI#T
zV$<4OA`hI#77hsQ9?h!PY-Z4zCl1n@6PtIboxtU2TH!9{`@x|!crQ|n+$ZW$GLuB>
z(Ch^?X=pG}l%;N9FhgWIIj0%hOlK4?<jXF6!J6k%=bc2yGooWB<HI`2Ldd#^IN4F;
zVvZ9JafWf&tbIs$GZ}0{liEzO!mSrA;APcPU}Dkz<TcH1&7^4TQn^gGZAiToB5?b=
z$>ClAHAgp0j4w0b#*aNBPeo{RY_a|Ui#f#(lR-(8&$GG~8%f-xdKz|<Xj|jzam~l9
zX`T3yit|IHloZt{Cx^HnOhf2pb7BDOOvNPP=3m>v@l9)M;|xG%7j@>M=4_<Gp5?ru
z_Z+XKH>DD$p}A7Xy1A!dPLxDcswg4$%GeQ%)Q~kR&F)v5O$o9`Bh%gW*!pYqT&0T|
z!G@0$=RN|hnF}CHOhFni+eT>Ost2R>6PwmBIa0nZ=js4(Ki*nZd~a@<wkou~(OJTn
ze5am@!Dysn!K#NXTodL_ZDhQ)g4-<79*C}zt4HjH*yzO5h-G#=uWJ2K)lEOxSgb$1
zggCH{F^Mt2Bg)jf?VhKO)>H4@b2|9+;@tZ=K2v3ty}aUvLmCgpNV(~q*x(YzM5yA;
zl!x!)b`!@QCaQZ6(;~aSk5h6Fm>#RvyO%>{tbbQx_B_k7(#9*aIA7~vWFcg`si#P2
zO*gL?Tf#(PR)QGOQ{BhmvHry9;?abMAE&*_)-JVyqWhQ13>|4RA<E{04RK`;(UbMP
z>kWy;jMLoA4qLo-gaxV;Rm`VC+$4@jRu%`*SpwI#R*$ubEtat*aA4H}X65R$dVu`#
zcwHH_{nPm_c@W$>?ZA`%DGH!@*n+SJQO4cZ#C+`Vo4u&-0iTi}0TEoxo{!B=sV*MU
zDa}WBdA+0>_6TWrY-mFpS-mGqG}Ai50ey&>-FukuqocJcgy-;f24#b&EvMXnfz$f-
z0_dvVn~E!|I01^(`|>}Xp@o`%k1AB*hurmD6egxbcg*IBc`SpWZoHP&8~M@hoj0m-
z&7xUQ7G_41CmUTptA^<+4Y))JUb_|g3L`u@=MbMx?^M37Im`CE^~=IuiZW1nW>a~F
zLWeo-z8Gzo$?~`Y2XU6w&zsud59AQ(o8knUK;g~JqpmO*;CoJQWNqL*9{AKz_)N%-
zs{GgD@0k?%vx93b8aBbMEUZT>wj0R^@3~JaUsW?d9_DCUTW#~*TMIs)+15GUyT8pp
z#-G}b=srLkcwqr!dsNL$Tqa+Lv(1Ut&6LAV;wO4L56vL0&G+xsAVz?z`wB6BFUSG1
zy}9qx?63*Q^&;gA^4*ZTdE?K_*F_HTm$l<BNAp`)5ND27vCR?vZ+?#??<-)Xf}>c4
zCR#M785dY%x8l^H7x$8_+p9}-i_gf`MS=kRL;!`MQLXklJTQ<a*_vi5bhxc#vGt60
z>5TDiA85~S!6x)zEMON8;KU`Xzp+R@;8WrRr(cUC2PcN-F;ZZFUDc)r;_rH>_B?ln
zxYBPAx{7uV0&JS;Hci$vkt<+-UaVS($lkNj#2+KnR)N32dnxXIz*#_8;N+h4kD~ak
z0Upk*jVsDdeJ3V2@Bf^MHYIs3?q`Ge-}r=n*19bI_J6V{I&J;x`7=57Cw{ii2KqNS
z^3PvU!(cEv0jGcc8>iKfKE)3Gz{I$?TaJ#7bv<u?jnXYOHPyi(J?pyu)wuhYap14v
zP*2ad&z>DW#mYJej`&##r_G_zmR|DZY*gF&Kcfa@ZYquZ>e&eYzdY{$lMSPL)~`-i
zCNbZ=mYB?A{OG|=JG<*S5N?waw|CnuwT0Okevnrt^1dfcb$arRbdVlb{4I%Y5I3lB
z5=UN5YQGAG?aZee!z#ZJJZ3?XnQilbym>~#B~#eUSKU-$<!V3nMWE7DN#(bSqJ&46
zr?_LzUokSdD~|;2x~6OVDa?Mi)oF3{CnnI}F4)dJG*=&1(0{P;yT0ZlooN{0t{qgF
zdl*_Mee)qi(9daQVeZ=5veSlgYX1<(Q6Rdg9f~fn2icr-F^^@BF}QNirR|J_Zlt)>
z)$GsN>C1j;e5wvS6nt;pvbW9|Hu0-cxfR|gIg0FA`@UBwab^`{7e@G{z33PYa|1ur
zv)gw3E)pa71Z^LrCEot(<awTCqtb>L<T?G!c2%ggsW#NBthg+{(v^JCD|h{J>$u&O
z@t|Lv*#GUunOGI*wEtUZ4!2aOt%Y_v%`eHM7#7)@<R|a${=v>oS$_CIX$X)4QD8-V
zLVtSy=FEtKd}(cI3@XT@w74vyjyCs>aMPH>RI>UUIzPwD1-R|fbHj7S`C{F^!HUe^
z(gmMB<rD9BODv};4w^K_$G_M%F)hx4IJDjc6jc^Lqb6^=*#pz~UC{5|pfHsc?2DFj
z4xZ;VO73m{;z>~Vjf++*-&>Afy^3NSB0EvFCGR8K3(_o@2l$L7uD(;G9D^to<~8k~
zG2^)fgG=|t>0}lZe7IWs`Z-|eR)Dw*#U;0_IQ@69{IEjXcI*SIO8HvEz^cwj$;yXS
ze7M1i(8W=uKV?fkx<i)L&VMd*{}T)uo*aGD{vC66hqox#e~}w4Q!svhs2Bo*a&Re(
zey+L1_4~P)yRXLr|Apc%NiCx7O>hXOyqVF12kX-X4aLB{TQIhwjY}9E5LeBskB~%z
zmA^Y<SXz$zuP*&<scj)~<6=ArYLOV|!nSs7L(rAdd&ROUaI0ffE9bmnk47}?i4#n<
zGfS*2g?hEZ-34%c8mWIvdt+&%;eI0S(i0DofXdCw0*e1)D%XRTpgA?_=DPx)EsZ-t
zkd;7kEs^=LEXD#jy}y^f`1<<VT1{N>?{U8iyl#Jbq4dJtOPyG_R<71x{%;>Ki;RdD
z({SmIqlWpp+MRH5wUEX*P;7yu1x!ka|Ip@gkls)3CFw<Ft-rpc6CpOxSfo78A%9se
z?Zbyl5fOwqrArB?LAhszJHC|CZDP+v8QJNr)@Xg@?D$JgoR3rM(%si*BilO*BhCR}
zOAbZ~g34cl;zuK|$+1QN%tyyQOUA}WoQdFw{Y7-Xi=erODLJOx3(cn3<vM?Z)baC4
ze{xjg8r*vAd+}-Gp`MDO?Ljw%MBB^XxOwFI4V~ut+*q68=?nEvm$ts|bqk<cRT<Od
zKFVpM8hDZ4G5llVz4w*1kgcHa((=`}A8K#B_NvlQsir(O*)CmkbqW8l^zAM9<?}Kl
zN7bq;Kb6Bz;rL4ctUZ-~HDg8cYJsH|e9+9&asuk+X6IsjuB83m3FSD+M>gQQJ$UC4
z#Y)`xu$Gf9OOMON*Ga<<k}$Ss^35OcxV&@JVv)`O`}$SkDymSX(&fxUp~&SE67N3b
zCq9~YHj}Toj2*^*#iQy5zz^~gLG4tXOZt-N;t3s?IWKt43SD5MZCvx5oBN{@3s?1s
zQMvo(dL63LHQK}z7L-5y$xnJQlGj+d0-Nv)JLpA_p%u&T#wNozee75&xfC8W=f{yn
z;BVF6K!eJ~C2C*g$InUUM&_?Td#yUToD0MeD}U)pIzY9gqZQ2AJ?;wDKHrY^8#;Qd
zE-5*J6XZ$&NZUi&oFyW|tb(Z$&d}E-5I?ZOV!`~&&5wzrL!~N4+ViBzFW-mdhp>)Q
z`@<$9{^z)e#wJX>>=hzGF<GzJ(1o_3TW!wyJrksu@YL#>=lHN;DIp0-xwHoD!Pg7Q
z)&D@Q_m6S9Tji&9eHb)S`jLDlUFO%sh-qF5RkS!?OI2sxpUjwHHSg-W_VJQ|xfAck
zF6YI7t?Ts-EyW@~spo4Wr=}ArgEB*whq5jtPxjX>KlkPRC9uA?$^R(8?3@4jR~YD*
zf<EK$k6dTp{QtfvF^T+}hF-P$nUZFf7jJyc<qjb)-vx3`?j-q|U;4$xxeqSIUEqD#
zQ?%VZd!IOx70MoZIP7aK{Oc*w3s^-%aKzv~6iH5T|1|p9<<QBOp!pB*Ws$D4w|-XZ
zsP;PdkIzDCbNasv&yOknBGWxm_=tZX)%3~AGn>cGGE%kY-DRFz4@UW5vaEhFfM&2A
z<J@O21a-~a{bhR#7Qte;_AI)j1(o(rUaZK};A%`!hK}R&9wg^_<nnRFquAq$qwMQr
z$*i?*q2IUq&+#pMQ9V`TwmdF=?k{5e@l3Q(_KnR|@SPvMXP4&!LNzYkxO9$yeYIrW
zrO&Xf_RuU0`VGH7Xtwy$o;aW_`e<wKR_G0YqI=)$A>%FF?zu7`T$yNhb1*>uE?ww`
z{59XpUuLFN?!(|$WZBbK(|(RRXGXQ8)tC+vxbReA<#At%ADsT4W*Qhcpe*J78&FN<
zl_c@b$_P7o>a337=?xu_rS6%b9sg4W(?X$H@Q2T}65gxBMSqfItEsW(+<w@!Ln}&k
z*2m(e=H#|<px0gdyL5v<r?b6!cQVdJ&ke95XX^vl;~B1}3RG^lh06*oI1QhkK7d@=
ziPh5=<Dypg{AsPsT1J20DDstoby_EU(|p?X7gs3oOL;Tr!wUH?PEI)^42>6nBaf^5
zo44G>U-I#`yjK?%3f1_^79Ky^SL^W93Hj>L-py0>vP?u>{_O32PMK0}*?9^+LVmGz
z13dirlc2=7sy2~n_RC6rF*599f6=e4wyrN(dtyHt2hMT*!C-cs;)j9>Fkd_uGPikp
z7k+AHKaag>TkrLq@;?t&*<R=gmXjyU#h%Q>f7#aTo6U8)y>OQ`Xno{Xlc)TPB)?Q^
zFT^Ph#_7Yu<r6>yPxPIV@S5%MKS29)AkCh4t73eU&YnNVvH$yc&1pOi{E|J^K<2A1
zbIQ%MHaA<rh14`wbi?H@tmEI{6oiB4(TcEt=k10)|5KWw8h0rTC(L8U@7FhqzCerv
zKEyKLpv}3lCDauiUK0R&-N<rN?KbE$?%1)@e{0{pW%9LLS~xgQ?CP1U8rt*_!4A$4
z-amD_tqAdpal?7^G@{!R?8p`ccSZPwGIZ3w4jMwd2W9W53F>;bDZEhgS@|m~I{i!S
z{(CrfiJaA>E<AlALPjUba)<DKU?n*ARtVyC<40%R{^x`nAy<E}!$nr4)XUYglw<^p
zjuB#JkK=XBZsC*nA}+*;xdFQG6T?#+SV!+cO~|_J<z2eVDZ?8wibk~4G21cl#Mzs2
z7cTN2+ZI$ktcNqk)PLf1vD(q*jBUf!?JMVU4W7NXOPdsbn-EM5qG>(wfvQNPr>t5i
z>%&X`;Hqv($_kGJYR9~d=6HFmRg5z>X5~-J%XBt_KO}xKs{DY%7u%T=;X>j1>Yp72
z3;D_~tMZOao?z3H@8?4-1K;`_e;IqrWBD|+k#UXKdfi1v=bHU$N!m#*fNsm{fyz~j
z(-BX@)Sc{rEAI_*q#n<ncljv+Du9KSfTrW-l$T-wx2?Fgelzw-uy?by{2izd>=#Fn
z6W*{>*Lr6As&B8Vqu3)Idv!c}jFtk$zs3xenNNpFMxHw#@N&%Sytj-_DCKSj2>9Ve
z2;K9PA?5fLv6@BH315fx+pAJTh~H_yDV-O4a)e!Y-w1+#NBw|@q?UYgKsP})Cu?q?
z`|F*pFjllR^06c5H!gMc_0~;3wf(F+!g|y<uCX@iT>&0~e~GbiuCZ-wZ3@?DT;C4~
zzjJ^Uvl}2X8TeusIh;0n`=DA{m@^}KKQ^o;K=(OCMsPtX>sb||XO{Wala5zEDS`{+
z*17!W8)I43Be1_=on%UlO`Yn0sO|Q=qMvC0kHwYQ12JC&kB;#N4}xF!vohnLo4>Tv
zm+NES*qeh{XtcH=fs~`uHRbG%x%E|N6%Wn`rLr4>+2(wCfw%sN=;V*PO`PxxpChN)
z-MYXj7*^HxHi6uFPvv+1;HN@?8y7;zOrtA*{Xc3~lApy(zV{8L!pY}TG#&d?>*r#4
z-&eAhiM5%U-`4-KP6XA>iS>Pk1Gd1&MA_#0dxUv+iDI+eLF-E&7Vv>$2kjoS`6ajX
zL#dCffRlbwH3gqOa&z{*C;_~R_GlsUa3V%V*efkOx9iszLYGueDf`T-j<z01y#s_!
zu=}l{`}4&=uL2(=uqde=4;X3rZX!V~ux$}h{=9J|<wSRBqva!SRcj?tzpS*`c1HJ%
z-8k{_o>+oHwZa{+j0xZcpotwuWM0MEVV;}_`(+X3k89=KnJ`#V?nXtIwDNkq<RyoN
zBU_LhpVuBOw*}0R#h&WUp;aHxk3PO9Hn~yq2kVE;$2(S@mn$0@1--Ad(UiilGgWLn
z=TDrFW_*4x$P{7-+xvObK&Re#n)y3>Vfjf;!y^uB`1#OX9cp=I#(DyLozeU(nfx>y
zV|;7e_w{cR;qC|EF`jTV{V{BL`uo&3#gjaG+M!JZXiBiMYaPFkY<SF-K!+Jm!TM0v
zO8VpW(OEQggInO)Kk0{aMx><At5-u7k3Tv(<13&V+7~bSIZ%g6sbx!euRAffK#wt7
zN?{9-d8uu24SHtC`eb9tZ5Pen^fYz{{C>g;qMpB)F2Cj9D)ZF-Gviufud){$q++Mb
zW3A46rSHWPF4r-oV10j$5csEa5^Ttj-~1^CVdil33c*2CGcA>CK)kzImzwZ}`zF?X
zOqH!EkxkZLEVglv#{sMD|M!~ntC*k%8E0y}iLHH`k9+#(R5*`I9{%}Z@UH-Yn2~?+
z*4f1t+Zp!QnPWaXU%*@~;F2pZl7%<LV)t}LJg=4)u;%vbL<e!Ca{AEi0%YH&v8P$W
zp2EMOPKs*%q0U~^*iFui>HdRb%z@NymSTB=?U>Bd0>T&M_3cGHgP1OkZiDFe+sA>j
zua*UB7{_;~n{Q9N7VDHwNoG%tIaaiG?I_`aoa|nJz>^h&;^Rw8&+asbLv~sq=+UW?
zTa?$IrJY7LL=f|D{>3xT77fB>!EA_9E_cLv#r_wvIdx8Dn)jXGF0Tib@vCs&nGr}q
z9GB`2*Z27HJkx>rZSov^2RydUvpRh;OF#Pk^<!|mF`H947Hy+9#<xrAk0S+N>dUr)
zxxU1&Jl49EFS!f}+`QmA&e}t0nY8YL>I=E7X^$v7^yj^wqt5EW-_4Lj9$WhfiQ>R5
zC(i2x9RDHv*<4zI!E%%1ep`&9EN1SV#!i8rXweu;I_YCHb(hVEF61_Ia^S;4>65b+
zjd5y<LsLLAkYs~0n^2vg5FmK!R8QGsdpc=qG#lFOx%$2*LD-1vrhC~(G(@ao@wPT6
zW$jgkn^=W@*h%HKo!V;p0_;w705g5HKNx$fYinszrzI;yYD(*;6KY_Ekhna~s@^%<
zRsXq&&*lVD4}r)_0lYd{KP#p>cVF}C%qzV9+r~dWpbgSf_pVj)D++``&<2^4%GdJv
zGgqI*pQ{w)a7$#67Q%*s;WmS_D~MA?Vq-VxcZ2KfCYl`Fw(fwG7Oa0)UbitHLe6}N
zGGvc!l1@!fL#hYVh&YFy=UIKBaKuRwcp=jGZQ!&t>&y&AUMMQ9BR>nleMt5iEA8RT
z_7Of|z3=s@NH0M2CxF1xYC*C~Sfkfp?7YOb3|npWrluo!`r|W&wc<fBvhL5D*#4^f
zBQ$vLbzXE%T~O5m7psomGaTD{&exfbeMq~-4zIUA8VVhaPrmv*3mNmi7Bro({K}TW
zGa?Yyq*qgOtO>E`={6Abd55FM{qBzO*12zV`obYdgtD2LHrJ&8VEfY6Z@}EP(H=w7
zmff>VTj41EQ>$yMyk|Q4zk;l6uB`vbwB!HD^xgk{U*C>c-9xOVp`wOnKa%g-S_XHE
JZ$Ezip8zW4(=z}7

literal 0
HcmV?d00001

diff --git a/setup.py b/setup.py
index d88a41c..e7624c6 100644
--- a/setup.py
+++ b/setup.py
@@ -31,7 +31,7 @@ setup(
     packages=find_packages(exclude=["tests*"]),
     include_package_data=True,
     python_requires=">=3.5",
-    install_requires=["tutor-openedx"],
+    install_requires=["tutor-openedx", "requests"],
     entry_points={"tutor.plugin.v0": ["xqueue = tutorxqueue.plugin"]},
     classifiers=[
         "Development Status :: 3 - Alpha",
diff --git a/tutorxqueue/__about__.py b/tutorxqueue/__about__.py
index 0a8da88..d3ec452 100644
--- a/tutorxqueue/__about__.py
+++ b/tutorxqueue/__about__.py
@@ -1 +1 @@
-__version__ = "0.1.6"
+__version__ = "0.2.0"
diff --git a/tutorxqueue/patches/https-create b/tutorxqueue/patches/https-create
new file mode 100644
index 0000000..9d5d58d
--- /dev/null
+++ b/tutorxqueue/patches/https-create
@@ -0,0 +1 @@
+certbot certonly --standalone -n --agree-tos -m admin@{{ LMS_HOST }} -d {{ XQUEUE_HOST }}
\ No newline at end of file
diff --git a/tutorxqueue/patches/k8s-deployments b/tutorxqueue/patches/k8s-deployments
index 7cc0f14..79796e7 100644
--- a/tutorxqueue/patches/k8s-deployments
+++ b/tutorxqueue/patches/k8s-deployments
@@ -18,7 +18,7 @@ spec:
         - name: xqueue
           image: {{ DOCKER_REGISTRY }}{{ XQUEUE_DOCKER_IMAGE }}
           ports:
-            - containerPort: 8040
+            - containerPort: 8000
           env:
             - name: DJANGO_SETTINGS_MODULE
               value: xqueue.tutor
diff --git a/tutorxqueue/patches/k8s-ingress-rules b/tutorxqueue/patches/k8s-ingress-rules
new file mode 100644
index 0000000..1c5b7c3
--- /dev/null
+++ b/tutorxqueue/patches/k8s-ingress-rules
@@ -0,0 +1,6 @@
+- host: {{ XQUEUE_HOST }}
+  http:
+    paths:
+    - backend:
+        serviceName: nginx
+        servicePort: {% if ACTIVATE_HTTPS %}443{% else %}80{% endif %}
\ No newline at end of file
diff --git a/tutorxqueue/patches/k8s-ingress-tls-hosts b/tutorxqueue/patches/k8s-ingress-tls-hosts
new file mode 100644
index 0000000..50e7b1a
--- /dev/null
+++ b/tutorxqueue/patches/k8s-ingress-tls-hosts
@@ -0,0 +1 @@
+- {{ XQUEUE_HOST }}
\ No newline at end of file
diff --git a/tutorxqueue/patches/k8s-services b/tutorxqueue/patches/k8s-services
index d4a227e..057d2c6 100644
--- a/tutorxqueue/patches/k8s-services
+++ b/tutorxqueue/patches/k8s-services
@@ -6,7 +6,7 @@ metadata:
 spec:
   type: NodePort
   ports:
-    - port: 8040
+    - port: 8000
       protocol: TCP
   selector:
     app.kubernetes.io/name: xqueue
\ No newline at end of file
diff --git a/tutorxqueue/patches/nginx-extra b/tutorxqueue/patches/nginx-extra
new file mode 100644
index 0000000..56d9317
--- /dev/null
+++ b/tutorxqueue/patches/nginx-extra
@@ -0,0 +1,37 @@
+### Xqueue
+upstream xqueue-backend {
+    server xqueue:8000 fail_timeout=0;
+}
+
+{% if ACTIVATE_HTTPS %}
+server {
+    server_name {{ XQUEUE_HOST }};
+    listen 80;
+    return 301 https://$server_name$request_uri;
+}
+{% endif %}
+
+server {
+  {% if ACTIVATE_HTTPS %}listen 443 {{ "" if WEB_PROXY else "ssl" }};{% else %}listen 80;{% endif %}
+  server_name xqueue.localhost {{ XQUEUE_HOST }};
+
+  {% if ACTIVATE_HTTPS and not WEB_PROXY %}
+  ssl_certificate /etc/letsencrypt/live/{{ XQUEUE_HOST }}/fullchain.pem;
+  ssl_certificate_key /etc/letsencrypt/live/{{ XQUEUE_HOST }}/privkey.pem;
+  {% endif %}
+
+  # Disables server version feedback on pages and in headers
+  server_tokens off;
+
+  location / {
+    {% if not WEB_PROXY %}
+    proxy_set_header X-Forwarded-Proto $scheme;
+    proxy_set_header X-Forwarded-Port $server_port;
+    proxy_set_header X-Forwarded-For $remote_addr;
+    {% endif %}
+    proxy_set_header Host $http_host;
+    proxy_redirect off;
+
+    proxy_pass http://xqueue-backend;
+  }
+}
\ No newline at end of file
diff --git a/tutorxqueue/patches/openedx-common-settings b/tutorxqueue/patches/openedx-common-settings
index cdb3f10..7335b47 100644
--- a/tutorxqueue/patches/openedx-common-settings
+++ b/tutorxqueue/patches/openedx-common-settings
@@ -3,5 +3,5 @@ XQUEUE_INTERFACE = {
     "username": "{{ XQUEUE_AUTH_USERNAME }}",
     "password": "{{ XQUEUE_AUTH_PASSWORD }}"
   },
-  "url": "http://xqueue:8040"
+  "url": "http://xqueue:8000"
 }
\ No newline at end of file
diff --git a/tutorxqueue/plugin.py b/tutorxqueue/plugin.py
index e7946fb..fe22cc1 100644
--- a/tutorxqueue/plugin.py
+++ b/tutorxqueue/plugin.py
@@ -1,7 +1,13 @@
 from glob import glob
+import json
 import os
 
+import click
 import pkg_resources
+import requests
+
+from tutor import config as tutor_config
+from tutor.exceptions import TutorError
 
 from .__about__ import __version__
 
@@ -14,8 +20,9 @@ config = {
     },
     "defaults": {
         "VERSION": __version__,
-        "DOCKER_IMAGE": "overhangio/openedx-xqueue:{{ XQUEUE_VERSION }}",
         "AUTH_USERNAME": "lms",
+        "DOCKER_IMAGE": "overhangio/openedx-xqueue:{{ XQUEUE_VERSION }}",
+        "HOST": "xqueue.{{ LMS_HOST }}",
         "MYSQL_DATABASE": "xqueue",
         "MYSQL_USERNAME": "xqueue",
     },
@@ -39,3 +46,144 @@ def patches():
             content = patch_file.read()
             all_patches[name] = content
     return all_patches
+
+
+@click.group(help="Interact with the Xqueue server")
+def command():
+    pass
+
+
+@click.group(help="List and grade submissions")
+@click.pass_obj
+@click.option("-q", "--queue", default="openedx", show_default=True, help="Queue name")
+@click.option(
+    "-u",
+    "--url",
+    help="Xqueue server base url. By default, this value will be defined from the plugin configuration.",
+)
+def submissions(context, queue, url):
+    context.queue = queue
+    context.url = url
+
+
+@click.command(name="count", help="Count submissions in queue")
+@click.pass_obj
+def count_submissions(context):
+    print_result(context, "count_submissions", context.queue)
+
+
+@click.command(name="show", help="Show last submission")
+@click.pass_obj
+def show_submission(context):
+    print_result(context, "show_submission", context.queue)
+
+
+@click.command(name="grade", help="Grade a specific submission")
+@click.argument("submission_id")
+@click.argument("submission_key")
+@click.argument("grade", type=click.FLOAT)
+@click.argument("correct", type=click.BOOL)
+@click.argument("message")
+@click.pass_obj
+def grade_submission(context, submission_id, submission_key, grade, correct, message):
+    print_result(
+        context,
+        "grade_submission",
+        submission_id,
+        submission_key,
+        grade,
+        correct,
+        message,
+    )
+
+
+def print_result(context, client_func_name, *args, **kwargs):
+    user_config = tutor_config.load(context.root)
+    client = Client(user_config, url=context.url)
+    func = getattr(client, client_func_name)
+    result = func(*args, **kwargs)
+    print(json.dumps(result, indent=2))
+
+
+class Client:
+    def __init__(self, user_config, url=None):
+        self._session = None
+        self.username = user_config["XQUEUE_AUTH_USERNAME"]
+        self.password = user_config["XQUEUE_AUTH_PASSWORD"]
+
+        self.base_url = url
+        if not self.base_url:
+            scheme = "https" if user_config["ACTIVATE_HTTPS"] else "http"
+            host = host or user_config["XQUEUE_HOST"]
+            self.base_url = "{}://{}".format(scheme, host)
+        self.login()
+
+    @property
+    def session(self):
+        if self._session is None:
+            self._session = requests.Session()
+        return self._session
+
+    def url(self, endpoint):
+        # Don't forget to add a trailing slash to all endpoints: this is how xqueue
+        # works...
+        return self.base_url + endpoint
+
+    def login(self):
+        response = self.request(
+            "/xqueue/login/",
+            method="POST",
+            data={"username": self.username, "password": self.password},
+        )
+        message = response.get("content")
+        if message != "Logged in":
+            raise TutorError(
+                "Could not login to xqueue server at {}. Response: '{}'".format(
+                    self.base_url, message
+                )
+            )
+
+    def show_submission(self, queue):
+        response = self.request("/xqueue/get_submission/", params={"queue_name": queue})
+        if response["return_code"] != 0:
+            return response
+        data = json.loads(response["content"])
+        header = json.loads(data["xqueue_header"])
+        submission_body = json.loads(data["xqueue_body"])
+        submission_id = header["submission_id"]
+        submission_key = header["submission_key"]
+        return {
+            "id": submission_id,
+            "key": submission_key,
+            "body": submission_body,
+            "return_code": response["return_code"],
+        }
+
+    def count_submissions(self, queue):
+        return self.request("/xqueue/get_queuelen/", params={"queue_name": queue})
+
+    def grade_submission(self, submission_id, submission_key, grade, correct, msg):
+        return self.request(
+            "/xqueue/put_result/",
+            method="POST",
+            data={
+                "xqueue_header": json.dumps(
+                    {"submission_id": submission_id, "submission_key": submission_key}
+                ),
+                "xqueue_body": json.dumps(
+                    {"correct": correct, "score": grade, "msg": msg}
+                ),
+            },
+        )
+
+    def request(self, endpoint, method="GET", data=None, params=None):
+        func = getattr(self.session, method.lower())
+        response = func(self.url(endpoint), data=data, params=params)
+        # TODO handle errors >= 400 and non-parsable json responses
+        return response.json()
+
+
+submissions.add_command(count_submissions)
+submissions.add_command(show_submission)
+submissions.add_command(grade_submission)
+command.add_command(submissions)
diff --git a/tutorxqueue/templates/xqueue/apps/settings/tutor.py b/tutorxqueue/templates/xqueue/apps/settings/tutor.py
index 423cf62..33dfc1c 100644
--- a/tutorxqueue/templates/xqueue/apps/settings/tutor.py
+++ b/tutorxqueue/templates/xqueue/apps/settings/tutor.py
@@ -1,21 +1,27 @@
 from .settings import *
 
+ALLOWED_HOSTS = [
+    "{{ XQUEUE_HOST }}",
+    "xqueue",
+    "xqueue.localhost",
+]
+
 DATABASES = {
     "default": {
         "ENGINE": "django.db.backends.mysql",
         "HOST": "{{ MYSQL_HOST }}",
-        "PORT": {{MYSQL_PORT}},
+        "PORT": {{ MYSQL_PORT }},
         "NAME": "{{ XQUEUE_MYSQL_DATABASE }}",
         "USER": "{{ XQUEUE_MYSQL_USERNAME }}",
         "PASSWORD": "{{ XQUEUE_MYSQL_PASSWORD }}",
-        "OPTIONS": {
-            "init_command": "SET sql_mode='STRICT_TRANS_TABLES'",
-        },
+        "OPTIONS": {"init_command": "SET sql_mode='STRICT_TRANS_TABLES'",},
     }
 }
 
 LOGGING = get_logger_config(log_dir="/openedx/data/", logging_env="tutor", dev_env=True)
+LOGGING["loggers"][""]["handlers"].append("console")
 
 SECRET_KEY = "{{ XQUEUE_SECRET_KEY }}"
 
-XQUEUE_USERS = {"{{ XQUEUE_AUTH_USERNAME }}": "{{ XQUEUE_AUTH_PASSWORD}}"}
+USERS = {"{{ XQUEUE_AUTH_USERNAME }}": "{{ XQUEUE_AUTH_PASSWORD}}"}
+XQUEUES = {"openedx": None}
diff --git a/tutorxqueue/templates/xqueue/build/xqueue/Dockerfile b/tutorxqueue/templates/xqueue/build/xqueue/Dockerfile
index 45273ae..8168fce 100644
--- a/tutorxqueue/templates/xqueue/build/xqueue/Dockerfile
+++ b/tutorxqueue/templates/xqueue/build/xqueue/Dockerfile
@@ -11,5 +11,5 @@ WORKDIR /openedx/xqueue
 
 RUN pip install -r requirements.txt
 
-EXPOSE 8040
-CMD gunicorn --workers=2 --name xqueue --bind=0.0.0.0:8040 --max-requests=1000 xqueue.wsgi:application
+EXPOSE 8000
+CMD gunicorn --workers=2 --name xqueue --bind=0.0.0.0:8000 --max-requests=1000 xqueue.wsgi:application
diff --git a/tutorxqueue/templates/xqueue/hooks/xqueue/init b/tutorxqueue/templates/xqueue/hooks/xqueue/init
index f0c3d44..d65fc76 100644
--- a/tutorxqueue/templates/xqueue/hooks/xqueue/init
+++ b/tutorxqueue/templates/xqueue/hooks/xqueue/init
@@ -1 +1,2 @@
 ./manage.py migrate
+./manage.py update_users