如何将Python RabbitMQ消费者打包进Docker镜像并解决运行与连接问题

我有一个运行在Python文件中的RabbitMQ监听器，本地通过命令python .\src\rabbitmq_daemon.py可正常运行。但使用如下Dockerfile构建镜像后，容器未将其作为后台进程运行，进入交互式会话后仅显示Python控制台；尝试两种CMD指令均无效果，且容器内无法连接RabbitMQ服务器。

Dockerfile内容：

FROM python:3.9

WORKDIR /usr/src/app

ENV PYTHONDONTWRITEBYTECODE 1
ENV PYTHONUNBUFFERED 1

RUN pip install --upgrade pip
COPY ./requirements.txt /usr/src/app

COPY . /usr/src/app

RUN \
 apt-get update && \
 python3 -m pip install -r requirements.txt --no-cache-dir

#CMD ["python", "-m", "src", "rabbitmq_daemon.py"]
CMD python /usr/src/app/src/rabbitmq_daemon.py

尝试过的CMD指令：

CMD ["python", "-m", "src", "rabbitmq_daemon.py"]

容器运行交互会话结果：

> docker run -it doc-extr:6
Python 3.9.15 (main, Nov 15 2022, 21:37:24)
[GCC 10.2.1 20210110] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> quit()

一、解决容器启动进入Python控制台的问题 #

当前CMD指令存在错误，导致Python找不到目标脚本，直接进入交互模式。修正步骤如下：

1. 排查CMD写法问题：

   • 用-m参数的写法错误：python -m src rabbitmq_daemon.py要求src是带__init__.py的Python模块，而你的src只是普通脚本目录，这种写法无法正确执行目标文件。
   • 绝对路径写法虽正确，但脚本可能依赖当前工作目录的相对路径资源，导致执行异常后进入Python交互模式。

2. 修正CMD指令：
   改用WORKDIR下的相对路径，推荐使用exec格式（避免shell解析问题）：

   CMD ["python", "src/rabbitmq_daemon.py"]
   

   或shell格式：

   CMD python src/rabbitmq_daemon.py
   

3. 验证启动效果：
   重新构建镜像后，先不带-it参数运行容器：

   docker run doc-extr:6
   

   若脚本正常启动，会输出监听器日志；若报错，用docker logs <容器ID>查看具体问题。如果需要交互式调试，可强制指定启动命令：

   docker run -it --entrypoint python doc-extr:6 src/rabbitmq_daemon.py
   

二、解决容器内无法连接RabbitMQ服务器的问题 #

根据RabbitMQ的部署位置，分两种场景处理：

场景1：RabbitMQ运行在本地主机（非Docker容器） #

容器默认处于独立网络，无法直接访问本地localhost，需做如下配置：

• Windows/Mac环境：运行容器时添加主机映射，让容器内的host.docker.internal指向本地主机：

  docker run -d --add-host=host.docker.internal:host-gateway doc-extr:6
  

  同时修改Python脚本中的RabbitMQ连接地址为host.docker.internal（替换原localhost）。
• Linux环境：使用主机网络模式，让容器复用主机网络栈：

  docker run -d --network host doc-extr:6
  

  此时脚本中的localhost可直接指向本地RabbitMQ。

场景2：RabbitMQ运行在另一个Docker容器 #

需将两个容器加入同一Docker网络，通过容器名称通信：

1. 创建专用网络：

   docker network create rabbitmq-network
   

2. 启动RabbitMQ容器并加入网络：

   docker run -d --name rabbitmq-server --network rabbitmq-network rabbitmq:3-management
   

3. 启动当前容器并加入同一网络：

   docker run -d --name doc-extr --network rabbitmq-network doc-extr:6
   

4. 修改脚本配置：将RabbitMQ连接地址设为rabbitmq-server（即RabbitMQ容器的名称）。

通用检查项 #

• 确认RabbitMQ已开启远程访问：避免使用默认guest用户（仅允许本地访问），创建具备远程权限的用户；确保RabbitMQ监听地址为0.0.0.0（默认配置已满足）。

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