mirror of
https://github.com/docker/compose.git
synced 2026-09-29 02:56:55 +00:00
aab5819147
A provider's resource lives outside the compose network: consumers could
only reach it through injected variables carrying a host-published
address — nothing like the compose-native experience of addressing a
service by name at its well-known port.
A provider may now publish where each endpoint of its resource actually
listens:
{"type": "publish-endpoint", "message": "80=localhost:49152"}
The endpoint is announced as seen from the provider's host: the relay —
the component that knows it runs inside a container — rewrites loopback
or unspecified upstream hosts to host.docker.internal (resolved through
its injected host-gateway extra_host); routable addresses pass through.
When at least one endpoint is published, compose deploys a relay
container in place of the service: a minimal TCP forwarder (new relay/
directory, published as docker/compose-relay, overridable with
COMPOSE_RELAY_IMAGE for internal registries) joining the networks of the
services that depend on the provider service, aliased with the service
name. Consumers then use http://<service>:<port> as if the service were
a regular container.
The relay is a first-class project container — canonical name, standard
compose labels including config-hash (label-driven commands run without
the compose file keep seeing the service: ps, logs, stop, down) — plus
the com.docker.compose.relay label declaring its role:
- the reconciler already leaves provider services' containers alone, and
the relay's identity hash (image + routes) makes up idempotent: kept
when routes are unchanged, recreated otherwise;
- process-level commands (exec, cp) refuse a relay — there is no service
process in it to act on;
- the up monitor excludes relays from the containers whose termination
ends an attached up: they are long-lived infrastructure and would
otherwise keep 'up' waiting forever.
The example provider demonstrates the flow behind PROVIDER_DEMO_ENDPOINT
(a detached helper serving a fixed HTTP response), backed by an e2e
scenario asserting the compose-native address works and exec is refused.
Signed-off-by: Nicolas De Loof <nicolas.deloof@gmail.com>
177 lines
3.5 KiB
HCL
177 lines
3.5 KiB
HCL
// Copyright 2022 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.
|
|
|
|
variable "GO_VERSION" {
|
|
# default ARG value set in Dockerfile
|
|
default = null
|
|
}
|
|
|
|
variable "BUILD_TAGS" {
|
|
default = "e2e"
|
|
}
|
|
|
|
variable "DOCS_FORMATS" {
|
|
default = "md,yaml"
|
|
}
|
|
|
|
# Defines the output folder to override the default behavior.
|
|
# See Makefile for details, this is generally only useful for
|
|
# the packaging scripts and care should be taken to not break
|
|
# them.
|
|
variable "DESTDIR" {
|
|
default = ""
|
|
}
|
|
function "outdir" {
|
|
params = [defaultdir]
|
|
result = DESTDIR != "" ? DESTDIR : "${defaultdir}"
|
|
}
|
|
|
|
# Special target: https://github.com/docker/metadata-action#bake-definition
|
|
target "meta-helper" {}
|
|
|
|
target "_common" {
|
|
args = {
|
|
GO_VERSION = GO_VERSION
|
|
BUILD_TAGS = BUILD_TAGS
|
|
BUILDKIT_CONTEXT_KEEP_GIT_DIR = 1
|
|
}
|
|
}
|
|
|
|
group "default" {
|
|
targets = ["binary"]
|
|
}
|
|
|
|
group "validate" {
|
|
targets = ["lint", "vendor-validate", "license-validate", "mocks-validate"]
|
|
}
|
|
|
|
target "lint" {
|
|
inherits = ["_common"]
|
|
target = "lint"
|
|
output = ["type=cacheonly"]
|
|
}
|
|
|
|
target "license-validate" {
|
|
target = "license-validate"
|
|
output = ["type=cacheonly"]
|
|
}
|
|
|
|
target "license-update" {
|
|
target = "license-update"
|
|
output = ["."]
|
|
}
|
|
|
|
target "vendor-validate" {
|
|
inherits = ["_common"]
|
|
target = "vendor-validate"
|
|
output = ["type=cacheonly"]
|
|
}
|
|
|
|
target "mocks-validate" {
|
|
inherits = ["_common"]
|
|
target = "mocks-validate"
|
|
output = ["type=cacheonly"]
|
|
}
|
|
|
|
target "vendor-update" {
|
|
inherits = ["_common"]
|
|
target = "vendor-update"
|
|
output = ["."]
|
|
}
|
|
|
|
target "test" {
|
|
inherits = ["_common"]
|
|
target = "test-coverage"
|
|
output = [outdir("./bin/coverage/unit")]
|
|
}
|
|
|
|
target "binary-with-coverage" {
|
|
inherits = ["_common"]
|
|
target = "binary"
|
|
args = {
|
|
BUILD_FLAGS = "-cover -covermode=atomic"
|
|
}
|
|
output = [outdir("./bin/build")]
|
|
platforms = ["local"]
|
|
}
|
|
|
|
target "binary" {
|
|
inherits = ["_common"]
|
|
target = "binary"
|
|
output = [outdir("./bin/build")]
|
|
platforms = ["local"]
|
|
}
|
|
|
|
target "binary-cross" {
|
|
inherits = ["binary"]
|
|
platforms = [
|
|
"darwin/amd64",
|
|
"darwin/arm64",
|
|
"linux/amd64",
|
|
"linux/arm/v6",
|
|
"linux/arm/v7",
|
|
"linux/arm64",
|
|
"linux/ppc64le",
|
|
"linux/riscv64",
|
|
"linux/s390x",
|
|
"windows/amd64",
|
|
"windows/arm64"
|
|
]
|
|
}
|
|
|
|
target "release" {
|
|
inherits = ["binary-cross"]
|
|
target = "release"
|
|
output = [outdir("./bin/release")]
|
|
}
|
|
|
|
target "docs-validate" {
|
|
inherits = ["_common"]
|
|
target = "docs-validate"
|
|
output = ["type=cacheonly"]
|
|
}
|
|
|
|
target "docs-update" {
|
|
inherits = ["_common"]
|
|
target = "docs-update"
|
|
output = ["./docs"]
|
|
}
|
|
|
|
target "image-cross" {
|
|
inherits = ["meta-helper", "binary-cross"]
|
|
output = ["type=image"]
|
|
}
|
|
|
|
target "image-module-cross" {
|
|
inherits = ["meta-helper", "binary-cross"]
|
|
target = "module"
|
|
output = ["type=image"]
|
|
platforms = [
|
|
"darwin/amd64",
|
|
"darwin/arm64",
|
|
"linux/amd64",
|
|
"linux/arm64",
|
|
"windows/amd64",
|
|
"windows/arm64",
|
|
]
|
|
}
|
|
|
|
target "relay-image" {
|
|
context = "./relay"
|
|
tags = ["docker/compose-relay:v1"]
|
|
platforms = [
|
|
"linux/amd64",
|
|
"linux/arm64",
|
|
]
|
|
}
|