docker commit

説明

コンテナに対する変更から、新しいイメージを作成。

使い方

$ docker commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]]

詳細説明

コンテナ上でのファイル変更や設定を、新しいイメージに収容(commit;コミット)するために役立ちます。これにより、インタラクティブなシェル上でコンテナをデバッグ用に動かしたり、作業中のデータセットを他のサーバに持っていくために出力したりできます。通常は、イメージを管理するためには、文書化されメンテナンスのしやすい Dockerfile を使うのが望ましい方法です。 詳細はイメージ名とタグについてをご覧ください

コンテナ内でマウントされているボリュームに含まれるデータは、コミット対象に含まれません。

コミット対象のコンテナとそこに動作するプロセスは、イメージコミット処理の間は、デフォルトで一時停止します。これにより、コミットの作成中にデータの破損が発生する可能性が低くなります。この動作が望ましくない場合は、 --pause オプションを false に設定してください。

--change オプションは Dockerfile の命令でイメージが作られる時のみ適用されます。対応している Dockerfile 命令は、 CMDENTRYPOINTENVEXPOSELABELONBUILDUSERVOLUMEWORKDIR です。

コマンドの使用例は、以下の 使用例のセクション をご覧ください。

オプション

名前, 省略形

デフォルト

説明

--author , -a

作者(例「John Hannibal Smith <hannibal@a-team.com>」)

--change , -c

Dockerfile 命令をイメージの作成時に適用

--message , -m

メッセージをコミット

--pause , -p

true

コミット通はコンテナを一時停止

使用例

コンテナのコミット

$ docker ps

CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS              NAMES
c3f279d17e0a        ubuntu:12.04        /bin/bash           7 days ago          Up 25 hours                            desperate_dubinsky
197387f1b436        ubuntu:12.04        /bin/bash           7 days ago          Up 25 hours                            focused_hamilton
$ docker commit c3f279d17e0a  svendowideit/testimage:version3

f5283438590d
$ docker images

REPOSITORY                        TAG                 ID                  CREATED             SIZE
svendowideit/testimage            version3            f5283438590d        16 seconds ago      335.7 MB

新しい設定でコンテナをコミット

$ docker ps

CONTAINER ID       IMAGE               COMMAND             CREATED             STATUS              PORTS              NAMES
c3f279d17e0a        ubuntu:12.04        /bin/bash           7 days ago          Up 25 hours                            desperate_dubinsky
197387f1b436        ubuntu:12.04        /bin/bash           7 days ago          Up 25 hours                            focused_hamilton
$ docker inspect -f "{{ .Config.Env }}" c3f279d17e0a

[HOME=/ PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin]
$ docker commit --change "ENV DEBUG=true" c3f279d17e0a  svendowideit/testimage:version3

f5283438590d
$ docker inspect -f "{{ .Config.Env }}" f5283438590d

[HOME=/ PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin DEBUG=true]

新しい CMDEXPOSE 命令で、コンテナをコミット

$ docker ps
ID                  IMAGE               COMMAND             CREATED             STATUS              PORTS
c3f279d17e0a        ubuntu:12.04        /bin/bash           7 days ago          Up 25 hours
197387f1b436        ubuntu:12.04        /bin/bash           7 days ago          Up 25 hours
$ docker commit --change='CMD ["apachectl", "-DFOREGROUND"]' -c "EXPOSE 80" c3f279d17e0a  svendowideit/testimage:version4
f5283438590d
$ docker run -d svendowideit/testimage:version4
89373736e2e7f00bc149bd783073ac43d0507da250e999f3f1036e0db60817c0
$ docker ps
ID                  IMAGE               COMMAND                 CREATED             STATUS              PORTS
89373736e2e7        testimage:version4  "apachectl -DFOREGROU"  3 seconds ago       Up 2 seconds        80/tcp
c3f279d17e0a        ubuntu:12.04        /bin/bash               7 days ago          Up 25 hours
197387f1b436        ubuntu:12.04        /bin/bash               7 days ago          Up 25 hours

親コマンド

コマンド

説明

docker

Docker CLI の基本コマンド