Docker 健康检查功能

Posted 2020-10-02

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

[[email protected]]# 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 [email protected]
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”的状态：

[[email protected]]# 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

当容器正常时：

[[email protected]]# 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“：

[[email protected]]# 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引擎。

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