【docker】Docker容器的重启策略
1. Docker容器的重启策略
Docker容器的重启策略是面向生产环境的一个启动策略,在开发过程中可以忽略该策略。
Docker容器的重启都是由Docker守护进程完成的,因此与守护进程息息相关。
Docker容器的重启策略如下:
-
no,默认策略,在容器退出时不重启容器
-
on-failure,在容器非正常退出时(退出状态非0),才会重启容器
on-failure:3,指定启动的次数,在容器非正常退出时重启容器,最多重启3次
-
always,在容器退出时总是重启容器
-
unless-stopped,在容器退出时总是重启容器,但是不考虑在Docker守护进程启动时就已经停止了的容器
容器如果被守护进程重新拉起后,容器的id和名称都是不变的,但是对应在主机上的进程号会变化。
例如:
docker run -p 8092:80 --name apicloud -v /home/lifehaier:/var/www/html -d --restart=on-failure:3 hub.docker.terminus.io:5000/aabb:20180315
解释:使用docker run命令运行一个容器,该容器内部监听80端口,与宿主机系统8092端口映射,命名该容器名称为apicloud,宿主机系统目录/home/lifehaier与容器内部/var/www/html路径映射,如果容器对应的images路径/var/www/html下面有数据的话,则被宿主机/home/lifehaier路径下面的数据覆盖,-d参数是让容器后台运行,–restart=on-failure:3是指容器在未来出现异常退出(退出码非0)的情况下循环重启3次;hub.docker.terminus.io:5000/aabb:20180315 是images名称,容器基于此images进行启动。
通过–restart选项,可以设置容器的重启策略,以决定在容器退出时Docker守护进程是否重启刚刚退出的容器。
-
--restart
选项通常只用于detached模式的容器。 -
--restart
选项不能与–rm选项同时使用。显然,--restart
选项适用于detached模式的容器,而--rm
选项适用于foreground模式的容器。
2. Docker容器的退出状态码
docker run的退出状态码如下:
-
0,表示正常退出
-
非0,表示异常退出(退出状态码采用chroot标准)
-
125,Docker守护进程本身的错误
-
126,容器启动后,要执行的默认命令无法调用
-
127,容器启动后,要执行的默认命令不存在
-
其他命令状态码,容器启动后正常执行命令,退出命令时该命令的返回状态码作为容器的退出状态码
-
3. 不同操作,对应容器的状态
3.1 策略为always
3.1.1 初次创建容器
初次创建容器,并设定容器重启策略为always
:
docker run -d --name myredis3 --restart=always myredis:exec
此时容器状态
"State": {
"Status": "running", 'running'
"Running": true,
"Paused": false,
"Restarting": false,
"OOMKilled": false,
"Dead": false,
"Pid": 19018,
"ExitCode": 0,
"Error": "",
"StartedAt": "2021-07-25T07:38:31.390940404Z",
"FinishedAt": "0001-01-01T00:00:00Z"
}
"RestartCount": 0,
"HostConfig": {
"RestartPolicy": { '记录了重启策略'
"Name": "always",
"MaximumRetryCount": 0
},
3.1.2 docker stop
docker stop
"State": {
"Status": "exited", 'exited'
"Running": false,
"Paused": false,
"Restarting": false,
"OOMKilled": false,
"Dead": false,
"Pid": 0,
"ExitCode": 0,
"Error": "",
"StartedAt": "2021-07-25T04:15:15.052478152Z",
"FinishedAt": "2021-07-25T04:16:57.238324749Z"
}
"RestartCount": 0, '仍为0,不影响重启次数'
3.1.3 docker start
"State": {
"Status": "running", '又变回running'
"Running": true,
"Paused": false,
"Restarting": false,
"OOMKilled": false,
"Dead": false,
"Pid": 19018,
"ExitCode": 0,
"Error": "",
"StartedAt": "2021-07-25T07:38:31.390940404Z",
"FinishedAt": "0001-01-01T00:00:00Z"
},
"RestartCount": 0, '仍为0,不影响重启次数'
3.1.4 docker restart
docker restart :
"State": {
"Status": "running",
"Running": true,
"Paused": false,
"Restarting": false,
"OOMKilled": false,
"Dead": false,
"Pid": 12989,
"ExitCode": 0,
"Error": "",
"StartedAt": "2021-07-25T07:44:12.506647419Z",
"FinishedAt": "2021-07-25T07:44:12.145349632Z"
}
"RestartCount": 0, '注意:不影响重启次数'
注意:不影响重启次数,说明docker restart 仍属于正常退出场景
3.1.5 我们干掉容器的进程
[root]$ docker inspect -f '{{.State.Pid}}' myredis4
12989
[root]$ kill -9 12989
再来看状态:
"State": {
"Status": "running",
"Running": true,
"Paused": false,
"Restarting": false,
"OOMKilled": false,
"Dead": false,
"Pid": 26088,
"ExitCode": 0, '退出码为0'
"Error": "",
"StartedAt": "2021-07-25T07:51:29.371543467Z",
"FinishedAt": "2021-07-25T07:51:28.874326028Z"
},
"RestartCount": 1, '次数+1 了'
可以反复试下干掉进程,理论上由于是always
策略,会一直重新拉起,不限次数。
注意: 此时退出码为0,理解为进程被杀死,来不及写状态码。
3.1.6 docker kill
docker kill myredis4
查看状态:
"State": {
"Status": "exited",
"Running": false,
"Paused": false,
"Restarting": false,
"OOMKilled": false,
"Dead": false,
"Pid": 0,
"ExitCode": 137, '137,表示接收137好命令状态码'
"Error": "",
"StartedAt": "2021-07-25T07:51:29.371543467Z",
"FinishedAt": "2021-07-25T08:00:22.509279442Z"
},
"RestartCount": 1
3.1.7 127错误码,容器启动后,要执行的默认命令不存在
我们故意在启动redis容器后面执行aaa,是个不存在的命令:
[root@paas-controller-3:/home/ubuntu]$ docker run -d --name myredis5 --restart=always myredis:exec aaa
a983d983c8e4db7567b3b56402cf6509c9b959b28a7f0825411e26cd9d311505 '显示容器创建成功'
docker: Error response from daemon: oci runtime error: container_linux.go:300: starting container process caused "exec: \"aaa\": executable file not found in $PATH".
日志显示容器创建成功,看下容器的状态:
"State": {
"Status": "created", '状态为created'
"Running": false,
"Paused": false,
"Restarting": false,
"OOMKilled": false,
"Dead": false,
"Pid": 0,
"ExitCode": 127, '127码'
"Error": "oci runtime error: container_linux.go:300: starting container process caused \"exec: \\\"aaa\\\": executable file not found in $PATH\"\n",
"StartedAt": "0001-01-01T00:00:00Z",
"FinishedAt": "0001-01-01T00:00:00Z"
},
"RestartCount": 0,
状态为created,说明发生异常,就没有启动该容器,只是创建了该容器。
3.1.8 总结
docker restart 命令让容器正常重启,不累加重启次数
干掉进程,容器会重启,累加次数
docker kill,容器不重启,但是给出137退出码
另外,错误码对应特定的,例如我们演示的127错误码
3.2 on-failure
我们在always场景下,如果是干掉进程,就会立即启动该容器,但是退出码是0,所以,我们需要针对该场景,进行一个对比。
启动容器,设置策略为on-failure:10
$ docker run -d --name myredis6 --restart=on-failure:10 myredis:exec
8ce68b1f63040411e6261f8569a8af3579f5506156111e0f2edbc628673e1b2d
干掉进程:
[root@paas-controller-3:/home/ubuntu]$ docker inspect -f '{{.State.Pid}}' myredis6
3164
[root@paas-controller-3:/home/ubuntu]$ kill -9 3164
"State": {
"Status": "running",
"Running": true,
"Paused": false,
"Restarting": false,
"OOMKilled": false,
"Dead": false,
"Pid": 17901,
"ExitCode": 0,
"Error": "",
"StartedAt": "2021-07-25T08:22:00.859191669Z",
"FinishedAt": "2021-07-25T08:22:00.30237101Z"
},
"RestartCount": 1,
"RestartPolicy": {
"Name": "on-failure",
"MaximumRetryCount": 10
},
我们发现容器也可以被重启,说明干掉进程仍归类为异常退出,只是没记记录ExitCode字段而已。
4. 示例与补充
示例:
docker run -d --restart=always bba-208
docker run -d --restart=on-failure:10 bba-208
补充:
#查看容器重启次数
docker inspect -f "{{ .RestartCount }}" bba-208
#查看容器最后一次的启动时间
docker inspect -f "{{ .State.StartedAt }}" bba-208