awesome-compose

History

Chad Metcalf 702ec96821 Adding a Makefile and basic tests. This approach uses bats to create a generic docker-compose test. It checks that images are pullable, projects are buildable, up works, and if ports are exposed that something is listening. The tests can be tailored for each example. As long as they are the same though, you can edit lib/test.bats.example and then `make update-tests` and all the tests will be synced. Signed-off-by: Chad Metcalf <chad@docker.com>		2020-08-08 14:26:52 -07:00
..
backend	Move all samples to the root dir	2020-03-16 17:23:59 +01:00
frontend	Move all samples to the root dir	2020-03-16 17:23:59 +01:00
docker-compose.yml	nginx-golang fix some minor typos (#49 )	2020-04-12 21:42:42 +02:00
README.md	nginx-golang fix some minor typos (#49 )	2020-04-12 21:42:42 +02:00
test.bats	Adding a Makefile and basic tests.	2020-08-08 14:26:52 -07:00

README.md

Compose sample application

NGINX proxy with GO backend

Project structure:

.
├── backend
│   ├── Dockerfile
│   └── main.go
├── docker-compose.yml
├── frontend
│   ├── Dockerfile
│   └── nginx.conf
└── README.md

docker-compose.yaml

version: "3.7"
services:
  frontend:
    build: frontend
    ports:
      - 80:80
    depends_on:
      - backend
  backend:
    build: backend

The compose file defines an application with two services frontend and backend. When deploying the application, docker-compose maps port 80 of the frontend service container to the same port of the host as specified in the file. Make sure port 80 on the host is not already in use.

Deploy with docker-compose

$ docker-compose up -d
Creating network "nginx-golang_default" with the default driver
Building backend
Step 1/7 : FROM golang:1.13 AS build
1.13: Pulling from library/golang
...
Successfully built 4b24f27138cc
Successfully tagged nginx-golang_frontend:latest
WARNING: Image for service frontend was built because it did not already exist. To rebuild this image you must use `docker-compose build` or `docker-compose up --build`.
Creating nginx-golang_backend_1 ... done
Creating nginx-golang_frontend_1 ... done

Expected result

Listing containers must show two containers running and the port mapping as below:

$ docker ps
CONTAINER ID        IMAGE                   COMMAND                  CREATED             STATUS              PORTS                  NAMES
8bd5b0d78e73        nginx-golang_frontend   "nginx -g 'daemon of…"   53 seconds ago      Up 52 seconds       0.0.0.0:80->80/tcp     nginx-golang_frontend_1
56f929c240a0        nginx-golang_backend    "/usr/local/bin/back…"   53 seconds ago      Up 53 seconds                              nginx-golang_backend_1

After the application starts, navigate to http://localhost:80 in your web browser or run:

$ curl localhost:80

          ##         .
    ## ## ##        ==
 ## ## ## ## ##    ===
/"""""""""""""""""\___/ ===
{                       /  ===-
\______ O           __/
 \    \         __/
  \____\_______/

	
Hello from Docker!

Stop and remove the containers

$ docker-compose down