Jenkins中Docker部署的Elasticsearch健康检查失败

我之前也碰到过类似的Jenkins流水线里Docker容器间通信的问题，结合你描述的情况——本地Docker for Mac完全正常，但Jenkins里curl访问Elasticsearch返回000状态码，给你几个实用的排查方向和解决方案：

1. 先确认容器间的网络连通性 #

Jenkins的Docker环境和本地可能存在网络配置差异，首先要确保你的Node.js测试容器和Elasticsearch容器在同一个Docker网络里：

• 可以在docker-compose.yml里显式定义一个自定义网络，避免默认网络的潜在问题：

  version: '3.8'
  networks:
    test-network:
      driver: bridge
  services:
    elasticsearch:
      image: docker.elastic.co/elasticsearch/elasticsearch:7.17.0 # 替换成你的镜像版本
      networks:
        - test-network
      # 其他ES配置...
    node-test-service:
      build: . # 你的Node服务构建配置
      networks:
        - test-network
      # 其他测试服务配置...
  

• 在测试容器里先执行ping elasticsearch，看能不能解析到ES容器的IP。如果ping不通，说明DNS解析有问题，大概率是网络隔离导致的，得先把网络连通性搞定。

2. 给Elasticsearch足够的启动时间 #

本地机器资源充足，ES启动快，但Jenkins服务器可能资源紧张，ES还没完全初始化就开始健康检查，这时候curl会因为连接未建立返回000状态码。

• 修改你的run-tests.sh，给健康检查加上循环重试逻辑：

  # 等待Elasticsearch就绪
  MAX_WAIT=60
  WAIT_INTERVAL=5
  elapsed=0
  
  echo "Waiting for Elasticsearch to become ready..."
  while [ $elapsed -lt $MAX_WAIT ]; do
      # 捕获curl的响应状态码和健康状态
      response=$(curl -s -w "%{http_code}" "http://elasticsearch:9200/_cat/health?h=st")
      http_status=${response: -3}
      health_status=${response%???}
  
      if [ "$http_status" = "200" ] && [ "$health_status" = "green" ]; then
          echo "Elasticsearch is ready (status: $health_status)"
          break
      fi
  
      echo "Elasticsearch not ready yet, waiting $WAIT_INTERVAL seconds..."
      sleep $WAIT_INTERVAL
      elapsed=$((elapsed + WAIT_INTERVAL))
  done
  
  if [ $elapsed -ge $MAX_WAIT ]; then
      echo "Error: Elasticsearch did not become ready within $MAX_WAIT seconds"
      exit 1
  fi
  

• 更优雅的方式是让docker-compose自己等待ES就绪，给ES加上healthcheck配置，然后让测试服务依赖ES的健康状态：

  elasticsearch:
    # ...其他配置
    healthcheck:
      test: ["CMD-SHELL", "curl -s http://localhost:9200/_cat/health?h=st | grep -q green"]
      interval: 5s
      timeout: 5s
      retries: 12 # 最多等60秒
  
  node-test-service:
    # ...其他配置
    depends_on:
      elasticsearch:
        condition: service_healthy
  

3. 检查Jenkins的Docker运行模式 #

如果你的Jenkins是跑在Docker容器里的（比如用Docker-in-Docker模式），那容器间的通信规则会更严格：

• 如果是DinD模式，确保Jenkins容器的Docker守护进程和你的测试容器在同一个网络，或者给Jenkins容器加上--network host参数（不过这种方式要注意端口冲突）。
• 确认Jenkins用户有访问Docker的权限，比如把jenkins用户加入docker组，避免因为权限问题导致容器通信异常。

4. 调整Elasticsearch的资源配置 #

Jenkins服务器可能内存不足，ES默认的JVM内存设置太高，导致ES启动不完全就卡住了：

• 在docker-compose.yml里给ES设置合理的JVM内存：

  elasticsearch:
    environment:
      - ES_JAVA_OPTS=-Xms512m -Xmx512m # 根据服务器内存调整，比如1G内存的话设成512m
  

• 在Jenkins里执行docker-compose logs elasticsearch查看ES的启动日志，看有没有内存不足、权限错误之类的报错，这些都会导致ES无法正常提供服务。

5. 排查curl命令的差异 #

本地和Jenkins里的curl版本或参数可能有差异，导致请求行为不一样：

• 在Jenkins的流水线里先执行curl --version，和本地的curl版本对比，看有没有功能差异。
• 在curl命令里加上超时参数，避免因为连接超时返回000：

  curl --connect-timeout 5 --max-time 10 -s -w "%{http_code}" "http://elasticsearch:9200/_cat/health?h=st"
  

按这些步骤排查下来，应该能解决健康检查返回000的问题。

内容的提问来源于stack exchange，提问作者Austin K