It's possible to run 'manage.py' commands when using the Docker
container but this is not documented anywhere. Clarify this.

Signed-off-by: Stephen Finucane <[email protected]>
Cc: Daniel Axtens <[email protected]>
---
 docs/development/installation.md | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)

diff --git a/docs/development/installation.md b/docs/development/installation.md
index cfcc63a..bf1ff5b 100644
--- a/docs/development/installation.md
+++ b/docs/development/installation.md
@@ -29,25 +29,34 @@ configure Patchwork using Docker:
 
 To run a shell within this environment, run:
 
-    $ docker-compose run --rm web --shell
+    $ docker-compose run web --shell
+
+To run django-manage commands, such as `createsuperuser` or `migrate`, run:
+
+    $ docker-compose run web python manage.py createsuperuser
 
 To run unit tests, excluding Selenium UI interaction tests, using only the
 package versions installed during container initialization, run:
 
-    $ docker-compose run --rm web --quick-test
+    $ docker-compose run web --quick-test
 
 To run the same against all supported versions of Django (via tox), run:
 
-    $ docker-compose run --rm web --quick-tox
+    $ docker-compose run web --quick-tox
+
+To run specific tox targets or tests, pass arguments to the above:
+
+    $ docker-compose run web --quick-tox -e py27-django17 \
+        patchwork.tests.test_bundles
 
 To run all tests, including Selenium UI interaction tests, using only the
 package versions installed container initialization, run:
 
-    $ docker-compose run --rm web --test
+    $ docker-compose run web --test
 
 To run the same against all supported versions of Django (via tox), run:
 
-    $ docker-compose run --rm web --tox
+    $ docker-compose run web --tox
 
 To run all tests, including Selenium UI interaction tests in non-headless mode,
 run:
-- 
2.9.3

_______________________________________________
Patchwork mailing list
[email protected]
https://lists.ozlabs.org/listinfo/patchwork

Reply via email to