如何在Dockerfile中安装本地npm包？

问题根源 #

Docker构建时默认仅将执行docker build命令的当前目录（如app1）作为构建上下文，该上下文之外的文件（比如上级目录的my_package）不会被纳入镜像构建环境，因此npm在镜像内无法找到指定的本地包文件，引发ENOENT错误。

方法1：调整构建上下文到根目录 #

1. 确保app1/package.json中本地包的依赖路径为相对根目录的格式：

   "@my_package": "file:../my_package/package.tgz"
   

2. 从根目录执行构建命令，指定app1的Dockerfile路径：

   docker build ../ -t js/app1 -f app1/Dockerfile
   

3. 修改app1/Dockerfile，先将本地包复制到镜像工作目录，避免路径解析问题：

   FROM node:16
   
   WORKDIR /app
   
   # 从根上下文复制本地包到工作目录
   COPY my_package/package.tgz .
   COPY package.json .
   RUN npm install
   
   # 复制应用源码
   COPY app1/ .
   
   EXPOSE 4002
   CMD ["npm", "start"]
   

方法2：将本地包复制到应用目录内 #

这是最简单的快速解决方式：

1. 将my_package/package.tgz复制到app1目录下：

   cp ../my_package/package.tgz ./app1/
   

2. 修改app1/package.json中的依赖路径为当前目录：

   "@my_package": "file:./package.tgz"
   

3. 正常执行原构建命令：

   docker build . -t js/app1
   

方法3：使用多阶段构建传递本地包 #

无需复制文件到应用目录，适合保持目录结构整洁的场景：

# 第一阶段：仅复制本地包
FROM node:16 AS package-stage
COPY ../my_package/package.tgz /tmp/package.tgz

# 第二阶段：构建应用
FROM node:16
WORKDIR /app

# 从第一阶段复制本地包到工作目录
COPY --from=package-stage /tmp/package.tgz .
COPY package.json .
RUN npm install

COPY . .

EXPOSE 4002
CMD ["npm", "start"]

执行构建时需指定根目录为上下文：

docker build ../ -t js/app1 -f app1/Dockerfile

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