本文档旨在解决在使用 Red Hat UBI8-Python 镜像构建 Docker 镜像时，pip 命令无法找到的问题。通过分析镜像环境，找到 pip 的实际路径，并提供正确的 pip 命令使用方式，帮助开发者顺利安装 Python 依赖。本文还介绍了如何查找 Python 和 Pip 的安装路径，以便在 Dockerfile 中正确使用。
在 UBI8-Python Docker 镜像中使用 Pip
在使用 Red Hat UBI8-Python 镜像构建 Docker 镜像时，你可能会遇到 pip 命令无法找到的问题。这通常是因为
环境变量
没有正确配置，或者 pip 没有被添加到系统的 PATH 中。
问题分析
当你在 Dockerfile 中使用 RUN pip install ... 命令时，系统会在默认的 PATH 环境变量中查找 pip 命令。如果 pip 的安装路径不在 PATH 中，就会出现 "pip: command not found" 的错误。
解决方案
解决这个问题的方法是找到 pip 的实际安装路径，并在 Dockerfile 中使用完整的路径来执行 pip 命令。
立即学习
“
Python免费学习笔记（深入）
”；
1. 查找 Python 和 Pip 的安装路径
在 Dockerfile 中添加以下命令来查找 Python 和 Pip 的安装路径：
构建镜像后，查看构建日志，你将会看到类似以下的输出：
Docker Sandbox
创建并管理 Docker 沙箱虚拟机环境以安全执行代理。适用于运行不受信任代码、探索包或隔离代理工作负载。支持 Claude、Codex、Copilot、Gemini 和 Kiro 代理，并提供网络代理控制。
下载
这表明 Python 和 Pip 的安装路径分别为 /opt/
python
/bin/python3.11 和 /opt/python/bin/pip3.11。
2. 使用完整的 Pip 路径
在 Dockerfile 中，使用完整的 pip 路径来安装依赖：
将 RUN pip install ... 替换为 RUN /opt/python/bin/pip3.11 install ...。这样，Docker 就能找到 pip 命令并成功安装依赖。
完整示例
下面是一个完整的 Dockerfile 示例：
注意事项
确保你的 requirements.txt 文件位于 src 目录下，或者根据实际情况修改 ADD src . 命令。
根据你的 Python 版本，pip 的路径可能会有所不同。请使用 whereis pip 命令来确认正确的路径。
在 OpenShift 环境中，需要注意用户权限的问题。示例 Dockerfile 中使用了 USER 0 和 USER 1001 命令来设置用户权限。
总结
通过查找 pip 的实际安装路径，并在 Dockerfile 中使用完整的路径来执行 pip 命令，可以解决在使用 UBI8-Python 镜像构建 Docker 镜像时 pip 命令无法找到的问题。希望本文档能够帮助你顺利完成 Python 项目的 Docker 化。
RUN whereis python
RUN whereis pip/opt/python/bin/python3.11
/opt/python/bin/pip3.11FROM :18444/ubi8-python:3.11
# Add application sources with correct permissions for OpenShift
USER 0
ADD src .
RUN chown -R 1001:0 ./
USER 1001
ENV ENABLE_PIPENV=True
# Install the dependencies
RUN /opt/python/bin/pip3.11 install -U "pip>=19.3.1" && \
/opt/python/bin/pip3.11 install -r requirements.txt
# Run the application
CMD ["python", "main.py"] FROM :18444/ubi8-python:3.11
# Add application sources with correct permissions for OpenShift
USER 0
ADD src .
RUN chown -R 1001:0 ./
USER 1001
ENV ENABLE_PIPENV=True
# Install the dependencies
RUN /opt/python/bin/pip3.11 install -U "pip>=19.3.1" && \
/opt/python/bin/pip3.11 install -r requirements.txt
# Run the application
CMD ["python", "main.py"]