mirror of
https://github.com/docker/compose.git
synced 2026-10-12 02:13:08 +00:00
Nicolas De Loof
7af58e3626
AGENTS.md documents 'Test unit: go test ./pkg/...' and 'E2E tests: go test -tags e2e ./pkg/e2e/'. Both statements were false: no file in pkg/e2e carried an e2e build constraint, so the -tags flag was a no-op and the 'unit' command actually launched the full e2e suite — requiring a Docker daemon and the locally built binary, creating and destroying containers, for up to 20 minutes. CI only avoided this by grepping e2e out of the package list (Dockerfile). Every *_test.go in pkg/e2e now carries //go:build e2e (merged with the existing !windows constraints), and the Makefile e2e targets pass the tag. The documented commands become true: - go test ./pkg/... -> pkg/e2e reports [no test files] - go test -tags e2e ./pkg/e2e -> runs the suite AGENTS.md now also states the daemon/binary prerequisites explicitly. Part of #14074 (A: the code misdescribes its own structure). Signed-off-by: Nicolas De Loof <[email protected]>
70 lines
2.3 KiB
Go
70 lines
2.3 KiB
Go
//go:build e2e
|
|
|
|
/*
|
|
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 e2e
|
|
|
|
import (
|
|
"testing"
|
|
)
|
|
|
|
func TestPause(t *testing.T) {
|
|
NewScenario(t, "pause must freeze only the targeted service, unpause must resume it in place").
|
|
Step("up starts both services",
|
|
ComposeCmd("up", "-d"),
|
|
ServiceState("a", "running"),
|
|
ServiceState("b", "running")).
|
|
Step("pause freezes the targeted service, the other keeps running",
|
|
ComposeCmd("pause", "a"),
|
|
ServiceState("a", "paused"),
|
|
ServiceState("b", "running")).
|
|
Step("unpause resumes the paused service without recreating anything",
|
|
ComposeCmd("unpause", "a"),
|
|
ServiceState("a", "running"),
|
|
ServiceState("b", "running"),
|
|
NotRecreated("a", "b"))
|
|
}
|
|
|
|
func TestPauseServiceNotRunning(t *testing.T) {
|
|
// TODO: `docker pause` errors in this case, should Compose be consistent?
|
|
NewScenario(t, "pause of a service with no container must succeed as a no-op").
|
|
Step("pause without any container is accepted",
|
|
ComposeCmd("pause", "a"))
|
|
}
|
|
|
|
func TestPauseServiceAlreadyPaused(t *testing.T) {
|
|
NewScenario(t, "pausing an already-paused service must fail").
|
|
Step("up starts the service",
|
|
ComposeCmd("up", "-d"),
|
|
ServiceState("a", "running")).
|
|
Step("a first pause freezes the service",
|
|
ComposeCmd("pause", "a"),
|
|
ServiceState("a", "paused")).
|
|
Step("a second pause is rejected",
|
|
ComposeCmd("pause", "a").MayFail(),
|
|
ExitCode(1),
|
|
OutputContains("already paused"))
|
|
}
|
|
|
|
func TestPauseServiceDoesNotExist(t *testing.T) {
|
|
NewScenario(t, "pause of a service unknown to the model must be rejected").
|
|
Step("pause of an unknown service is rejected",
|
|
ComposeCmd("pause", "does_not_exist").MayFail(),
|
|
ExitCode(1),
|
|
OutputContains("no such service: does_not_exist"))
|
|
}
|