### EMQX 5.8 Docker 健康检查配置 为了在 Docker 中为 EMQX 5.8 版本配置健康检查，可以利用 Docker 的 `HEALTHCHECK` 指令来实现。该指令允许通过执行命令或脚本来检测容器的状态并判断其是否正常运行。 以下是具体的配置方法： #### 使用 HTTP 请求作为健康检查 EMQX 提供了一个管理 API 接口 `/api/v5/nodes`，可以通过此接口获取节点状态信息。如果返回的状态码为 200，则表示服务正常运行。 以下是一个基于 HTTP 请求的健康检查示例： ```dockerfile FROM emqx/emqx:v5.8 # 添加健康检查指令 HEALTHCHECK --interval=30s \ --timeout=10s \ --start-period=5s \ --retries=3 \ CMD curl -f http://localhost/api/v5/nodes || exit 1 ``` 在此配置中： - `--interval=30s` 表示每隔 30 秒执行一次健康检查[^1]。 - `--timeout=10s` 表示每次健康检查超时时间为 10 秒[^2]。 - `--start-period=5s` 表示容器启动后的前 5 秒不进行健康检查，以便服务有时间初始化[^3]。 - `--retries=3` 表示连续失败三次后才认为容器不可用[^4]。 - `CMD curl -f http://localhost/api/v5/nodes || exit 1` 是实际执行的命令，用于发送请求到 EMQX 节点 API 并验证响应状态[^5]。 #### 使用 TCP 连接作为健康检查 另一种方式是通过尝试连接 EMQX 的监听端口（默认为 1883 或其他自定义端口）来进行健康检查。这种方式适用于无法访问管理 API 的场景。 以下是一个基于 TCP 连接的健康检查示例： ```dockerfile FROM emqx/emqx:v5.8 # 添加健康检查指令 HEALTHCHECK --interval=30s \ --timeout=10s \ --start-period=5s \ --retries=3 \ CMD nc -zv localhost 1883 || exit 1 ``` 在此配置中： - `nc -zv localhost 1883` 使用 Netcat 工具测试本地主机上的 1883 端口是否可用[^6]。 #### 自定义 Shell 脚本进行健康检查 对于更复杂的健康检查需求，还可以编写一个自定义的 Shell 脚本，并将其嵌入到 Docker 容器中。 创建一个名为 `healthcheck.sh` 的文件，内容如下： ```bash #!/bin/bash curl -fs http://localhost/api/v5/nodes >/dev/null && netstat -tuln | grep :1883 >/dev/null if [[ $? -eq 0 ]]; then exit 0 else exit 1 fi ``` 然后修改 Dockerfile 如下： ```dockerfile FROM emqx/emqx:v5.8 COPY healthcheck.sh /usr/local/bin/healthcheck.sh RUN chmod +x /usr/local/bin/healthcheck.sh HEALTHCHECK --interval=30s \ --timeout=10s \ --start-period=5s \ --retries=3 \ CMD /usr/local/bin/healthcheck.sh ``` 在这个例子中，Shell 脚本会同时检查 EMQX 的管理 API 和 MQTT 监听端口是否都处于活动状态[^7]。 --- ### 总结 以上展示了三种不同的健康检查方案：HTTP 请求、TCP 连接以及自定义 Shell 脚本。每种方法都有各自的适用场景，可以根据具体需求选择合适的策略。