adding-docker
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseAdd Docker
添加Docker支持
Use this skill when the user asks to dockerize, containerize, or add Docker support to an application.
当用户要求对应用进行Docker容器化、封装或添加Docker支持时,可使用本技能。
Steps
步骤
-
Detect the runtime — inspect,
package.json,requirements.txt,go.mod, etc. to determine the language and runtime.Cargo.toml -
Create a multi-stage
DockerfileFor Node.js (example):dockerfileFROM 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 /app/node_modules ./node_modules COPY /app/.next ./.next COPY /app/public ./public COPY /app/package.json ./ EXPOSE 3000 CMD ["npm", "start"]Adapt for the detected framework — adjust the build output directory, entry command, and base image. -
Create
.dockerignorenode_modules .next .git .env* *.md -
Create(if the app has dependencies like a database or Redis):
docker-compose.ymlyamlservices: 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: -
Add npm scripts (optional)json
{ "docker:build": "docker build -t myapp .", "docker:run": "docker compose up" }
-
检测运行时环境 —— 检查、
package.json、requirements.txt、go.mod等文件,确定应用使用的语言和运行时环境。Cargo.toml -
创建多阶段构建的
DockerfileNode.js示例:dockerfileFROM 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 /app/node_modules ./node_modules COPY /app/.next ./.next COPY /app/public ./public COPY /app/package.json ./ EXPOSE 3000 CMD ["npm", "start"]根据检测到的框架进行适配 —— 调整构建输出目录、启动命令和基础镜像。 -
创建文件
.dockerignorenode_modules .next .git .env* *.md -
创建文件(如果应用依赖数据库或Redis等服务):
docker-compose.ymlyamlservices: 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: -
添加npm脚本(可选)json
{ "docker:build": "docker build -t myapp .", "docker:run": "docker compose up" }
Notes
注意事项
- Use Alpine-based images to minimize image size.
- Never copy files into the image — use
.envor runtime injection.env_file - For monorepos, use a that excludes sibling packages not needed by the target app.
.dockerignore - Add a instruction for production deployments.
HEALTHCHECK
- 使用基于Alpine的镜像以最小化镜像体积。
- 切勿将文件复制到镜像中 —— 使用
.env或运行时注入方式。env_file - 对于单体仓库,使用排除目标应用不需要的同级包。
.dockerignore - 生产部署时添加指令。
HEALTHCHECK