Jenkins中连接LocalStack容器失败，无法创建S3 Bucket求助

你的问题核心是Jenkins执行环境无法访问LocalStack容器的端口——虽然Docker显示容器健康且端口已映射，但curl localhost:4566失败，根源在于Jenkins的执行上下文和LocalStack容器的网络隔离，具体解决方法如下：

1. 用容器名代替localhost访问（最可靠方案） #

你已经创建了自定义Docker网络new-network，LocalStack容器也加入了该网络，只要Jenkins执行环境（agent）也在同一个网络内，就可以直接用容器名localstack作为地址访问，无需依赖端口映射：

修改流水线命令如下：

stage('Start Localstack') {
    steps {
        script {
            // 先检查网络是否存在，避免重复创建报错
            sh 'docker network inspect new-network || docker network create new-network'
            // 启动LocalStack，无需暴露宿主机端口（同网络内用容器名访问即可）
            sh 'docker run --network new-network --name localstack -d -e SERVICES=s3 localstack/localstack'
            
            // 替换sleep为容器内的健康检查，等待S3服务就绪
            sh 'docker exec localstack wait-for-it localhost:4566 --timeout=30'
            
            // 用容器名访问健康端点（或直接在容器内curl本地端口）
            sh 'docker exec localstack curl http://localhost:4566/_localstack/health'
            
            // 创建S3桶时，使用容器名作为endpoint地址
            withEnv(['AWS_ACCESS_KEY_ID=test', 'AWS_SECRET_ACCESS_KEY=test-secret']) {
                sh 'aws s3 mb s3://pricing.s3.engine --endpoint-url=http://localstack:4566'
            }
        }
    }
}

注意：如果你的Jenkins agent是容器化的，需要确保agent容器也加入new-network网络，否则无法通过容器名访问LocalStack。

2. 针对Jenkins容器化部署的场景 #

如果Jenkins本身运行在容器中，localhost指向Jenkins容器内部而非宿主机，此时有两种解决方式：

• 将Jenkins容器加入new-network：启动Jenkins容器时添加--network new-network参数，之后就能直接用localstack作为地址访问。
• 使用宿主机实际IP：替换localhost为宿主机的局域网IP（如192.168.1.100），同时确保宿主机防火墙允许4566端口的入站请求。

3. 替换硬编码sleep为可靠的健康检查 #

sleep 20是不可靠的等待方式，建议用循环检查确保S3服务就绪：

script {
    def healthPassed = false
    for (int i = 0; i < 10; i++) {
        try {
            // 检查S3服务是否处于running状态
            sh 'docker exec localstack curl -s http://localhost:4566/_localstack/health | grep "\"s3\": \"running\""'
            healthPassed = true
            break
        } catch (Exception e) {
            sh 'sleep 3'
        }
    }
    if (!healthPassed) {
        error 'LocalStack S3服务超时未启动'
    }
}

4. 排查宿主机端口访问问题 #

如果Jenkins运行在宿主机上但仍无法访问端口：

• 确认宿主机防火墙/安全组未阻止4566端口。
• 尝试用127.0.0.1代替0.0.0.0执行curl：curl 127.0.0.1:4566/_localstack/health。

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