Docker Web Stack

Overview

Docker Compose makes it easy to interconnect various Docker images. What better way to showcase its features than by creating (yet another) LEMP stack. This is one is much more bleeding edge than others, though 😉.

What's inside

A docker-compose-powered stack to get your PHP project running in no time.

PHP-FPM 7.1
nginx
MariaDB
Node w/ Yarn

Requirements

Docker v17.03.1-ce or higher
docker-compose v1.11.2 or higher

How-to (simple)

To start the stack, run:

    docker-compose up -d --build --remove-orphans

The -d flag daemonises the stack.
The --build builds services (e.g. php-fpm, nginx) that comprise the stack.
The --remove-orphans stack ensures that services that aren't being used are deleted (to save disk space).

Provided that no errors were emitted during the start, you should be able to visit your browser on http://localhost:8080.

To stop the stack, run:

    docker-compose stop

To ensure that all services have stopped, run:

    docker-compose ps

There should be no more services running.

To connect to the MariaDB service, run:

    docker-compose exec mariadb mysql -uapp -p

This command uses the app user. There is also a root user.
Use the password defined on the docker-compose.yml file.

To install composer dependencies, run:

    docker-compose run --rm composer install

The --rm flag ensures that that intermediate (temporary) containers are deleted once you install packages (to save disk space).
The service's data is mounted on the ./mariadb host folder, which means that data will persist between docker-compose ups and stops.

To install npm packages, run:

    docker-compose run --rm yarn add [name-of-package]

yarn is faster than npm and contains a lockfile (yarn.lock), for deterministic dependency resolution.

How-to (advanced)

If you want to extend the functionality of a service (e.g. php-fpm), you have to re-build it.

To accomplish this, modify the Dockerfile, then run:

    docker-compose build --no-cache --force-rm [name-of-service]

... followed by a docker-compose up [arguments...]

If you want to use a different web server port (e.g. 80), modify the port on the docker-compose.yml file and start the stack again.

Gotchas

Ensure that the host machine ports 8080 (web server) and 3306 (database) are open on your host machine.

Warranties

This stack was built on macOS Sierra v10.12.5. Experience may vary on other operating systems.

Attributions

This wouldn't be possible without being granted a role as Software Developer at Pixel Fusion, an award-winning product development company at Parnell, Auckland.
This project was greatly inspired by the Laradock project.

bryanagee / docker-web-stack