使用node:16.15.0-alpine构建镜像时拉取私有Git仓库失败

问题概述 #

使用node:16.15.0-alpine构建Vue前端Docker镜像时，因package.json包含私有Bitbucket仓库依赖导致构建失败；切换到node:16.15.0镜像可成功构建，但镜像体积高达1.8GB，不符合轻量化需求。

相关配置 #

Dockerfile #

FROM node:16.15.0-alpine as develop-stage
# make the 'app' folder the current working directory
WORKDIR /app

# copy both 'package.json' and 'package-lock.json' (if available)
COPY package*.json ./

# install project dependencies
RUN npm install 

# copy project files and folders to the current working directory (i.e. 'app' folder)
COPY . .

EXPOSE 80

ENTRYPOINT [ "npm", "run", "dev" ]

Docker-compose #

version: '3.8'
services:
    frontend:
        container_name: frontend-test
        image: frontend-test:latest
        build: 
            context:.
            dockerfile: ./dockerfile.dev
            target: 'develop-stage'
        networks:
            - test-app-network
        environment:
             - CHOKIDAR_USEPOLLING: true
        ports:
            - 8080:8080
volumes:
  test-data:
    external: false

networks:
  test-app-network:
    external: false

package.json片段 #

...
dependencies: {
  "private-repo": "git+https://username:apppassword@bitbucket.org/myproject/myrepo.git"
}
...

问题原因 #

• node:16.15.0-alpine是精简镜像，默认未安装git工具，而npm安装Git私有仓库依赖时需要通过git克隆仓库，因此构建失败。
• node:16.15.0基于Debian系统，预装了git等完整工具链，能正常安装私有依赖，但镜像包含大量冗余组件，导致体积过大。

解决方案 #

1. 修改Dockerfile，临时安装git后清理 #

在安装依赖前先安装git，完成后删除git以减小镜像体积：

FROM node:16.15.0-alpine as develop-stage
WORKDIR /app

# 安装git和openssh（克隆Git仓库必需），--no-cache避免缓存冗余文件
RUN apk add --no-cache git openssh

COPY package*.json ./
RUN npm install 

# 依赖安装完成后，删除git和openssh，减少镜像体积
RUN apk del git openssh
# 额外清理npm缓存进一步瘦身
RUN npm cache clean --force

COPY . .

EXPOSE 80
ENTRYPOINT [ "npm", "run", "dev" ]

2. 修正Docker-compose环境变量格式 #

原配置中环境变量写法有误，需改为标准格式：

environment:
  CHOKIDAR_USEPOLLING: true
# 或数组形式
# environment:
#   - CHOKIDAR_USEPOLLING=true

3. 进阶：多阶段构建优化生产镜像（可选） #

如果是构建生产镜像，可通过多阶段构建分离开发依赖和生产产物，进一步减小体积：

# 第一阶段：安装依赖并构建
FROM node:16.15.0-alpine as builder
WORKDIR /app
RUN apk add --no-cache git openssh
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build
RUN apk del git openssh
RUN npm cache clean --force

# 第二阶段：仅复制构建产物和运行时依赖
FROM node:16.15.0-alpine as production-stage
WORKDIR /app
COPY --from=builder /app/dist ./dist
# 如果需要运行服务，可安装serve等工具
RUN npm install -g serve
EXPOSE 80
ENTRYPOINT [ "serve", "-s", "dist", "-l", "80" ]

内容的提问来源于stack exchange，提问作者power-cut