Awesome Docker Compose samples

Go to file

Chad Metcalf e059c77a47 Allow testing for just examples with changed files. The full test suite takes a long time to test. Generally changes in this repo only will change one project. So lets find the directories with changes and only test those. By default we will compare against origin/master which should cover testing PRs. If you're doing development and want to test your current changes you could do: BASE_REF=HEAD make test-changed Or if you're testing against your fork: BASE_REF=myremote/branch make test-changed Signed-off-by: Chad Metcalf <chad@docker.com>		2020-08-09 15:09:04 -07:00
.github	Compliance to awesome repository requirements	2020-03-27 11:38:54 +01:00
angular	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
apache-php	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
aspnet-mssql	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
django	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
elasticsearch-logstash-kibana	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
flask	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
gitea-postgres	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
lib	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
nextcloud-postgres	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
nextcloud-redis-mariadb	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
nginx-flask-mongo	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
nginx-flask-mysql	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
nginx-golang	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
nginx-golang-mysql	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
nginx-golang-postgres	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
prometheus-grafana	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
react-express-mongodb	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
react-express-mysql	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
react-java-mysql	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
react-rust-postgres	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
sparkjava	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
sparkjava-mysql	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
spring-postgres	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
traefik-golang	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
vuejs	Don't parse empty strings.	2020-08-09 15:09:03 -07:00
wordpress-mysql	Don't parse empty strings.	2020-08-09 15:09:03 -07: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
CONTRIBUTING.md	Compliance to awesome repository requirements	2020-03-27 11:38:54 +01:00
LICENSE	Update License to CC0	2020-03-26 09:44:12 +01:00
MAINTAINERS	Compliance to awesome repository requirements	2020-03-27 11:38:54 +01:00
Makefile	Allow testing for just examples with changed files.	2020-08-09 15:09:04 -07:00
README.md	Merge pull request #71 from thyrlian/master	2020-07-24 11:34:58 +02: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.

Samples of Docker Compose applications with multiple integrated services.
Single service samples.
Basic setups for different platforms (not production ready - useful for personal use).

Samples of Docker Compose applications with multiple integrated services

ASP.NET / MS-SQL - Sample ASP.NET core application with MS SQL server database.
Elasticsearch / Logstash / Kibana - Sample Elasticsearch, Logstash, and Kibana stack.
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 Node.js backend and a MySQL database.
React / Rust / PostgreSQL - Sample React application with a Rust backend and a Postgres database.
Spring / PostgreSQL - Sample Java application with Spring framework and a Postgres database.

Single service samples

Basic setups for different platforms (not production ready - useful for personal use)

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 from this repository.

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 all containers of the sample application run:

docker-compose down

Contribute

We welcome examples that help people understand how to use Docker Compose for common applications. Check the Contribution Guide for more details.