Docker构建Alpine镜像执行pyenv命令遇权限拒绝错误求助

问题描述 #

在基于Alpine的Docker镜像中，通过Python 3.10安装Azure CLI时，构建镜像出现权限拒绝错误，但在运行中的容器内执行相同命令却能正常完成。

构建错误信息 #

=> ERROR [13/16] RUN /$HOME/.pyenv install -v 3.10-dev                                                                                                                                                  0.6s 
------
 > [13/16] RUN /$HOME/.pyenv install -v 3.10-dev:
#17 0.536 /bin/sh: //root/.pyenv: Permission denied
------
executor failed running [/bin/sh -c /$HOME/.pyenv install -v 3.10-dev]: exit code: 126

原Dockerfile内容 #

# Install Azure CLI
RUN apk add libffi-dev ncurses-dev openssl-dev readline-dev tk-dev xz-dev zlib-dev build-base  

# Install pyenv
RUN curl -L https://github.com/pyenv/pyenv-installer/raw/master/bin/pyenv-installer | bash 

RUN export PYENV_ROOT="$HOME/.pyenv" 
RUN command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH" 
RUN eval "$(pyenv init -)" 
RUN eval "$(pyenv virtualenv-init -)" 

# Restart shell after pyenv install to apply changes
RUN exec $SHELL 

RUN /$HOME/.pyenv install -v 3.10-dev 
RUN pyenv global 3.10-dev 
RUN pip install azure-cli 
RUN rm -rf /var/cache/apk/* && \
    apk del libffi-dev ncurses-dev openssl-dev readline-dev tk-dev xz-dev zlib-dev build-base --force-broken-world

构建阶段与运行阶段的核心差异 #

• 每个RUN都是独立的shell进程：Docker中每个RUN指令会启动全新的shell进程，前一个RUN里设置的环境变量、执行的shell初始化操作（比如eval $(pyenv init -)）不会传递到下一个RUN。而进入运行中的容器时，是在同一个交互式shell进程中执行命令，环境变量和初始化状态会持续生效。
• 非交互式vs交互式shell：构建阶段的RUN默认用非交互式shell，不会加载.bashrc、.profile这类shell配置文件；运行容器时进入的是交互式shell，会自动加载配置，pyenv若写入配置文件会自动生效。
• 命令上下文完全隔离：构建阶段的每个RUN都在临时容器的独立上下文执行，和其他RUN状态无关联，RUN exec $SHELL只会替换当前RUN的进程，对后续RUN没有任何作用。

你的Dockerfile具体问题 #

1. 环境变量不持久：用多个RUN分别设置PYENV_ROOT、修改PATH、初始化pyenv，这些操作仅在当前RUN的shell中有效，后续RUN执行时变量和初始化状态全部丢失。
2. 命令调用错误：/$HOME/.pyenv install是错误指令——$HOME/.pyenv是pyenv的安装目录，不是可执行文件，正确调用应为$HOME/.pyenv/bin/pyenv install，或把$HOME/.pyenv/bin加入PATH后直接用pyenv install。因环境变量未传递，命令实际执行的是目录，触发“Permission denied”错误（无法执行目录）。

修复后的Dockerfile #

# Install Azure CLI
RUN apk add libffi-dev ncurses-dev openssl-dev readline-dev tk-dev xz-dev zlib-dev build-base  

# 合并pyenv安装、环境配置、Python安装及Azure CLI安装到一个RUN
RUN curl -L https://github.com/pyenv/pyenv-installer/raw/master/bin/pyenv-installer | bash \
    && export PYENV_ROOT="$HOME/.pyenv" \
    && export PATH="$PYENV_ROOT/bin:$PATH" \
    && eval "$(pyenv init -)" \
    && eval "$(pyenv virtualenv-init -)" \
    && pyenv install -v 3.10-dev \
    && pyenv global 3.10-dev \
    && pip install azure-cli \
    && rm -rf /var/cache/apk/* \
    && apk del libffi-dev ncurses-dev openssl-dev readline-dev tk-dev xz-dev zlib-dev build-base --force-broken-world

修复说明 #

• 所有操作合并到一个RUN中，确保环境变量和pyenv初始化在同一个shell进程中生效，能正确调用pyenv命令。
• 减少镜像层数量，有助于缩小镜像体积。
• 移除无效的RUN exec $SHELL指令，避免无意义操作。

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