docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

update Compose v2.27.1 and v2.27.2 release notes (#20266) 

* update Compose v2.27.1 and v2.27.2 release notes

Signed-off-by: Guillaume Lours <705411+glours@users.noreply.github.com>

* Apply suggestions from code review

---------

Signed-off-by: Guillaume Lours <705411+glours@users.noreply.github.com>
Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
This commit is contained in:
Guillaume Lours 2024-06-20 13:00:59 +02:00 committed by GitHub
parent 6871217cd4
commit d13aead73b
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
11 changed files with 91 additions and 35 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
_vendor/github.com/docker/compose/v2/docs/reference/compose.md generated
View File

@ -177,6 +177,9 @@ If flags are explicitly set on the command line, the associated environment vari
Setting the `COMPOSE_IGNORE_ORPHANS` environment variable to `true` stops docker compose from detecting orphaned Setting the `COMPOSE_IGNORE_ORPHANS` environment variable to `true` stops docker compose from detecting orphaned
containers for the project. containers for the project.
Setting the `COMPOSE_MENU` environment variable to `false` disables the helper menu when running `docker compose up`
in attached mode. Alternatively, you can also run `docker compose up --menu=false` to disable the helper menu.
### Use Dry Run mode to test your command ### Use Dry Run mode to test your command
Use `--dry-run` flag to test a command without changing your application stack state. Use `--dry-run` flag to test a command without changing your application stack state.

1
_vendor/github.com/docker/compose/v2/docs/reference/compose_config.md generated
View File

@ -12,6 +12,7 @@ Parse, resolve and render compose file in canonical format
| Name | Type | Default | Description | | Name | Type | Default | Description |
|:--------------------------|:---------|:--------|:----------------------------------------------------------------------------| |:--------------------------|:---------|:--------|:----------------------------------------------------------------------------|
| `--dry-run` | | | Execute command in dry run mode | | `--dry-run` | | | Execute command in dry run mode |
| `--environment` | | | Print environment used for interpolation. |
| `--format` | `string` | `yaml` | Format the output. Values: [yaml \| json] | | `--format` | `string` | `yaml` | Format the output. Values: [yaml \| json] |
| `--hash` | `string` | | Print the service config hash, one per line. | | `--hash` | `string` | | Print the service config hash, one per line. |
| `--images` | | | Print the image names, one per line. | | `--images` | | | Print the image names, one per line. |

59
_vendor/github.com/docker/compose/v2/docs/reference/compose_up.md generated
View File

@ -5,35 +5,36 @@ Create and start containers
### Options ### Options
| Name | Type | Default | Description | | Name | Type | Default | Description |
|:-------------------------------|:--------------|:---------|:--------------------------------------------------------------------------------------------------------| |:-------------------------------|:--------------|:---------|:----------------------------------------------------------------------------------------------------------------------------------------------------|
| `--abort-on-container-exit` | | | Stops all containers if any container was stopped. Incompatible with -d | | `--abort-on-container-exit` | | | Stops all containers if any container was stopped. Incompatible with -d |
| `--abort-on-container-failure` | | | Stops all containers if any container exited with failure. Incompatible with -d | | `--abort-on-container-failure` | | | Stops all containers if any container exited with failure. Incompatible with -d |
| `--always-recreate-deps` | | | Recreate dependent containers. Incompatible with --no-recreate. | | `--always-recreate-deps` | | | Recreate dependent containers. Incompatible with --no-recreate. |
| `--attach` | `stringArray` | | Restrict attaching to the specified services. Incompatible with --attach-dependencies. | | `--attach` | `stringArray` | | Restrict attaching to the specified services. Incompatible with --attach-dependencies. |
| `--attach-dependencies` | | | Automatically attach to log output of dependent services | | `--attach-dependencies` | | | Automatically attach to log output of dependent services |
| `--build` | | | Build images before starting containers | | `--build` | | | Build images before starting containers |
| `-d`, `--detach` | | | Detached mode: Run containers in the background | | `-d`, `--detach` | | | Detached mode: Run containers in the background |
| `--dry-run` | | | Execute command in dry run mode | | `--dry-run` | | | Execute command in dry run mode |
| `--exit-code-from` | `string` | | Return the exit code of the selected service container. Implies --abort-on-container-exit | | `--exit-code-from` | `string` | | Return the exit code of the selected service container. Implies --abort-on-container-exit |
| `--force-recreate` | | | Recreate containers even if their configuration and image haven't changed | | `--force-recreate` | | | Recreate containers even if their configuration and image haven't changed |
| `--no-attach` | `stringArray` | | Do not attach (stream logs) to the specified services | | `--menu` | | | Enable interactive shortcuts when running attached. Incompatible with --detach. Can also be enable/disable by setting COMPOSE_MENU environment var. |
| `--no-build` | | | Don't build an image, even if it's policy | | `--no-attach` | `stringArray` | | Do not attach (stream logs) to the specified services |
| `--no-color` | | | Produce monochrome output | | `--no-build` | | | Don't build an image, even if it's policy |
| `--no-deps` | | | Don't start linked services | | `--no-color` | | | Produce monochrome output |
| `--no-log-prefix` | | | Don't print prefix in logs | | `--no-deps` | | | Don't start linked services |
| `--no-recreate` | | | If containers already exist, don't recreate them. Incompatible with --force-recreate. | | `--no-log-prefix` | | | Don't print prefix in logs |
| `--no-start` | | | Don't start the services after creating them | | `--no-recreate` | | | If containers already exist, don't recreate them. Incompatible with --force-recreate. |
| `--pull` | `string` | `policy` | Pull image before running ("always"\|"missing"\|"never") | | `--no-start` | | | Don't start the services after creating them |
| `--quiet-pull` | | | Pull without printing progress information | | `--pull` | `string` | `policy` | Pull image before running ("always"\|"missing"\|"never") |
| `--remove-orphans` | | | Remove containers for services not defined in the Compose file | | `--quiet-pull` | | | Pull without printing progress information |
| `-V`, `--renew-anon-volumes` | | | Recreate anonymous volumes instead of retrieving data from the previous containers | | `--remove-orphans` | | | Remove containers for services not defined in the Compose file |
| `--scale` | `stringArray` | | Scale SERVICE to NUM instances. Overrides the `scale` setting in the Compose file if present. | | `-V`, `--renew-anon-volumes` | | | Recreate anonymous volumes instead of retrieving data from the previous containers |
| `-t`, `--timeout` | `int` | `0` | Use this timeout in seconds for container shutdown when attached or when containers are already running | | `--scale` | `stringArray` | | Scale SERVICE to NUM instances. Overrides the `scale` setting in the Compose file if present. |
| `--timestamps` | | | Show timestamps | | `-t`, `--timeout` | `int` | `0` | Use this timeout in seconds for container shutdown when attached or when containers are already running |
| `--wait` | | | Wait for services to be running\|healthy. Implies detached mode. | | `--timestamps` | | | Show timestamps |
| `--wait-timeout` | `int` | `0` | Maximum duration to wait for the project to be running\|healthy | | `--wait` | | | Wait for services to be running\|healthy. Implies detached mode. |
| `-w`, `--watch` | | | Watch source code and rebuild/refresh containers when files are updated. | | `--wait-timeout` | `int` | `0` | Maximum duration to wait for the project to be running\|healthy |
| `-w`, `--watch` | | | Watch source code and rebuild/refresh containers when files are updated. |
<!---MARKER_GEN_END--> <!---MARKER_GEN_END-->

3
_vendor/github.com/docker/compose/v2/docs/reference/docker_compose.yaml generated
View File

@ -118,6 +118,9 @@ long: |-
Setting the `COMPOSE_IGNORE_ORPHANS` environment variable to `true` stops docker compose from detecting orphaned Setting the `COMPOSE_IGNORE_ORPHANS` environment variable to `true` stops docker compose from detecting orphaned
containers for the project. containers for the project.
Setting the `COMPOSE_MENU` environment variable to `false` disables the helper menu when running `docker compose up`
in attached mode. Alternatively, you can also run `docker compose up --menu=false` to disable the helper menu.
### Use Dry Run mode to test your command ### Use Dry Run mode to test your command
Use `--dry-run` flag to test a command without changing your application stack state. Use `--dry-run` flag to test a command without changing your application stack state.

10
_vendor/github.com/docker/compose/v2/docs/reference/docker_compose_config.yaml generated
View File

@ -9,6 +9,16 @@ usage: docker compose config [OPTIONS] [SERVICE...]
pname: docker compose pname: docker compose
plink: docker_compose.yaml plink: docker_compose.yaml
options: options:
- option: environment
value_type: bool
default_value: "false"
description: Print environment used for interpolation.
deprecated: false
hidden: false
experimental: false
experimentalcli: false
kubernetes: false
swarm: false
- option: format - option: format
value_type: string value_type: string
default_value: yaml default_value: yaml

4
_vendor/github.com/docker/compose/v2/docs/reference/docker_compose_up.yaml generated
View File

@ -123,9 +123,9 @@ options:
value_type: bool value_type: bool
default_value: "false" default_value: "false"
description: | description: |
Enable interactive shortcuts when running attached (Experimental). Incompatible with --detach. Enable interactive shortcuts when running attached. Incompatible with --detach. Can also be enable/disable by setting COMPOSE_MENU environment var.
deprecated: false deprecated: false
hidden: true hidden: false
experimental: false experimental: false
experimentalcli: false experimentalcli: false
kubernetes: false kubernetes: false

2
_vendor/modules.txt
View File

@ -2,5 +2,5 @@
# github.com/moby/buildkit v0.14.1 # github.com/moby/buildkit v0.14.1
# github.com/docker/buildx v0.15.1 # github.com/docker/buildx v0.15.1
# github.com/docker/cli v26.1.4+incompatible # github.com/docker/cli v26.1.4+incompatible
# github.com/docker/compose/v2 v2.27.0 # github.com/docker/compose/v2 v2.27.2
# github.com/docker/scout-cli v1.9.3 # github.com/docker/scout-cli v1.9.3

36
content/compose/release-notes.md
View File

@ -10,6 +10,42 @@ aliases:
For more detailed information, see the [release notes in the Compose repo](https://github.com/docker/compose/releases/). For more detailed information, see the [release notes in the Compose repo](https://github.com/docker/compose/releases/).
## 2.27.2
{{< release-date date="2024-06-20" >}}
### Update
- Dependencies upgrade: bump golang to 1.21.11
- Dependencies upgrade: bump docker engine and cli to v26.1.4
- Dependencies upgrade: bump buildx to 0.15.0
- Dependencies upgrade: bump buildkit to 0.14.0
- Dependencies upgrade: bump containerd to 1.7.18
### Bug fixes and enhancements
- Added an `--environment` flag to the `config` command
- Fixed a bug which caused the `watch` process to hang when used as flag with the `up` command
- Fixed usage of `COMPOSE_PROFILES` in `.env` file
## 2.27.1
{{< release-date date="2024-05-24" >}}
### Update
- Dependencies upgrade: bump compose-go to v2.1.1
- Dependencies upgrade: bump docker engine and cli to v26.1.3
- Dependencies upgrade: bump buildx to 0.14.1
- Dependencies upgrade: bump containerd to 1.7.17
### Bug fixes and enhancements
- Added a navigation menu in the CLI where you can open your Compose file in Docker Desktop
- Added documentation for `--menu` flag in `docker compose up`
- Fixed a bug with `--resolve-image-digests` used with `--no-interpolate`
- You can now use a local `.env` file to override `COMPOSE_*` environment variables
## 2.27.0 ## 2.27.0
{{< release-date date="2024-04-24" >}} {{< release-date date="2024-04-24" >}}

4
go.mod
View File

@ -7,7 +7,7 @@ toolchain go1.21.1
require ( require (
github.com/docker/buildx v0.15.1 // indirect github.com/docker/buildx v0.15.1 // indirect
github.com/docker/cli v26.1.4+incompatible // indirect github.com/docker/cli v26.1.4+incompatible // indirect
github.com/docker/compose/v2 v2.27.0 // indirect github.com/docker/compose/v2 v2.27.2 // indirect
github.com/docker/scout-cli v1.9.3 // indirect github.com/docker/scout-cli v1.9.3 // indirect
github.com/moby/buildkit v0.14.1 // indirect github.com/moby/buildkit v0.14.1 // indirect
github.com/moby/moby v26.1.2+incompatible // indirect github.com/moby/moby v26.1.2+incompatible // indirect
@ -16,7 +16,7 @@ require (
replace ( replace (
github.com/docker/buildx => github.com/docker/buildx v0.15.1 github.com/docker/buildx => github.com/docker/buildx v0.15.1
github.com/docker/cli => github.com/docker/cli v26.1.3-0.20240513184838-60f2d38d5341+incompatible github.com/docker/cli => github.com/docker/cli v26.1.3-0.20240513184838-60f2d38d5341+incompatible
github.com/docker/compose/v2 => github.com/docker/compose/v2 v2.27.0 github.com/docker/compose/v2 => github.com/docker/compose/v2 v2.27.2
github.com/docker/scout-cli => github.com/docker/scout-cli v1.9.3 github.com/docker/scout-cli => github.com/docker/scout-cli v1.9.3
github.com/moby/buildkit => github.com/moby/buildkit v0.14.0-rc2.0.20240611065153-eed17a45c62b github.com/moby/buildkit => github.com/moby/buildkit v0.14.0-rc2.0.20240611065153-eed17a45c62b
github.com/moby/moby => github.com/moby/moby v26.1.2+incompatible github.com/moby/moby => github.com/moby/moby v26.1.2+incompatible

2
go.sum
View File

@ -138,6 +138,8 @@ github.com/docker/compose/v2 v2.26.1 h1:27fAR5jVzNUYwY/9ppIjrPqGYLW5HtOTq2aYGBMC
github.com/docker/compose/v2 v2.26.1/go.mod h1:5iVCMlr18ab0NlMxIPdtTgThTkzb34Z/zj15N7KSW+s= github.com/docker/compose/v2 v2.26.1/go.mod h1:5iVCMlr18ab0NlMxIPdtTgThTkzb34Z/zj15N7KSW+s=
github.com/docker/compose/v2 v2.27.0 h1:FKyClQdErCxUZULC2zo6Jn5ve+epFPe/Y0HaxjmUzNg= github.com/docker/compose/v2 v2.27.0 h1:FKyClQdErCxUZULC2zo6Jn5ve+epFPe/Y0HaxjmUzNg=
github.com/docker/compose/v2 v2.27.0/go.mod h1:uaqwmY6haO8wXWHk+LAsqqDapX6boH4izRKqj/E7+Bo= github.com/docker/compose/v2 v2.27.0/go.mod h1:uaqwmY6haO8wXWHk+LAsqqDapX6boH4izRKqj/E7+Bo=
github.com/docker/compose/v2 v2.27.2 h1:8uvz019AZIPmw8+rnLBubAuyt9SEoU/pyCcAJPXMq0A=
github.com/docker/compose/v2 v2.27.2/go.mod h1:c6QJ/VVZrzVu97Ur1jylFLivvTkFdef1rSzmnQAO3DA=
github.com/docker/distribution v2.8.2+incompatible h1:T3de5rq0dB1j30rp0sA2rER+m322EBzniBPB6ZIzuh8= github.com/docker/distribution v2.8.2+incompatible h1:T3de5rq0dB1j30rp0sA2rER+m322EBzniBPB6ZIzuh8=
github.com/docker/distribution v2.8.2+incompatible/go.mod h1:J2gT2udsDAN96Uj4KfcMRqY0/ypR+oyYUYmja8H+y+w= github.com/docker/distribution v2.8.2+incompatible/go.mod h1:J2gT2udsDAN96Uj4KfcMRqY0/ypR+oyYUYmja8H+y+w=
github.com/docker/distribution v2.8.3+incompatible h1:AtKxIZ36LoNK51+Z6RpzLpddBirtxJnzDrHLEKxTAYk= github.com/docker/distribution v2.8.3+incompatible h1:AtKxIZ36LoNK51+Z6RpzLpddBirtxJnzDrHLEKxTAYk=

2
hugo.yaml
View File

@ -98,7 +98,7 @@ params:
latest_engine_api_version: "1.45" latest_engine_api_version: "1.45"
docker_ce_version: "26.1.4" docker_ce_version: "26.1.4"
compose_version: "v2.27.1" compose_version: "v2.27.2"
compose_file_v3: "3.8" compose_file_v3: "3.8"
compose_file_v2: "2.4" compose_file_v2: "2.4"
buildkit_version: "0.13.1" buildkit_version: "0.13.1"