adding-docker

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Add Docker

添加Docker支持

Use this skill when the user asks to dockerize, containerize, or add Docker support to an application.
当用户要求对应用进行Docker容器化、封装或添加Docker支持时,可使用本技能。

Steps

步骤

  1. Detect the runtime — inspect
    package.json
    ,
    requirements.txt
    ,
    go.mod
    ,
    Cargo.toml
    , etc. to determine the language and runtime.
  2. Create a multi-stage
    Dockerfile
    For Node.js (example):
    dockerfile
    FROM node:20-alpine AS base
    
    FROM base AS deps
    WORKDIR /app
    COPY package.json package-lock.json ./
    RUN npm ci --omit=dev
    
    FROM base AS build
    WORKDIR /app
    COPY package.json package-lock.json ./
    RUN npm ci
    COPY . .
    RUN npm run build
    
    FROM base AS runner
    WORKDIR /app
    ENV NODE_ENV=production
    COPY --from=deps /app/node_modules ./node_modules
    COPY --from=build /app/.next ./.next
    COPY --from=build /app/public ./public
    COPY --from=build /app/package.json ./
    EXPOSE 3000
    CMD ["npm", "start"]
    Adapt for the detected framework — adjust the build output directory, entry command, and base image.
  3. Create
    .dockerignore
    node_modules
    .next
    .git
    .env*
    *.md
  4. Create
    docker-compose.yml
    (if the app has dependencies like a database or Redis):
    yaml
    services:
      app:
        build: .
        ports:
          - "3000:3000"
        env_file: .env
        depends_on:
          - db
      db:
        image: postgres:16-alpine
        environment:
          POSTGRES_DB: app
          POSTGRES_USER: postgres
          POSTGRES_PASSWORD: postgres
        volumes:
          - pgdata:/var/lib/postgresql/data
    volumes:
      pgdata:
  5. Add npm scripts (optional)
    json
    {
      "docker:build": "docker build -t myapp .",
      "docker:run": "docker compose up"
    }
  1. 检测运行时环境 —— 检查
    package.json
    、
    requirements.txt
    、
    go.mod
    、
    Cargo.toml
    等文件,确定应用使用的语言和运行时环境。
  2. 创建多阶段构建的
    Dockerfile
    Node.js示例:
    dockerfile
    FROM node:20-alpine AS base
    
    FROM base AS deps
    WORKDIR /app
    COPY package.json package-lock.json ./
    RUN npm ci --omit=dev
    
    FROM base AS build
    WORKDIR /app
    COPY package.json package-lock.json ./
    RUN npm ci
    COPY . .
    RUN npm run build
    
    FROM base AS runner
    WORKDIR /app
    ENV NODE_ENV=production
    COPY --from=deps /app/node_modules ./node_modules
    COPY --from=build /app/.next ./.next
    COPY --from=build /app/public ./public
    COPY --from=build /app/package.json ./
    EXPOSE 3000
    CMD ["npm", "start"]
    根据检测到的框架进行适配 —— 调整构建输出目录、启动命令和基础镜像。
  3. 创建
    .dockerignore
    文件
    node_modules
    .next
    .git
    .env*
    *.md
  4. 创建
    docker-compose.yml
    文件
    (如果应用依赖数据库或Redis等服务):
    yaml
    services:
      app:
        build: .
        ports:
          - "3000:3000"
        env_file: .env
        depends_on:
          - db
      db:
        image: postgres:16-alpine
        environment:
          POSTGRES_DB: app
          POSTGRES_USER: postgres
          POSTGRES_PASSWORD: postgres
        volumes:
          - pgdata:/var/lib/postgresql/data
    volumes:
      pgdata:
  5. 添加npm脚本(可选)
    json
    {
      "docker:build": "docker build -t myapp .",
      "docker:run": "docker compose up"
    }

Notes

注意事项

  • Use Alpine-based images to minimize image size.
  • Never copy
    .env
    files into the image — use
    env_file
    or runtime injection.
  • For monorepos, use a
    .dockerignore
    that excludes sibling packages not needed by the target app.
  • Add a
    HEALTHCHECK
    instruction for production deployments.
  • 使用基于Alpine的镜像以最小化镜像体积。
  • 切勿将
    .env
    文件复制到镜像中 —— 使用
    env_file
    或运行时注入方式。
  • 对于单体仓库,使用
    .dockerignore
    排除目标应用不需要的同级包。
  • 生产部署时添加
    HEALTHCHECK
    指令。