doc/ops/docker.rst

   1 Using Docker
   2 ============
   3
   4 mygpo can be run using `Docker <https://docker.com/>`_.
   5
   6
   7 Database
   8 --------
   9
  10 The image requires a PostgreSQL server, specified either via
  11
  12 * a `linked container <https://docs.docker.com/userguide/dockerlinks/>`_
  13   called ``db`` containing a server with a database called ``mygpo``, a user
  14   called ``mygpo`` with a password ``mygpo``.
  15 * A ``DATABASE_URL`` environment variable (eg
  16   ``postgres://USER:PASSWORD@HOST:PORT/NAME``)
  17
  18 Using a PostgreSQL Docker container
  19 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  20
  21 Start a container using the `official PostgreSQL image <https://registry.hub.docker.com/_/postgres/>`_. ::
  22
  23     docker run --name db -d postgres
  24
  25 Create the schema and a corresponding user ::
  26
  27     docker exec -it db psql -U postgres
  28
  29 And enter the following commands (change passwords as required)
  30
  31 .. literalinclude:: ../../contrib/init-db.sql
  32     :language: sql
  33     :linenos:
  34
  35 Initialize the tables. This needs needs to be run for every update. ::
  36
  37     sudo docker run --rm --link db:db -e SECRET_KEY=asdf mygpo/web python manage.py migrate
  38
  39
  40 Elasticsearch
  41 -------------
  42
  43
  44 Redis
  45 -----
  46
  47
  48 Web Frontend
  49 ------------
  50
  51 The image exposes the web interface on port 8000.
  52
  53
  54 Celery Worker
  55 -------------
  56
  57
  58 Celery Heartbeat
  59 ----------------
  60
  61