1
0
mirror of https://github.com/docker/cli.git synced 2025-10-31 16:10:49 +03:00
Files
cli/docs/reference/commandline/commit.md
Sebastiaan van Stijn 3c244d1099 deprecate "--pause" flag on docker commit in favor of "--no-pause"
Commit [moby@17d870b] (API v1.13, docker v1.1.0) changed the default to pause
containers during commit, keeping the behavior opt-in for older API versions.
This version-gate was removed in [moby@1b1147e] because API versions lower
than v1.23 were no longer supported.

This patch deprecates the `--pause` flag in favor of a `--no-pause` flag to
be more explicit on the default. The old `--pause` flag is marked deprecated
but still functional. Using the deprecated flag will print a warning, and an
error is produced when trying to use both the old and new flag;

    docker commit --pause mycontainer
    Flag --pause has been deprecated, and enabled by default. Use --no-pause to disable pausing during commit.

    docker commit --pause=false mycontainer
    Flag --pause has been deprecated, and enabled by default. Use --no-pause to disable pausing during commit.

    docker commit --pause --no-pause mycontainer
    Flag --pause has been deprecated, use --no-pause instead
    conflicting options: --no-pause and --pause cannot be used together

[moby@17d870b]: 17d870bed5
[moby@1b1147e]: 1b1147e46b

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2025-09-22 15:41:22 +02:00

809 B

docker commit

Create a new image from a container's changes

Aliases

docker container commit, docker commit

Options

Name Type Default Description
-a, --author string Author (e.g., John Hannibal Smith <hannibal@a-team.com>)
-c, --change list Apply Dockerfile instruction to the created image
-m, --message string Commit message
--no-pause bool Disable pausing container during commit