首页 > 代码库 > Docker 健康检查功能

Docker 健康检查功能

Docker1.12及以上版本,自带了健康检查功能。通常情况下只能使用docker ps 来查看容器是否是up的状态,但是服务是否正常我们不可知,而健康检查功能,可以允许我们在容器中执行一些健康检查的命令,然后将容器的状态在"STATUS"中标识:

[root@docker]# docker ps
CONTAINER ID        IMAGE                        COMMAND             CREATED             STATUS                    PORTS                NAMES
1bd250e6836a        trying/nginx_dockerfile:v1   "nginx"             16 seconds ago      Up 13 seconds (healthy)   0.0.0.0:80->80/tcp   nginx-1

实现这一功能只需要在构建镜像的Dockerfile中加入“HEALTHCHECK”字段:

HEALTHCHECK --interval=5s --timeout=3s CMD curl --fail http://localhost:80/ || exit 1


如果http状态码是200,退出代码将为0,容器将被标记为运行状况。 如果服务器响应任何错误,退出代码将为1,容器处于不健康状态。 

HEALTHCHECK有3个选项参数:

  • --interval=DURATION (default 30s)

  • --timeout=DURATION (default 30s)

  • --retries=N (default 3)


下面是具有以上健康检查功能的简单Dockerfile:

FROM centos
MAINTAINER trying tryingstuff@163.com
RUN rpm -ivh http://mirrors.aliyun.com/epel/epel-release-latest-7.noarch.rpm
RUN yum install nginx -y
RUN sed -i ‘N;6adaemon off;‘ /etc/nginx/nginx.conf
ADD index.html /usr/share/nginx/html/index.html
HEALTHCHECK --interval=5s --timeout=3s CMD curl --fail http://localhost:80/ || exit 1
EXPOSE 80
CMD ["nginx"]

也可以直接使用nginx镜像,使用如下Dockerfile:

FROM nginx:latest
HEALTHCHECK --interval=5s --timeout=3s CMD curl --fail http://localhost:80/ || exit 1
CMD /usr/sbin/nginx -g ‘daemon off;‘
EXPOSE 80

构建镜像并启动:

docker build -t trying/nginx_dockerfile:v1 ./
docker run -d -p 80:80 --name nginx-1 trying/nginx_dockerfile:v1 nginx

在启动初始阶段,会显示“health: starting”的状态:

[root@docker]# docker ps
CONTAINER ID        IMAGE                        COMMAND             CREATED             STATUS                            PORTS                NAMES
1bd250e6836a        trying/nginx_dockerfile:v1   "nginx"             5 seconds ago       Up 3 seconds (health: starting)   0.0.0.0:80->80/tcp   nginx-1


当容器正常时:

[root@docker]# docker ps
CONTAINER ID        IMAGE                        COMMAND             CREATED             STATUS                    PORTS                NAMES
1bd250e6836a        trying/nginx_dockerfile:v1   "nginx"             16 seconds ago      Up 13 seconds (healthy)   0.0.0.0:80->80/tcp   nginx-1

当容器故障时,如删除nginx的index.html文件,404错误状态为”unhealthy“:

[root@docker]# docker ps
CONTAINER ID        IMAGE                        COMMAND             CREATED             STATUS                      PORTS                NAMES
1bd250e6836a        trying/nginx_dockerfile:v1   "nginx"             49 minutes ago      Up 49 minutes (unhealthy)   0.0.0.0:80->80/tcp   nginx-1

任何健康状况变化都会触发Docker事件(heath_status),以便我们可以对更改做出反应,而无需使用轮询Docker引擎。

这个功能帮助开发人员在各种场景中构建更具弹性的软件:例如在负载均衡中,流量不应该被传送到标记为不健康的容器上。


Docker 健康检查功能