Dockerfile HEALTHCHECK 健康检查

更新时间 2022-09-05 19:14:51

Dockerfile 常用指令汇总 Dockerfile 常用指令汇总

HEALTHCHECK 指令用于设置 Docker 要如何判断容器状态是否正常。Docker 1.12 版本后引入了该指令。

使用格式如下：

HEALTHCHECK [选项] CMD <命令> #设置检查容器健康状况的命令
HEALTHCHECK NONE #如果基础镜像有健康检查指令，使用这行可以屏蔽掉其健康检查指令

HEALTHCHECK 支持下列选项：

  • --interval=<间隔>：两次健康检查的间隔，默认为 30 秒；
  • --timeout=<时长>：健康检查命令运行超时时间，如果超过这个时间，本次健康检查就被视为失败，默认 30 秒；
  • --retries=<次数>：健康检查重试次数，若指定次数依然失败，则将容器状态视为 unhealthy，默认 3 次。

当一个镜像指定了 HEALTHCHECK 后，初启动容器时，初始状态为 starting, 当 HEALTHCHECK 指令检查成功后，容器状态会变为 healthy，如果重试多次失败，则会变为 unhealthy。

注意： 当 Dockerfile 中出现多个 HEALTHCHECK 时，只有最后一个生效。

使用示例

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

上面的 Dockerfile 中，通过 HEALTHCHECK 指令设置了每 5 秒检查一次，超时时间为 3 秒，若 3 秒没有响应则视为失败，并且使用 curl -fs http://localhost/ || exit 1 作为健康检查命令。

Dockerfile 常用指令汇总 Dockerfile 常用指令汇总