Jenkins中Docker容器内后端服务无法连接MongoDB问题求助

• Docker容器默认处于独立的网络命名空间，后端容器内的localhost指向自身，而非宿主机或MongoDB容器，因此直接配置mongodb://localhost:27017无法找到服务
• 已废弃的--link参数兼容性差，多数新版本Docker环境默认禁用该特性，无法保证容器互通
• MongoDB容器启动后需要数秒完成初始化，立刻启动后端服务会因Mongo未就绪触发连接超时

• 首先创建自定义Docker网桥，同一网桥内的容器可直接通过容器名实现DNS互通，替代过时的--link方案
• 启动MongoDB容器时指定加入该自定义网桥
• 将后端服务的MongoDB连接地址修改为mongodb://mongodb:27017，直接通过MongoDB的容器名访问
• 启动后端容器时也加入同一个自定义网桥
• 新增MongoDB就绪等待逻辑，避免启动时序问题

stage('Backend clone and build') {
    steps { 
        git ([url : 'https://github...', branch : 'develop', credentialsId : '***'])
        sh 'docker pull mongo'
        // 创建自定义网桥
        sh 'docker network create mongo-network'
        // 启动MongoDB并加入网桥，无需暴露端口也可互通，有外部访问需求可保留-p 27017:27017
        sh 'docker run -d --network mongo-network --name mongodb mongo'
        // 等待MongoDB服务完全就绪
        sh '''
        until docker exec mongodb mongosh --eval "db.adminCommand('ping')" > /dev/null 2>&1
        do
          echo "等待MongoDB启动完成，重试中..."
          sleep 2
        done
        '''
        sh 'docker build -t myimage2 .'
        // 后端容器加入同一网桥即可正常访问MongoDB
        sh 'docker run --network mongo-network myimage2'
    }
}

注：如果使用低版本MongoDB镜像，可将上述命令中的mongosh替换为mongo

如果确实需要通过宿主机端口访问MongoDB，可将后端的Mongo连接地址修改为mongodb://172.17.0.1:27017（172.17.0.1为Docker默认网桥的宿主机网关地址，仅适配Linux环境），启动容器时无需加入自定义网桥，该方案适配性低于自定义网桥方案。

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