Clean README

Signed-off-by: Christopher Crone <christopher.crone@docker.com>
This commit is contained in:
Christopher Crone 2020-03-11 13:20:49 +01:00
parent 429ff2a9bd
commit aa068a05cd

View File

@ -2,45 +2,64 @@
![logo](awesome-compose.jpg)
> A curated list of docker-compose application samples.
The purpose of these samples is to provide a quick start on how to integrate different services with a Compose file and to quickly manage their deployment with docker-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
## Getting Started
These instructions will get you through the bootstrap phase of creating and deploying samples of containerized applications with docker-compose.
These instructions will get you through the bootstrap phase of creating and
deploying samples of containerized applications with docker-compose.
### Prerequisites
Make sure you have docker and docker-compose installed. Download all or any of the samples in the `samples` directory.
* Make sure that you have Docker and docker-compose installed
* Windows or macOS:
[Install Docker Desktop](https://www.docker.com/get-started)
* Linux: [Install Docker](https://www.docker.com/get-started) and then
[docker-compose](https://github.com/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 describing the configuration of service components. All samples can be run in local environment by going into the root directory of each one and doing:
```
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:
```console
docker-compose up -d
```
Check the `README.md` of each sample to get more details on the structure and what is the expected output.
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:
```
```console
docker-compose down
```
## Contents
*Samples of docker-compose applications with multiple integrated services:*
*Samples of Docker Compose applications with multiple integrated services:*
- [`ASP.NET / MS-SQL`](samples/aspnet-mssql) -- sample ASP.NET core application with MS SQL server database
- [`Go / NGINX / MySQL`](samples/nginx-golang-mysql) -- sample Go application with an Nginx proxy and a MySQL database
- [`Go / NGINX / PostgreSQL`](samples/nginx-golang-postgres) -- sample Go application with an Nginx proxy and a PostgreSQL database
- [`Java Spark / MySQL`](samples/sparkjava-mysql) -- sample Java application and a MySQL database
- [`NGINX / Flask / MongoDB`](samples/nginx-flask-mongo) -- sample Python/Flask application with Nginx proxy and a Mongo database
- [`NGINX / Flask / MySQL`](samples/nginx-flask-mysql) -- sample Python/Flask application with an Nginx proxy and a MySQL database
- [`ASP.NET / MS-SQL`](samples/aspnet-mssql) -- sample ASP.NET core application
with MS SQL server database
- [`Go / NGINX / MySQL`](samples/nginx-golang-mysql) -- sample Go application
with an Nginx proxy and a MySQL database
- [`Go / NGINX / PostgreSQL`](samples/nginx-golang-postgres) -- sample Go
application with an Nginx proxy and a PostgreSQL database
- [`Java Spark / MySQL`](samples/sparkjava-mysql) -- sample Java application and
a MySQL database
- [`NGINX / Flask / MongoDB`](samples/nginx-flask-mongo) -- sample Python/Flask
application with Nginx proxy and a Mongo database
- [`NGINX / Flask / MySQL`](samples/nginx-flask-mysql) -- sample Python/Flask
application with an Nginx proxy and a MySQL database
- [`NGINX / Go`](samples/nginx-golang) -- sample Nginx proxy with a Go backend
- [`React / Spring / MySQL`](samples/react-java-mysql) -- sample React application with a Spring backend and a MySQL database
- [`React / Express / MySQL`](samples/react-express-mysql) -- sample React application with a NodeJS backend and a MySQL database
- [`Spring / PostgreSQL`](samples/spring-postgres) -- sample Java application with Spring framework and a Postgres database
- [`React / Spring / MySQL`](samples/react-java-mysql) -- sample React
application with a Spring backend and a MySQL database
- [`React / Express / MySQL`](samples/react-express-mysql) -- sample React
application with a NodeJS backend and a MySQL database
- [`Spring / PostgreSQL`](samples/spring-postgres) -- sample Java application
with Spring framework and a Postgres database
*Single service samples:*
- [`Angular`](samples/angular)
@ -49,5 +68,5 @@ docker-compose down
## Contribute
We welcome examples that help people understand how to use docker-compose with common applications.
We welcome examples that help people understand how to use docker-compose for
common applications.