Github Actions中测试用例无法连接Docker Swarm部署的RabbitMQ

1. 网络可达性排查 #

• 确认RabbitMQ监听配置：Docker Swarm部署时，需设置环境变量RABBITMQ_NODE_IP_ADDRESS=0.0.0.0，让RabbitMQ监听所有网卡（默认仅监听localhost，外部无法访问）。
• 测试端口连通性：在Github Actions workflow中添加步骤，验证runner能否访问RabbitMQ端口：

  - name: Test RabbitMQ connectivity
    run: nc -zv <rabbitmq-host> 5672
  

• 检查Swarm服务端口暴露：确保部署RabbitMQ时正确映射端口，示例命令：

  docker service create --name rabbitmq --publish 5672:5672 rabbitmq:3-management
  

  若使用Ingress网络，确认Swarm的Ingress网络正常运行。

2. 防火墙与安全组限制 #

• 检查RabbitMQ所在主机的防火墙规则，允许5672（AMQP端口）和15672（管理端口，若使用）的入站流量。
• 若RabbitMQ部署在云服务器，检查云服务商安全组配置，确保开放对应端口给Github Actions的IP段（可临时开放0.0.0.0/0测试，测试后收紧规则）。

3. 认证与权限配置 #

• 禁用默认guest账号：RabbitMQ默认guest账号仅允许localhost访问，需创建新用户并授予权限：

  rabbitmqctl add_user testuser testpass
  rabbitmqctl set_user_tags testuser administrator
  rabbitmqctl set_permissions -p / testuser ".*" ".*" ".*"
  

• 核对Actions环境变量：确保测试用例使用的RabbitMQ账号、密码、主机地址等环境变量与本地测试完全一致，无配置错误。

4. Github Actions Runner网络环境 #

• 托管runner注意事项：Github托管的runner处于官方云环境，需确保RabbitMQ服务为公网可访问状态（本地Swarm集群无法被托管runner直接访问）。
• 自托管runner配置：将runner部署在能访问Swarm集群的网络中，检查runner能否解析RabbitMQ主机名、ping通主机。

5. Swarm服务状态检查 #

• 查看RabbitMQ服务运行状态：

  docker service ls
  docker service logs rabbitmq
  

  确认服务无重启、报错，副本正常运行。

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