Contains the development environment required to build, run and develop the Foodkit API and consumer website.

Install Docker. You can get it for Windows, Mac OSX, Ubuntu and a range of other *nix distributions.

To get started, you should place this repository in the parent folder of the api and consumer-web projects.

That is, your folder structure should be as such:

/parent-folder
  |- api
  |- consumer-web
  |- docker-dev-environment

You'll need to prepare both codebases by running composer install in each folder. After this, you can go ahead and bring up the Docker containers:

cd docker-dev-environment
docker-compose up -d

You should now have an API server running on http://localhost:8888 and a consumer web server running on http://localhost:8889.

The scripts will add mount points on the containers that link directly back to the host file system. You can edit the files in the ../consumer-web and ../api folders and they will be instantly reflected inside the Docker containers.

docker-compose exec api-app php artisan migrate --force

The Docker configuration will port-forward PostGRES to 54321 on your local machine. You can connect using:

psql -U postgres -h localhost -p 54321

The Redis container is shared between API and website, so you only need to do it once for both:

docker-compose exec api-app php artisan cache:clear

For the API:

docker-compose exec api-app tail -f storage/logs/laravel.log

... and the website:

docker-compose exec consumer-web-app tail -f storage/logs/laravel.log

@TODO

There's currently no easy way to do this apart from manually bootstrapping and running phpunit via docker-compose exec....

You can check that all the processes are running as expected using the following command:

docker-compose ps

You should see a list of the containers:

                  Name                                 Command               State               Ports
------------------------------------------------------------------------------------------------------------------
dockerdevenvironment_api-app_1              php-fpm                          Up      9000/tcp
dockerdevenvironment_api-nginx_1            nginx -g daemon off;             Up      443/tcp, 0.0.0.0:8888->80/tcp
dockerdevenvironment_consumer-web-app_1     php-fpm                          Up      9000/tcp
dockerdevenvironment_consumer-web-nginx_1   nginx -g daemon off;             Up      443/tcp, 0.0.0.0:8889->80/tcp
dockerdevenvironment_database_1             docker-entrypoint.sh postgres    Up      0.0.0.0:54321->5432/tcp
dockerdevenvironment_redis_1                docker-entrypoint.sh redis ...   Up      0.0.0.0:32768->6379/tcp

Look at the "state" column. If any of them are not "Up" that's probably where you want to start. You can check the log for the container process using:

docker-compose logs api-app --follow

If all hope is lost, you can rebuild the containers:

# Stop and delete containers
docker-compose down

# Rebuild images:
docker-compose build

# Restart containers (daemonised):
docker-compose up -d

See the list of open issues here.