awesome-compose README

The project's README from github.com/docker/awesome-compose. As one markdown file: README.md.

Awesome Compose Awesome

logo

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.

Note The following samples are intended for use in local development environments such as project setups, tinkering with software stacks, etc. These samples must not be deployed in production environments.

Contents

Samples of Docker Compose applications with multiple integrated services

Docker + wasm Icon indicates Sample is compatible with Docker+Wasm.

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

Running a sample

The root directory of each sample contains the 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

Quickstart guides

In addition to all the ready to run Compose samples listed above the folder official-documentation-samples contains quickstart guides. Each of these step by step guides explain which files need to be created to build and run a Docker Compose application.

Contribute

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

awesome-compose (docker/awesome-compose)

Searching Database…

Что это такое?Awesome Compose — это отобранный список примеров для Docker Compose: готовые конфигурации проектов, показывающие, как связать разные сервисы через Compose-файл и управлять их запуском с помощью Docker Compose.
То есть это список, а не инструмент — что именно входит в каждый пример?Каждый пример — это небольшая папка проекта, где compose.yaml описывает его сервисы. Вы просто смотрите список и берёте подходящую под ваш стек конфигурацию — ничего устанавливать не нужно.
Как запустить один из этих примеров?Выберите пример, зайдите в его корневую папку и запустите оттуда через Docker Compose; README.md самого примера объясняет его структуру и то, какой результат должен получиться.
Что должно быть установлено на моём компьютере, чтобы пример запустился?Только Docker с Compose: Docker Desktop на Windows или macOS, а на Linux — Docker и Docker Compose, установленные отдельно.
Можно ли брать эти конфигурации в продакшен?Нет. В README сказано, что примеры предназначены для локальной разработки — учебных проектов и экспериментов, — и использовать их в продакшене нельзя.
Какие стеки охватывает этот список?Три группы: приложения из нескольких сервисов (бэкенды на React, Spring, Go, Flask, Node.js или Rust с базами данных и прокси Nginx), примеры с одним сервисом вроде Django, сервера Minecraft или Wireguard и личные конфигурации — Nextcloud, Pi-hole, Prometheus/Grafana и WordPress.
Есть ли примеры с WebAssembly?Да. Среди примеров WasmEdge есть Wasm-приложение с статическим HTML-фронтендом, чей микросервис на Rust работает в рантайме WasmEdge вместе с MySQL, а также воркер для переноса данных из Kafka в MySQL; значком помечено, какие примеры совместимы с Docker+Wasm.
Я вообще не знаком с Compose — есть что-то попроще, чем эти примеры?Да, в папке official-documentation-samples есть пошаговые руководства для быстрого старта, которые объясняют, какие файлы нужно создать, чтобы собрать и запустить приложение на Docker Compose.
Creator
docker
Size
11.2 MB
Stars
46.5K
Updated
CommitJun 15
Age
6y
Commits · 90 Days