Compose command doc

_data/toc.yaml

@@ -1186,6 +1186,12 @@ manuals:
   section:
   - path: /compose/
     title: Overview of Docker Compose
+  - sectiontitle: Compose CLI Tech Preview
+    section:
+    - path: /compose/cli-command/
+      title: Overview
+    - path: /compose/cli-command-compatibility/
+      title: Compose CLI compatibility
   - path: /compose/install/
     title: Install Compose
   - path: /compose/gettingstarted/

compose/cli-command-compatibility.md

@@ -0,0 +1,47 @@
+---
+description: Compose command compatibility with docker-compose
+keywords: documentation, docs, docker, compose, containers
+title: Compose command compatibility with docker-compose
+---
+
+The `compose` command in the Docker CLI supports most of the `docker-compose` commands and flags. It is expected to be a drop-in replacement for `docker-compose`. There are a few remaining flags that have yet to be implemented, and we are prioritizing these implementations based on usage metrics and user feedback.
+
+You can follow progress on the implementation of the remaining commands and flags in the  [Compose-CLI](https://github.com/docker/compose-cli/issues/1283){:target="_blank" rel="noopener" class="_"} GitHub repository.
+
+If you see some Compose functionality that is not available in the `compose` command, create an issue in the [Compose-CLI](https://github.com/docker/compose-cli/issues){:target="_blank" rel="noopener" class="_"} GitHub repository so we can prioritize it.
+
+## Commands or flags not yet implemented
+
+The following commands have not been implemented yet, and maybe implemented at a later time.
+Let us know if these commands are a higher priority for your usecases.
+
+* `compose build --memory`
+* `compose build --no-cache`
+* `compose config --no-interpolate`
+* `compose config --services`
+* `compose config --volumes`
+* `compose config --hash`
+* `compose images`
+* `compose port`
+* `compose pull --ignore-pull-failures`
+* `compose push --ignore-push-failures`
+
+## Flags that will not be implemented
+
+The list below includes the flags that we are not planning to support in Compose in the Docker CLI,
+either because they are already deprecated in `docker-compose`, or because they are not relevant for Compose in the Docker CLI.
+
+* `compose build --compress` Not relevant as the 'compose' command uses buildkit by default.
+* `compose build --force-rm` Not relevant as commpose command is using buildkit by default.
+* `compose build --no-rm` Not relevant as commpose command is using buildkit by default.
+* `compose build --parallel` Not relevant as commpose command is using buildkit by default.
+* `compose ps --filter KEY-VALUE` Not relevant due to its complicated usage with the `service` command and also because it is not documented properly in `docker-compose`.
+* `compose pull --parallel` Deprecated in docker-compose
+* `compose pull --no-parallel` Deprecated in docker-compose
+* `compose rm --all` Deprecated in docker-compose.
+* `compose scale` Deprecated in docker-compose (use `compose up --scale` instead)
+
+Global flags:
+
+* `compose --no-ansi` Deprecated in docker-compose.
+* `compose --compatibility` Deprecated in docker-compose.

compose/cli-command.md

@@ -0,0 +1,39 @@
+---
+description: Compose CLI Tech Preview
+keywords: documentation, docs, docker, compose, containers
+title: Compose CLI Tech Preview
+---
+
+## New docker compose command
+
+> Important
+>
+> The `compose` command  in the Docker CLI is currently available as a Tech Preview. We recommend that you do not use this in production environments.
+>
+> Your feedback is important to us. Let us know your feedback on the new 'compose' command by creating an issue in the [Compose-CLI](https://github.com/docker/compose-cli/issues){:target="_blank" rel="noopener" class="_"} GitHub repository.
+{: .important}
+
+The Docker CLI now supports the `compose` command, including most of the `docker-compose` features and flags, without the need for a separate tool.
+
+You can replace the dash (`-`) with a space when you use `docker-compose` to switch over to `docker compose`. You can also use them interchangeably, so that you are not locked-in with the new compose command and, if needed, can still use `docker-compose` if needed.
+
+Introduction of the [Compose specification](https://github.com/compose-spec/compose-spec){:target="_blank" rel="noopener" class="_"} makes a clean distinction between the Compose YAML file model and the `docker-compose` implementation. Making this change has enabled a number of enhancements, including the launch of [Amazon ECS](/cloud/ecs-integration) and [Microsoft ACI](/cloud/aci-integration), being able to “up” a Compose application on cloud platforms simply by switching Docker context, and adding compose command directly into the Docker CLI.
+As the Compose specification evolves, new features land faster in the Docker CLI. While `docker-compose` is still supported and maintained, Compose in the Docker CLI Go implementation relies directly on the compose-go bindings which are maintained as part of the specification. This allows us to include community proposals, experimental implementations by the Docker CLI and/or Engine, and deliver features faster to users. Compose in the Docker CLI already supports some of the newer additions to the Compose specification such as profiles and GPU devices.
+
+For more information about the flags that are not yet supported in the new `compose` command, see the [docker-compose compatibility list](cli-command-compatibility.md).
+
+## Installing the Compose CLI Tech Preview
+
+### Install Compose CLI Tech Preview on Mac and Windows
+
+**Docker Desktop for Mac and for Windows** version 3.1.0 and above includes the new Compose command along
+with Docker cli, so Windows and Mac users do not need to install it separately.
+For installation instructions, see [Install Docker Desktop on Mac](../docker-for-mac/install.md) and [Install Docker Desktop on Windows](../docker-for-windows/install.md).
+
+### Install Compose CLI Tech Preview on Linux
+
+You can install the new Compose CLI including this Tech Preview using the install script:
+
+```console
+curl -L https://raw.githubusercontent.com/docker/compose-cli/main/scripts/install/install_linux.sh | sh
+```

compose/index.md

@@ -28,7 +28,7 @@ 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. Run `docker-compose up` and Compose starts and runs your entire app.
+3. Run `docker compose up` and the [Docker compose command](cli-command.md) starts and runs your entire app. You can alternatively run `docker-compose up` using the docker-compose binary.
 
 A `docker-compose.yml` looks like this: