Awesome Docker Compose samples

Go to file

Christopher Crone aa068a05cd Clean README Signed-off-by: Christopher Crone <christopher.crone@docker.com>		2020-03-11 13:25:45 +01:00
samples	Update README.md	2020-03-09 14:10:22 +01:00
.gitattributes	repo init	2020-02-12 18:16:42 +01:00
awesome-compose.jpg	repo init	2020-02-12 18:16:42 +01:00
LICENSE	add license	2020-03-05 19:54:20 +01:00
README.md	Clean README	2020-03-11 13:25:45 +01:00

README.md

Awesome Compose

A curated list of Docker Compose samples. These samples provide a starting point for how to integrate different services using a Compose file and to manage their deployment with docker-compose.

Getting started

These instructions will get you through the bootstrap phase of creating and deploying samples of containerized applications with docker-compose.

Prerequisites

Make sure that you have Docker and docker-compose installed
- Windows or macOS: Install Docker Desktop
- Linux: Install Docker and then docker-compose
Download some or all of the samples in the samples directory

Running a sample

The root directory of each sample contains the docker-compose.yaml which describes the configuration of service components. All samples can be run in a local environment by going into the root directory of each one and executing:

docker-compose up -d

Check the README.md of each sample to get more details on the structure and what is the expected output. To stop and remove the all containers of the sample application run:

docker-compose down

Samples of Docker Compose applications with multiple integrated services:

ASP.NET / MS-SQL -- sample ASP.NET core application with MS SQL server database
Go / NGINX / MySQL -- sample Go application with an Nginx proxy and a MySQL database
Go / NGINX / PostgreSQL -- sample Go application with an Nginx proxy and a PostgreSQL database
Java Spark / MySQL -- sample Java application and a MySQL database
NGINX / Flask / MongoDB -- sample Python/Flask application with Nginx proxy and a Mongo database
NGINX / Flask / MySQL -- sample Python/Flask application with an Nginx proxy and a MySQL database
NGINX / Go -- sample Nginx proxy with a Go backend
React / Spring / MySQL -- sample React application with a Spring backend and a MySQL database
React / Express / MySQL -- sample React application with a NodeJS backend and a MySQL database
Spring / PostgreSQL -- sample Java application with Spring framework and a Postgres database

Single service samples:

Contribute

We welcome examples that help people understand how to use docker-compose for common applications.