容器训练项目：深入理解Docker健康检查与自动回滚机制-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00285/article/details/148552775

容器训练项目：深入理解Docker健康检查与自动回滚机制

container.training Slides and code samples for training, tutorials, and workshops about Docker, containers, and Kubernetes. 项目地址: https://gitcode.com/gh_mirrors/co/container.training

健康检查机制概述

Docker健康检查是Docker Engine 1.12版本引入的重要功能，它允许我们定义定期在容器内执行的命令，用于检测容器应用的健康状态。这项功能对于确保服务可靠性至关重要。

健康检查的核心特点包括：

必须返回0（健康）或1（不健康）的退出码
执行必须快速（超时会被视为失败）
可以配置检查间隔、超时时间和重试次数

健康检查的实现方式

1. Dockerfile定义

在Dockerfile中使用HEALTHCHECK指令是最常见的做法：

HEALTHCHECK --interval=1s --timeout=3s \
  CMD curl -f http://localhost/ || false

这个例子中：

--interval=1s设置每秒检查一次
--timeout=3s设置命令超时时间为3秒
curl -f参数确保在HTTP错误时返回非零值
|| false将任何非零退出码转换为1

2. 命令行参数

在运行容器或服务时直接指定：

docker run --health-cmd "curl -f http://localhost/ || false" ...
docker service create --health-cmd "curl -f http://localhost/ || false" ...

3. Compose文件配置

在docker-compose.yml中为每个服务单独配置：

services:
  www:
    image: hellowebapp
    healthcheck:
      test: "curl -f https://localhost/ || false"
      interval: 1s
      timeout: 3s
      retries: 3

健康检查的实际应用

单容器场景

对于docker run启动的容器：

docker ps会显示容器的健康状态
docker inspect提供详细健康信息，包括检查命令的输出

服务集群场景

对于docker service管理的服务：

不健康的任务会被自动终止并重新调度
结合自动回滚机制，可以实现部署失败时的自动恢复

自动回滚机制详解

自动回滚是健康检查的高级应用场景，当服务更新后出现健康问题时，系统会自动回退到之前的稳定版本。配置自动回滚需要以下关键参数：

docker service update \
  --update-failure-action rollback \
  --update-max-failure-ratio .25 \
  --health-cmd "curl -f http://localhost/ || exit 1" \
  --health-interval 2s \
  --health-retries 1 \
  yourservice

参数说明：

--update-failure-action rollback：更新失败时执行回滚
--update-max-failure-ratio .25：允许25%的任务更新失败
健康检查相关参数确保快速检测服务异常

实战案例：dockercoins应用

我们以dockercoins应用为例，演示如何实现健康检查和自动回滚：

修改Compose文件添加健康检查配置：

services:
  hasher:
    build: dockercoins/hasher
    healthcheck:
      test: curl -f http://localhost/ || exit 1
    deploy:
      replicas: 7
      update_config:
        delay: 5s
        failure_action: rollback
        max_failure_ratio: .5
        monitor: 5s
        parallelism: 1

部署带健康检查的栈：

docker stack deploy --compose-file dockercoins+healthcheck.yml dockercoins

模拟故障场景（修改监听端口导致服务不可用）：

sed -i "s/80/81/" dockercoins/hasher/hasher.rb
docker-compose build
docker service update --image=yourimage:newversion dockercoins_hasher

此时，健康检查会发现服务不可用，触发自动回滚机制，将服务恢复到之前可用的版本。

关键参数参考

健康检查和自动回滚相关的完整参数包括：

健康检查参数：
--health-cmd        健康检查命令
--health-interval   检查间隔时间
--health-retries    连续失败次数阈值
--health-timeout    单次检查超时时间

回滚相关参数：
--rollback-delay    回滚任务间的延迟
--rollback-failure-action  回滚失败时的操作
--rollback-max-failure-ratio 允许的回滚失败率
--rollback-parallelism 并行回滚的任务数

更新相关参数：
--update-delay      更新任务间的延迟
--update-failure-action 更新失败时的操作
--update-parallelism 并行更新的任务数