134 lines
4.6 KiB
Plaintext
134 lines
4.6 KiB
Plaintext
Metadata-Version: 2.1
|
|
Name: docker-compose
|
|
Version: 1.29.2
|
|
Summary: Multi-container orchestration for Docker
|
|
Home-page: https://www.docker.com/
|
|
Author: Docker, Inc.
|
|
License: Apache License 2.0
|
|
Project-URL: Documentation, https://docs.docker.com/compose/overview
|
|
Project-URL: Changelog, https://github.com/docker/compose/blob/release/CHANGELOG.md
|
|
Project-URL: Source, https://github.com/docker/compose
|
|
Project-URL: Tracker, https://github.com/docker/compose/issues
|
|
Platform: UNKNOWN
|
|
Classifier: Development Status :: 5 - Production/Stable
|
|
Classifier: Environment :: Console
|
|
Classifier: Intended Audience :: Developers
|
|
Classifier: License :: OSI Approved :: Apache Software License
|
|
Classifier: Programming Language :: Python :: 3
|
|
Classifier: Programming Language :: Python :: 3.4
|
|
Classifier: Programming Language :: Python :: 3.6
|
|
Classifier: Programming Language :: Python :: 3.7
|
|
Classifier: Programming Language :: Python :: 3.8
|
|
Classifier: Programming Language :: Python :: 3.9
|
|
Requires-Python: >=3.4
|
|
Description-Content-Type: text/markdown
|
|
Requires-Dist: PyYAML (<6,>=3.10)
|
|
Requires-Dist: distro (<2,>=1.5.0)
|
|
Requires-Dist: docker[ssh] (>=5)
|
|
Requires-Dist: dockerpty (<1,>=0.4.1)
|
|
Requires-Dist: docopt (<1,>=0.6.1)
|
|
Requires-Dist: jsonschema (<4,>=2.5.1)
|
|
Requires-Dist: python-dotenv (<1,>=0.13.0)
|
|
Requires-Dist: requests (<3,>=2.20.0)
|
|
Requires-Dist: texttable (<2,>=0.9.0)
|
|
Requires-Dist: websocket-client (<1,>=0.32.0)
|
|
Requires-Dist: backports.ssl-match-hostname (<4,>=3.5) ; python_version < "3.5"
|
|
Requires-Dist: cached-property (<2,>=1.2.0) ; python_version < "3.8"
|
|
Requires-Dist: colorama (<1,>=0.4) ; sys_platform == "win32"
|
|
Provides-Extra: socks
|
|
Requires-Dist: PySocks (!=1.5.7,<2,>=1.5.6) ; extra == 'socks'
|
|
Provides-Extra: tests
|
|
Requires-Dist: ddt (<2,>=1.2.2) ; extra == 'tests'
|
|
Requires-Dist: pytest (<6) ; extra == 'tests'
|
|
|
|
Docker Compose
|
|
==============
|
|
[](https://ci-next.docker.com/public/job/compose/job/master/)
|
|
|
|
|
|
|
|
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 the 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`.
|
|
|
|
Compose files can be used to deploy applications locally, or to the cloud on
|
|
[Amazon ECS](https://aws.amazon.com/ecs) or
|
|
[Microsoft ACI](https://azure.microsoft.com/services/container-instances/) using
|
|
the Docker CLI. You can read more about how to do this:
|
|
- [Compose for Amazon ECS](https://docs.docker.com/engine/context/ecs-integration/)
|
|
- [Compose for Microsoft ACI](https://docs.docker.com/engine/context/aci-integration/)
|
|
|
|
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.
|
|
|
|
### Using pip
|
|
|
|
If your platform is not supported, you can download Docker Compose using `pip`:
|
|
|
|
```console
|
|
pip install docker-compose
|
|
```
|
|
|
|
> **Note:** Docker Compose requires Python 3.6 or later.
|
|
|
|
Quick Start
|
|
-----------
|
|
|
|
Using Docker Compose is basically 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 `docker-compose.yml` 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
|
|
```
|
|
|
|
You can find examples of Compose applications in our
|
|
[Awesome Compose repository](https://github.com/docker/awesome-compose).
|
|
|
|
For more information about the Compose format, see the
|
|
[Compose file reference](https://docs.docker.com/compose/compose-file/).
|
|
|
|
Contributing
|
|
------------
|
|
|
|
Want to help develop Docker Compose? Check out our
|
|
[contributing documentation](https://github.com/docker/compose/blob/master/CONTRIBUTING.md).
|
|
|
|
If you find an issue, please report it on the
|
|
[issue tracker](https://github.com/docker/compose/issues/new/choose).
|
|
|
|
Releasing
|
|
---------
|
|
|
|
Releases are built by maintainers, following an outline of the [release process](https://github.com/docker/compose/blob/master/project/RELEASE-PROCESS.md).
|
|
|
|
|