Docker只读挂载中使用uv sync避免生成.egg-info文件的方案

问题根源 #

报错是因为setuptools构建local-shared时，默认会在源码目录生成.egg-info文件夹，但packages目录被挂载为只读，导致权限不足。

解决方案 #

方案1：指定uv的临时构建目录（推荐） #

在uv sync命令中添加--build-dir参数，将构建过程转移到Docker容器内的可写临时目录（比如/tmp/uv-build），这样不会修改只读的packages目录。

修改后的Dockerfile命令：

RUN --mount=type=cache,target=/root/.cache/uv \
    --mount=type=bind,source=uv.lock,target=uv.lock \
    --mount=type=bind,source=pyproject.toml,target=pyproject.toml \
    --mount=type=bind,source=packages,target=/app/packages \
    uv sync --package ftp-mock --locked --no-editable --build-dir /tmp/uv-build

方案2：修改本地包的构建配置 #

如果希望从根源避免生成.egg-info，可以更新local-shared的pyproject.toml，改用现代构建后端（如hatchling），这类后端默认会在临时目录完成构建，不会改动源码目录：

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

或者如果坚持使用setuptools，可配置它将.egg-info生成到临时目录：

[tool.setuptools]
egg-info-dir = "/tmp/local-shared-egg-info"

方案3：单独挂载所需子目录（可选） #

如果不想修改命令或包配置，可以只挂载ftp-mock和local-shared目录为只读，而非整个packages，但这种方式会增加挂载命令的复杂度，不如前两种方案简洁。

验证执行 #

采用方案1修改后，重新构建Docker镜像，uv sync会在/tmp/uv-build目录内完成local-shared的构建，不会再尝试修改只读的packages目录，即可解决报错。

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