[#7995] move setup commands to start of docker section; easier to just copy and paste them
diff --git a/Allura/docs/getting_started/installation.rst b/Allura/docs/getting_started/installation.rst
index 029e21a..36df424 100644
--- a/Allura/docs/getting_started/installation.rst
+++ b/Allura/docs/getting_started/installation.rst
@@ -227,8 +227,52 @@
Using Docker
------------
-General info
-^^^^^^^^^^^^
+First run
+^^^^^^^^^
+
+`Download the latest release <http://www.apache.org/dyn/closer.cgi/allura/>`_ of Allura, or `clone from git <https://forge-allura.apache.org/p/allura/git/ci/master/tree/>`_ for the bleeding edge.
+
+Install `Docker <http://docs.docker.com/installation/>`_ and `Docker Compose <https://docs.docker.com/compose/install/>`_.
+
+Build/fetch all required images (run these in allura source directory):
+
+.. code-block:: bash
+
+ docker-compose build
+
+Install requirements:
+
+.. code-block:: bash
+
+ docker-compose run web pip install -r requirements.txt
+
+Install Allura packages:
+
+.. code-block:: bash
+
+ docker-compose run web ./rebuild-all.bash
+
+Initialize database with test data:
+
+.. code-block:: bash
+
+ docker-compose run web bash -c 'cd Allura && paster setup-app docker-dev.ini'
+
+.. note::
+
+ If you want to skip test data creation you can instead run: :code:`docker-compose run web bash -c 'cd Allura && ALLURA_TEST_DATA=False paster setup-app docker-dev.ini'`
+
+Start containers in the background:
+
+.. code-block:: bash
+
+ docker-compose up -d
+
+You're up and running! Visit localhost:8080 or on a Mac or Windows, whatever IP address Docker Toolbox is using. Then
+see our :ref:`post-setup-instructions` and read more below about the Docker environment for Allura.
+
+Containers
+^^^^^^^^^^
Allura runs on the following docker containers:
@@ -268,49 +312,6 @@
- 8825 - incoming mail listener
- 27017 - mongodb
-First run
-^^^^^^^^^
-
-`Download the latest release <http://www.apache.org/dyn/closer.cgi/allura/>`_ of Allura, or `clone from git <https://forge-allura.apache.org/p/allura/git/ci/master/tree/>`_ for the bleeding edge.
-
-Install `Docker <http://docs.docker.com/installation/>`_ and `Docker Compose <https://docs.docker.com/compose/install/>`_.
-
-Build/fetch all required images (run these in allura source directory):
-
-.. code-block:: bash
-
- ~$ docker-compose build
-
-Install requirements:
-
-.. code-block:: bash
-
- ~$ docker-compose run web pip install -r requirements.txt
-
-Install Allura packages:
-
-.. code-block:: bash
-
- ~$ docker-compose run web ./rebuild-all.bash
-
-Initialize database with test data:
-
-.. code-block:: bash
-
- ~$ docker-compose run web bash -c 'cd Allura && paster setup-app docker-dev.ini'
-
-If you want to skip test data creation you can instead run:
-
-.. code-block:: bash
-
- ~$ docker-compose run web bash -c 'cd Allura && ALLURA_TEST_DATA=False paster setup-app docker-dev.ini'
-
-Start containers in the background:
-
-.. code-block:: bash
-
- ~$ docker-compose up -d
-
Useful commands
^^^^^^^^^^^^^^^
@@ -318,48 +319,48 @@
.. code-block:: bash
- ~$ docker-compose up -d
+ docker-compose up -d
View logs from all services:
.. code-block:: bash
- ~$ docker-compose logs
+ docker-compose logs
You can specify one or more services to view logs only from them, e.g. to see
outgoing mail:
.. code-block:: bash
- ~$ docker-compose logs outmail
+ docker-compose logs outmail
Update requirements and reinstall apps:
.. code-block:: bash
- ~$ docker-compose run web pip install -r requirements.txt
- ~$ docker-compose run web ./rebuild-all.bash
+ docker-compose run web pip install -r requirements.txt
+ docker-compose run web ./rebuild-all.bash
You may want to restart at least "taskd" container after that in order for it to
-pick up changes.
+pick up changes. Run :code:`docker-compose restart taskd`
Running all tests:
.. code-block:: bash
- ~$ docker-compose run web ./run_tests
+ docker-compose run web ./run_tests
Running subset of tests:
.. code-block:: bash
- ~$ docker-compose run web bash -c 'cd ForgeGit && nosetests forgegit.tests.functional.test_controllers:TestFork'
+ docker-compose run web bash -c 'cd ForgeGit && nosetests forgegit.tests.functional.test_controllers:TestFork'
Connecting to mongo using a container:
.. code-block:: bash
- ~$ docker-compose run mongo mongo --host mongo
+ docker-compose run mongo mongo --host mongo
.. _post-setup-instructions: