HEALTHCHECK

作用
  • 健康检查
  • 当在一个镜像指定了 unhealthy
格式



# 设置检查容器健康状况的命令
HEALTHCHECK [选项] CMD <命令>

# 如果基础镜像有健康检查指令,使用这行可以屏蔽掉其健康检查指令
HEALTHCHECK NONE



记住选项后面是接 CMD 哦

注意

和 CMD, ENTRYPOINT 一样,HEALTHCHECK 只可以出现一次,如果写了多个,只有最后一个生效

HEALTHCHECK 返回值

决定了该次健康检查的成功与否:0:成功;1:失败;2:保留(不要使用这个值)

为啥要用 HEALTHCHECK

  • 在没有Docker 引擎只可以通过容器内主进程是否退出来判断容器是否状态异常
  • 很多情况下这没问题,但是如果程序进入死锁状态,或者死循环状态,应用进程并不退出,但是该容器已经无法提供服务了
  • 在Docker 不会检测到容器的这种状态,从而不会重新调度,导致可能会有部分容器已经无法提供服务了却还在接受用户请求
  • 自Docker 提供了 HEALTHCHECK 指令,通过该指令指定一行命令,用这行命令来判断容器主进程的服务状态是否还正常,从而比较真实的反应容器实际状态

HEALTHCHECK 支持的选项

  • --interval=<间隔>
  • --timeout=<时长>
  • --retries=<次数> :当连续失败指定次数后,则将容器状态视为 unhealthy

实际小栗子

假设有个镜像是个最简单的

dockerfile



FROM nginx
RUN apt-get update && apt-get install -y curl && rm -rf /var/lib/apt/lists/*
HEALTHCHECK --interval=5s --timeout=3s \
  CMD curl -fs http://localhost/ || exit 1



如果返回 1 则退出

执行 docker build



$ docker build -f HEALTHCHEK.dockerifle -t myweb .



执行 docker run



docker run -d --name web -p 80:80 myweb



查看容器状态



docker ps



docker 出现killed docker unhealthy 会怎样_docker 出现killed

  • 刚启动时的状态是 health:starting,过多几秒后就变成 healthy 了
  • 如果健康检查连续失败超过了重试次数,状态就会变为  unhealthy
查看容器健康检查信息

为了帮助排障,健康检查命令的输出(包括 docker inspect 来查看



> docker inspect --format '{{json .State.Health}}' web | python -m json.tool
{
    "FailingStreak": 0,
    "Log": [
        {
            "End": "2021-10-31T04:43:58.8446416Z",
            "ExitCode": 0,
            "Output": "<!DOCTYPE html>\n<html>\n<head>\n<title>Welcome to nginx!</title>\n<style>\nhtml { color-scheme: light dark; }\nbody { width: 35em; margin: 0 auto;\nfont-family: Tahoma, Verdana, Arial, sans-serif; }\n</style>\n</head>\n<body>\n<h1>Welcome to nginx!</h1>\n<p>If you see this page, the nginx web server is successfully installed and\nworking. Further configuration is required.</p>\n\n<p>For online documentation and support please refer to\n<a href=\"http://nginx.org/\">nginx.org</a>.<br/>\nCommercial support is available at\n<a href=\"http://nginx.com/\">nginx.com</a>.</p>\n\n<p><em>Thank you for using nginx.</em></p>\n</body>\n</html>\n",
            "Start": "2021-10-31T04:43:58.7591924Z"
        }
    ],
    "Status": "healthy"
}