如何优化Jenkins多流水线共享pnpm缓存的跨设备链接问题？

下面是几种可行的优化方案：

方案1：指定共享缓存目录+改用软链接模式 #

pnpm默认的硬链接不支持跨设备，我们可以通过环境变量指定全局共享缓存目录，并让pnpm使用软链接替代硬链接：

1. 先在Jenkins宿主机创建一个全局共享的pnpm缓存目录，确保权限正确：

mkdir -p /var/jenkins_home/shared-pnpm-store
chown jenkins:jenkins /var/jenkins_home/shared-pnpm-store

2. 修改你的docker运行命令，挂载这个共享目录到容器内，同时通过环境变量配置pnpm：

docker run --rm \
    -v $HOME:$HOME -e HOME \
    -v $PWD:$PWD -w $PWD \
    -v /var/jenkins_home/shared-pnpm-store:/pnpm-store \
    -e PNPM_STORE_DIR=/pnpm-store \
    -e PNPM_PACKAGE_IMPORT_METHOD=symlink \
    pnpm pnpm install-and-build

• PNPM_STORE_DIR：强制pnpm使用指定的共享目录作为缓存
• PNPM_PACKAGE_IMPORT_METHOD=symlink：用软链接代替硬链接，完美适配跨设备场景，不会在工作目录生成本地.pnpm-store

方案2：让缓存目录和工作目录在同一设备 #

如果你的Jenkins工作目录（$PWD）和共享缓存目录能放在宿主机的同一存储设备上，pnpm就能正常使用硬链接，避免跨设备问题：

1. 在Jenkins工作目录的上级共享路径创建缓存目录：

# 假设Jenkins所有工作目录都在/var/jenkins_home/workspaces下
mkdir -p /var/jenkins_home/workspaces/shared-pnpm-store
chown jenkins:jenkins /var/jenkins_home/workspaces/shared-pnpm-store

2. 修改挂载命令，把这个目录映射到容器内的$HOME/.pnpm-store：

docker run --rm \
    -v $HOME:$HOME -e HOME \
    -v $PWD:$PWD -w $PWD \
    -v /var/jenkins_home/workspaces/shared-pnpm-store:$HOME/.pnpm-store \
    pnpm pnpm install-and-build

此时容器内的缓存目录和工作目录对应宿主机的同一设备，pnpm会直接使用全局缓存，不会在工作目录生成本地缓存。

方案3：用全局配置文件统一管理 #

可以在宿主机创建pnpm的全局配置文件，挂载到容器内，让所有流水线自动复用配置：

1. 创建全局.pnpmrc配置文件：

mkdir -p /var/jenkins_home/pnpm-config
echo "store-dir=/pnpm-store" >> /var/jenkins_home/pnpm-config/.pnpmrc
echo "package-import-method=symlink" >> /var/jenkins_home/pnpm-config/.pnpmrc
chown jenkins:jenkins /var/jenkins_home/pnpm-config/.pnpmrc

2. 修改docker命令挂载配置文件和共享缓存：

docker run --rm \
    -v $HOME:$HOME -e HOME \
    -v $PWD:$PWD -w $PWD \
    -v /var/jenkins_home/shared-pnpm-store:/pnpm-store \
    -v /var/jenkins_home/pnpm-config/.pnpmrc:/root/.pnpmrc \
    pnpm pnpm install-and-build

这样所有使用该命令的流水线都会自动读取全局配置，无需每次指定环境变量。

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