如何在node:16.15.1-alpine镜像中添加Python2以构建node-sass？

问题背景 #

项目依赖node-sass@4.14.1，该版本构建必须依赖Python2；原本基于node:16.15.0-alpine（alpine 3.15）可通过apk add python2正常安装，但升级到node:16.15.1-alpine（alpine 3.16）后，apk源已移除Python2包，且无法用Python3替代（依赖的node-gyp@3.8.0不兼容Python3），同时无法升级node-sass版本。

可行解决方案 #

方案1：多阶段构建从旧alpine镜像复制Python2文件 #

利用node:16.15.0-alpine（含Python2）作为临时镜像，将Python2的二进制文件、依赖库及相关配置复制到目标镜像中：

# 第一阶段：从旧镜像获取Python2
FROM node:16.15.0-alpine as python2-source
RUN apk add --no-cache python2

# 第二阶段：目标构建镜像
FROM node:16.15.1-alpine as builder

# 复制Python2的相关文件
COPY --from=python2-source /usr/bin/python2.7 /usr/bin/python2.7
COPY --from=python2-source /usr/bin/python /usr/bin/python
COPY --from=python2-source /usr/lib/libpython2.7.so.1.0 /usr/lib/libpython2.7.so.1.0
COPY --from=python2-source /usr/lib/python2.7 /usr/lib/python2.7

# 安装构建依赖
RUN apk add --no-cache make g++

# 设置PYTHON环境变量指向Python2
ENV PYTHON=/usr/bin/python2.7

# 后续构建步骤
ADD app/package.json .
RUN CXXFLAGS="--std=c++14" npm install

方案2：从Alpine归档源安装Python2包 #

Alpine的归档服务器保留了旧版本的包，可以临时切换到alpine 3.15的源来安装Python2，安装完成后再恢复默认源：

FROM node:16.15.1-alpine as builder

# 临时替换为alpine 3.15的源
RUN echo "http://dl-cdn.alpinelinux.org/alpine/v3.15/main" > /etc/apk/repositories && \
    echo "http://dl-cdn.alpinelinux.org/alpine/v3.15/community" >> /etc/apk/repositories && \
    # 安装Python2及构建依赖
    apk add --no-cache python2 make g++ && \
    # 恢复默认的alpine 3.16源
    echo "http://dl-cdn.alpinelinux.org/alpine/v3.16/main" > /etc/apk/repositories && \
    echo "http://dl-cdn.alpinelinux.org/alpine/v3.16/community" >> /etc/apk/repositories

# 设置PYTHON环境变量
ENV PYTHON=/usr/bin/python2

# 后续构建步骤
ADD app/package.json .
RUN CXXFLAGS="--std=c++14" npm install

方案3：手动编译Python2.7（不推荐，耗时较长） #

如果上述两种方法不可行，可以手动在镜像中编译Python2.7：

FROM node:16.15.1-alpine as builder

# 安装编译依赖
RUN apk add --no-cache make g++ wget tar zlib-dev openssl-dev

# 下载并编译Python2.7.18
RUN wget https://www.python.org/ftp/python/2.7.18/Python-2.7.18.tgz && \
    tar xzf Python-2.7.18.tgz && \
    cd Python-2.7.18 && \
    ./configure --prefix=/usr/local --enable-shared && \
    make && make install && \
    # 清理编译文件
    cd .. && rm -rf Python-2.7.18 Python-2.7.18.tgz

# 设置环境变量
ENV PYTHON=/usr/local/bin/python2
ENV LD_LIBRARY_PATH=/usr/local/lib

# 安装其他构建依赖
RUN apk add --no-cache make g++

# 后续构建步骤
ADD app/package.json .
RUN CXXFLAGS="--std=c++14" npm install

注意事项 #

• 方案1和方案2相对更高效，推荐优先尝试；方案3编译耗时久，镜像体积也会更大。
• 安装完成后务必设置PYTHON环境变量，确保node-gyp调用Python2而非Python3。

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