Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
http://orchardup.github.io/fig/
Define and run multi-container applications with Docker
http://orchardup.github.io/fig/
docker docker-compose go golang orchestration
Last synced: 3 months ago
JSON representation
Define and run multi-container applications with Docker
- Host: GitHub
- URL: http://orchardup.github.io/fig/
- Owner: docker
- License: apache-2.0
- Created: 2013-12-09T11:40:58.000Z (over 10 years ago)
- Default Branch: main
- Last Pushed: 2024-03-26T15:07:28.000Z (3 months ago)
- Last Synced: 2024-03-26T15:39:10.106Z (3 months ago)
- Topics: docker, docker-compose, go, golang, orchestration
- Language: Go
- Homepage: https://docs.docker.com/compose/
- Size: 24.3 MB
- Stars: 32,133
- Watchers: 716
- Forks: 5,014
- Open Issues: 227
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Lists
- awesome-sysadmin - Fig - Fast, isolated development environments using Docker. (Software Containers)
- awesome-sysadmin2 - Fig - Fast, isolated development environments using Docker. (Software Containers / Error Monitoring)
- awesome-sysadmin2 - Fig - Fast, isolated development environments using Docker. (Software Containers / Error Monitoring)
- awesome-devops - Fig - Fast, isolated development environments using Docker. (Software Containers)
- awesome-sysadmin - Fig - Fast, isolated development environments using Docker. (Software Containers)
- awesome-sysadmin - Fig - Fast, isolated development environments using Docker. (Software Containers)
README
# Table of Contents
- [Docker Compose v2](#docker-compose-v2)
- [Where to get Docker Compose](#where-to-get-docker-compose)
+ [Windows and macOS](#windows-and-macos)
+ [Linux](#linux)
- [Quick Start](#quick-start)
- [Contributing](#contributing)
- [Legacy](#legacy)
# Docker Compose v2
[](https://github.com/docker/compose/releases/latest)
[](https://pkg.go.dev/github.com/docker/compose/v2)
[](https://github.com/docker/compose/actions?query=workflow%3Aci)
[](https://goreportcard.com/report/github.com/docker/compose/v2)
[](https://codecov.io/gh/docker/compose)
[](https://api.securityscorecards.dev/projects/github.com/docker/compose)
Docker Compose is a tool for running multi-container applications on Docker
defined using the [Compose file format](https://compose-spec.io).
A Compose file is used to define how one or more containers that make up
your application are configured.
Once you have a Compose file, you can create and start your application with a
single command: `docker compose up`.
# Where to get Docker Compose
### Windows and macOS
Docker Compose is included in
[Docker Desktop](https://www.docker.com/products/docker-desktop)
for Windows and macOS.
### Linux
You can download Docker Compose binaries from the
[release page](https://github.com/docker/compose/releases) on this repository.
Rename the relevant binary for your OS to `docker-compose` and copy it to `$HOME/.docker/cli-plugins`
Or copy it into one of these folders to install it system-wide:
* `/usr/local/lib/docker/cli-plugins` OR `/usr/local/libexec/docker/cli-plugins`
* `/usr/lib/docker/cli-plugins` OR `/usr/libexec/docker/cli-plugins`
(might require making the downloaded file executable with `chmod +x`)
Quick Start
-----------
Using Docker Compose is a three-step process:
1. Define your app's environment with a `Dockerfile` so it can be
reproduced anywhere.
2. Define the services that make up your app in `compose.yaml` so
they can be run together in an isolated environment.
3. Lastly, run `docker compose up` and Compose will start and run your entire
app.
A Compose file looks like this:
```yaml
services:
web:
build: .
ports:
- "5000:5000"
volumes:
- .:/code
redis:
image: redis
```
Contributing
------------
Want to help develop Docker Compose? Check out our
[contributing documentation](CONTRIBUTING.md).
If you find an issue, please report it on the
[issue tracker](https://github.com/docker/compose/issues/new/choose).
Legacy
-------------
The Python version of Compose is available under the `v1` [branch](https://github.com/docker/compose/tree/v1).