如何在bitnami/deepspeed:0.14.0镜像中以deepspeed用户使用uv安装Python包？

问题原因 #

你遇到的uv: command not found错误，本质是bitnami/deepspeed镜像默认用deepspeed非root用户运行，该用户没有系统级Python包目录的写入权限，pip自动采用用户级安装模式，把uv装到了用户家目录的~/.local/bin下，但这个目录不在默认PATH环境变量里，导致bash找不到uv命令。而官方python镜像默认用root用户，安装到系统bin目录（已在PATH中），所以不会出现这个问题。

解决方案（无需切换到root） #

以下两种方法都能让你以deepspeed用户身份正常使用uv：

方法1：直接指定uv的完整路径运行

已知uv安装在/home/deepspeed/.local/bin/uv，直接用绝对路径调用即可：

FROM bitnami/deepspeed:0.14.0

ENV APP_HOME /app
WORKDIR $APP_HOME

COPY requirements.txt /app

RUN pip install uv && /home/deepspeed/.local/bin/uv pip install --system --no-cache -r requirements.txt

方法2：将用户本地bin目录加入PATH

提前把用户级bin目录添加到PATH环境变量，让bash自动识别uv命令：

FROM bitnami/deepspeed:0.14.0

ENV APP_HOME /app
# 将deepspeed用户的本地bin目录加入PATH
ENV PATH="/home/deepspeed/.local/bin:${PATH}"
WORKDIR $APP_HOME

COPY requirements.txt /app

RUN pip install uv && uv pip install --system --no-cache -r requirements.txt

补充说明 #

两种方法都不需要切换到root用户，符合非root用户的安全运行规范。如果后续还有其他用户级安装的命令需要调用，方法2的PATH配置会更通用。

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