改造现有 Dockerfile 集成 Python 探针只需在原有基础上添加两行命令。原始 Dockerfile 通常如下:基于 python:3.10 基础镜像,设置工作目录 /app,复制 requirements.txt 并安装依赖,复制 app.py,最后通过 CMD ["python", "app.py"] 启动。改造后需要在依赖安装之后、复制业务代码之前插入:RUN pip3 install aliyun-bootstrap && aliyun-bootstrap -a install,并将启动命令改为 CMD ["aliyun-instrument", "python", "app.py"]。注意事项:有使用 uvicorn 启动的应用,需要将 uvicorn -w 4 -b 0.0.0.0:8000 app:app 改为 gunicorn -w 4 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 app:app,因为 uvicorn 的多进程模式与探针存在兼容性问题;有使用 gevent 协程(程序中包含 from gevent import monkey; monkey.patch_all())的应用,必须设置环境变量 GEVENT_ENABLE=true,否则探针无法正确 patch 异步上下文。整个改造过程对业务代码零侵入,仅需修改容器构建配置即可启用全链路追踪。




