【Docker系列】Docker 容器命令执行状态码的检查与分析

在 Docker 容器化技术日益普及的今天，容器的运行状态和健康检查成为了运维人员和开发者关注的焦点。了解如何在 Docker 容器中执行命令并检查其退出状态码，对于确保容器服务的稳定性和可靠性至关重要。

一.手动执行命令并查看退出状态码

在 Docker 容器中执行命令后，我们可以通过两种方式来查看命令的退出状态码。

方法一：使用echo $?

在容器中运行命令后，使用echo $?可以查看命令的退出状态码。这是一个非常直接的方法，可以快速地告诉我们命令是否成功执行。例如，我们可以在容器中执行一个curl命令来检查服务的健康状态，并通过grep来匹配预期的输出。如果grep找到了匹配的内容，那么退出状态码将为 0，表示命令成功执行；如果没有找到匹配的内容，退出状态码将为 1，表示命令失败。

docker exec -it <container_name> /bin/sh
# 示例：运行命令
curl -s http://localhost:8080/actuator/health | grep '"status":"UP"'
# 查看退出状态码
echo $?

方法二：使用docker inspect

Docker 的健康检查机制会记录健康检查命令的执行状态和退出码。我们可以通过docker inspect命令来查看这些信息。这个命令会输出一个 JSON 格式的字符串，其中包含了健康检查的详细日志，包括每个检查的开始时间、结束时间、退出码和输出信息。

docker inspect --format='{{json .State.Health}}' <container_name>

输出示例：

{
  "Status": "unhealthy",
  "FailingStreak": 2,
  "Log": [
    {
      "Start": "2024-12-15T10:00:00.123456789Z",
      "End": "2024-12-15T10:00:01.123456789Z",
      "ExitCode": 1,
      "Output": "command failed: grep: no match"
    },
    {
      "Start": "2024-12-15T10:00:10.123456789Z",
      "End": "2024-12-15T10:00:11.123456789Z",
      "ExitCode": 1,
      "Output": "command failed: curl: (7) Failed to connect to localhost port 8080"
    }
  ]
}

在这个输出中，ExitCode字段表示命令的退出状态码，而Output字段则提供了命令的标准输出或错误信息。

二.检查退出状态码的含义

了解退出状态码的含义对于诊断问题和优化健康检查逻辑至关重要。以下是一些常见的状态码及其含义：

• 0：成功执行。
• 1：通用错误，例如grep未匹配到内容。
• 7：无法连接到指定的主机，例如curl错误。
• 28：请求超时，例如curl超过超时时间。
• 127：命令未找到，例如curl或grep不存在。

三.本地验证健康检查命令

在调整健康检查逻辑之前，我们可以在主机上运行与healthcheck.test相同的命令，手动检查退出状态码。这有助于我们验证命令是否按预期工作，并确保健康检查逻辑的正确性。

# 示例命令
curl -s http://localhost:8080/actuator/health | grep '"status":"UP"'
# 查看退出状态码
echo $?

如果输出为 0，表示健康检查通过；如果输出为非 0，表示健康检查失败，需要进一步检查服务状态或命令逻辑。

四.调整健康检查配置

根据退出状态码的含义，我们可以调整docker-compose.yml中的healthcheck.test配置，确保健康检查命令逻辑正确。例如，如果服务启动较慢，我们可以增加start_period和timeout的时间，以避免健康检查过早失败。

healthcheck:
  test:
    [
      "CMD-SHELL",
      'curl -s http://localhost:8080/actuator/health | grep ''"status":"UP"''',
    ]
  interval: 10s
  timeout: 5s
  retries: 3
  start_period: 30s

通过这种方式，我们可以确保 Docker 容器在服务完全启动并准备好接受请求之前不会进行健康检查，从而避免不必要的服务重启。