pnpm fetch
获取锁文件中列出的包到虚拟存储中,包清单将被忽略。
使用场景
此命令专门用于改进构建 Docker 镜像。
你可能已经阅读了如何为 Node.js 应用程序编写 Dockerfile 的 官方指南,如果你还没有阅读,你可能需要先阅读它。
从该指南中,我们学会了如何为使用 pnpm 的项目编写优化的 Dockerfile ,这将类似于
FROM node:20
# 某处的路径
WORKDIR /path/to/somewhere
RUN corepack enable pnpm && corepack install -g pnpm@latest-9
# 执行 pnpm 安装所需的文件
COPY .npmrc package.json pnpm-lock.yaml .pnpmfile.cjs ./
# 如果您修补了任何软件包,在安装前包含补丁
COPY patches patches
RUN pnpm install --frozen-lockfile --prod
# 捆绑应用程序源
COPY .
EXPOSE 8080
CMD [ "node", "server.js" ]
只要不更改 .npmrc
, package.json
, pnpm-lock.yaml
,
.pnpmfile.cjs
, Docker 构建缓存一直有效至
RUN pnpm install --frozen-lockfile --prod
层,而其在构建 Docker 镜像时耗费绝大部分时间。
但是,对 package.json
的修改可能比我们预期的
频繁得多,因为它不仅包含依赖,而且还可能包含版本号,脚本和其他工具的任意配置。
维护构建 monorepo 项目的 Dockerfile 也很困难,它可能 看起来像
FROM node:20
# 某处的路径
WORKDIR /path/to/somewhere
RUN corepack enable pnpm && corepack install -g pnpm@latest-9
# 执行 pnpm 安装所需的文件
COPY .npmrc package.json pnpm-lock.yaml .pnpmfile.cjs ./
# 如果您修补了任何软件包,在安装前包含补丁
COPY patches patches
# 对于每个子软件包,我们需要添加一个步骤拷贝它的清单文件
# 到正确的地点,因为 docker 未提供方式来通过单个指令仅过滤 package.json
COPY packages/foo/package.json packages/foo/
COPY packages/bar/package.json packages/bar/
RUN pnpm install --frozen-lockfile --prod
# 捆绑应用程序源
COPY .
EXPOSE 8080
CMD [ "node", "server.js" ]
如你所见,当你添加或删除子软件包时,必须更新 Dockerfile。
pnpm fetch
通过提供仅使用锁文件中的信息向虚拟存储中加载软件包的能力来完美地解决上述问题。
FROM node:20
# 某处的路径
WORKDIR /path/to/somewhere
RUN corepack enable pnpm && corepack install -g pnpm@latest-9
# pnpm fetch 仅需 lockfile
COPY pnpm-lock.yaml ./
# 如果你修补了任何包,在运行 pnpm fetch 之前包含补丁
COPY patches patches
RUN pnpm fetch --prod
ADD ../
RUN pnpm install -r --offline --prod
EXPOSE 8080
CMD [ "node", "server.js" ]
它既适用于简单项目,也适用于 monorepo 项目, --offline
会强制 pnpm 不与包注册源通信,因为所有需要的软件包都应该已经存在于虚拟存储中。
只要锁文件没有改变,构建缓存直到层都有效,所以 RUN pnpm install -r --offline --prod
,将为你节省大量时间。
配置项
--dev, -D
只会获取开 发软件包
--prod, -P
不会获取开发软件包