mirror of
https://github.com/docker/compose.git
synced 2025-04-08 17:05:13 +02:00
bc806da712
When running `compose down`, the `--rmi` flag can be passed,
which currently supports two values:
* `local`: remove any _implicitly-named_ images that Compose
built
* `all` : remove any named images (locally-built or fetched
from a remote repo)
Removing images in the `local` case can be problematic, as it's
historically been done via a fair amount of inference over the
Compose model. Additionally, when using the "project-model"
(by passing `--project-name` instead of using a Compose file),
we're even more limited: if no containers for the project are
running, there's nothing to derive state from to perform the
inference on.
As a first pass, we started labeling _containers_ with the name
of the locally-built image associated with it (if any) in #9715.
Unfortunately, this still suffers from the aforementioned problems
around using actual state (i.e. the containers might no longer
exist) and meant that when operating in file mode (the default),
things did not behave as expected: the label is not available
in the project since it only exists at runtime.
Now, with these changes, Compose will label any images it builds
with project metadata. Upon cleanup during `down`, the engine
image API is queried for related images and matched up with the
services for the project. As a fallback for images built with
prior versions of Compose, the previous approach is still taken.
See also:
* https://github.com/docker/compose/issues/9655
* https://github.com/docker/compose/pull/9715
Signed-off-by: Milas Bowman <milas.bowman@docker.com>
72 lines
2.9 KiB
Go
72 lines
2.9 KiB
Go
/*
|
|
Copyright 2020 Docker Compose CLI authors
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
*/
|
|
|
|
package api
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
"github.com/hashicorp/go-version"
|
|
|
|
"github.com/docker/compose/v2/internal"
|
|
)
|
|
|
|
const (
|
|
// ProjectLabel allow to track resource related to a compose project
|
|
ProjectLabel = "com.docker.compose.project"
|
|
// ServiceLabel allow to track resource related to a compose service
|
|
ServiceLabel = "com.docker.compose.service"
|
|
// ConfigHashLabel stores configuration hash for a compose service
|
|
ConfigHashLabel = "com.docker.compose.config-hash"
|
|
// ContainerNumberLabel stores the container index of a replicated service
|
|
ContainerNumberLabel = "com.docker.compose.container-number"
|
|
// VolumeLabel allow to track resource related to a compose volume
|
|
VolumeLabel = "com.docker.compose.volume"
|
|
// NetworkLabel allow to track resource related to a compose network
|
|
NetworkLabel = "com.docker.compose.network"
|
|
// WorkingDirLabel stores absolute path to compose project working directory
|
|
WorkingDirLabel = "com.docker.compose.project.working_dir"
|
|
// ConfigFilesLabel stores absolute path to compose project configuration files
|
|
ConfigFilesLabel = "com.docker.compose.project.config_files"
|
|
// EnvironmentFileLabel stores absolute path to compose project env file set by `--env-file`
|
|
EnvironmentFileLabel = "com.docker.compose.project.environment_file"
|
|
// OneoffLabel stores value 'True' for one-off containers created by `compose run`
|
|
OneoffLabel = "com.docker.compose.oneoff"
|
|
// SlugLabel stores unique slug used for one-off container identity
|
|
SlugLabel = "com.docker.compose.slug"
|
|
// ImageDigestLabel stores digest of the container image used to run service
|
|
ImageDigestLabel = "com.docker.compose.image"
|
|
// DependenciesLabel stores service dependencies
|
|
DependenciesLabel = "com.docker.compose.depends_on"
|
|
// VersionLabel stores the compose tool version used to build/run application
|
|
VersionLabel = "com.docker.compose.version"
|
|
// ImageBuilderLabel stores the builder (classic or BuildKit) used to produce the image.
|
|
ImageBuilderLabel = "com.docker.compose.image.builder"
|
|
)
|
|
|
|
// ComposeVersion is the compose tool version as declared by label VersionLabel
|
|
var ComposeVersion string
|
|
|
|
func init() {
|
|
v, err := version.NewVersion(internal.Version)
|
|
if err == nil {
|
|
segments := v.Segments()
|
|
if len(segments) > 2 {
|
|
ComposeVersion = fmt.Sprintf("%d.%d.%d", segments[0], segments[1], segments[2])
|
|
}
|
|
}
|
|
}
|