Update the Docker configuration

Author: meyerbaptiste

deployment/docker.md

@@ -4,11 +4,26 @@ API Platform projects can be run through [Docker](https://www.docker.com/).
 A [Docker compose](https://docs.docker.com/compose/) configuration including a fully working [LAMP](https://en.wikipedia.org/wiki/LAMP_(software_bundle))
 stack is shipped with the API Platform distribution.
 
+## Services
+
+The Docker Compose configuration comes with several ready-use services by default:
+
+| Name    | Description                                                   | Port(s)
+| ------- | ------------------------------------------------------------- | -------
+| app     | The application with PHP and PHP-FPM 7.1, the latest Composer | N/A
+| db      | A database provided by MySQL 5.7                              | N/A
+| nginx   | An HTTP server provided by Nginx 1.11                         | 8080
+| varnish | An HTTP cache provided by Varnish 4.1                         | 80
+
+## Installation
+
 To install it, run the following commands (Docker must be installed on your system):
 
     $ docker-compose up -d # Download, build and run Docker images
     $ docker-compose exec app bin/console doctrine:schema:create # Create the MySQL schema
 
-Your project will be accessible at the URL `http://127.0.0.1`.
+Your project will be accessible in two different ways:
+* Through the HTTP cache (Varnish): `http://localhost`
+* Through the HTTP server directly (Nginx) to facilitate debugging: `http://localhost:8080`
 
 Previous chapter: [Deploying an API Platform App on Heroku](heroku.md)

distribution/index.md

@@ -96,12 +96,9 @@ Instead of using Docker, API Platform can also be installed on the local machine
 Then, enter the project folder, create the database and its schema:  
 
     $ cd bookshop-api
-    $ bin/console doctrine:database:create
-    $ bin/console doctrine:schema:create
-    
-And start the server:    
-
-    $ bin/console server:run
+    $ docker-compose up -d
+    $ docker-compose exec app bin/console doctrine:database:create
+    $ docker-compose exec app bin/console doctrine:schema:create
 
 ## It's ready!
 

distribution/testing.md

@@ -160,11 +160,11 @@ The API Platform flavor of Behat also comes with a temporary SQLite database ded
 
 Clear the cache of the `test` environment:
 
-    $ docker-compose app bin/console cache:clear --env=test
+    $ docker-compose exec app bin/console cache:clear --env=test
 
 Then run:
 
-    $ docker-compose run --rm app vendor/bin/behat
+    $ docker-compose exec app vendor/bin/behat
 
 Everything should be green now. Your Linked Data API is now specified and tested thanks to Behat!
 

schema-generator/getting-started.md

@@ -53,7 +53,7 @@ types:
 
 Run the generator with this config file as parameter:
 
-    $ docker-compose exec app vendor/bin/schema generate-types src/ app/config/schema.yml
+    $ vendor/bin/schema generate-types src/ app/config/schema.yml
 
 The following classes will be generated:
 
@@ -745,7 +745,7 @@ When cardinality cannot be automatically extracted, it's value is set to `unknow
 
 Usage:
 
-    $ docker-compose exec app vendor/bin/schema extract-cardinalities
+    $ vendor/bin/schema extract-cardinalities
 
 Previous chapter: [Introduction](index.md)