Docker配置生成器 - 为前端/后端项目自动创建生产就绪的Dockerfile和docker-compose

ln-731-docker-generator by levnikolaevich/claude-code-skills

216 周安装量

339 GitHub Stars

安装命令

npx skills add https://github.com/levnikolaevich/claude-code-skills --skill ln-731-docker-generator

🇨🇳中文介绍

路径说明： 文件路径（shared/、references/、../ln-*）是相对于技能仓库根目录的。如果在当前工作目录下未找到，请定位此 SKILL.md 文件所在的目录，然后向上返回一级以找到仓库根目录。如果缺少 shared/ 目录，请通过 WebFetch 从 https://raw.githubusercontent.com/levnikolaevich/claude-code-skills/master/skills/{path} 获取文件。

ln-731-docker-generator

类型： L3 Worker 类别： 7XX 项目引导

为容器化开发生成生产就绪的 Docker 配置。

目的与范围

为本地开发和生产环境创建 Docker 基础设施：

功能：生成 Dockerfile、docker-compose.yml、.dockerignore、nginx 配置
不包含：构建镜像、启动容器、管理部署

输入

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

输入	来源	描述
技术栈类型	ln-730 协调器	frontend, backend-dotnet, backend-python
版本	自动检测	Node.js, .NET, Python 版本
项目名称	目录名称	用于容器命名
端口	默认值或检测值	前端：3000，后端：5000/8000，数据库：5432

文件	用途	模板
`Dockerfile.frontend`	前端构建与服务	dockerfile_frontend.template
`Dockerfile.backend`	后端构建与运行	dockerfile_backend_dotnet.template 或 dockerfile_backend_python.template
`docker-compose.yml`	服务编排	docker_compose.template
`.dockerignore`	构建上下文排除项	dockerignore.template
`nginx.conf`	前端代理配置	nginx.template

阶段 1：输入验证

验证从协调器接收到的配置：

检查技术栈类型是否受支持（frontend, backend-dotnet, backend-python）
验证版本是否有效（Node 18+, .NET 8+, Python 3.10+）
确认项目目录存在

输出：验证通过的配置或错误信息

阶段 2：模板选择

根据技术栈选择合适的模板：

技术栈	使用的模板
仅前端	dockerfile_frontend, nginx, dockerignore
后端 .NET	dockerfile_backend_dotnet, docker_compose, dockerignore
后端 Python	dockerfile_backend_python, docker_compose, dockerignore
全栈 .NET	以上所有（dotnet 变体）
全栈 Python	以上所有（python 变体）

阶段 3：变量替换

将模板变量替换为检测到的值：

变量	来源	示例
`{{NODE_VERSION}}`	package.json 中的 engines 或默认值	22
`{{DOTNET_VERSION}}`	*.csproj 中的 TargetFramework	9.0
`{{PYTHON_VERSION}}`	pyproject.toml 或默认值	3.12
`{{PROJECT_NAME}}`	目录名称	my-app
`{{DLL_NAME}}`	*.csproj 中的 AssemblyName	MyApp.Api.dll
`{{FRONTEND_PORT}}`	默认值或检测值	3000
`{{BACKEND_PORT}}`	依赖于技术栈	5000 (.NET), 8000 (Python)
`{{BACKEND_HOST}}`	服务名称	backend
`{{CMD}}`	依赖于框架	`["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]` (FastAPI) 或 `["gunicorn", "--bind", "0.0.0.0:8000", "{{PROJECT_NAME}}.wsgi:application"]` (Django)

阶段 4：文件生成

根据模板生成文件：

检查文件是否已存在（覆盖前警告）
应用变量替换
将文件写入适当位置
在可能的情况下验证语法

Dockerfile.frontend -> src/frontend/Dockerfile
Dockerfile.backend -> 项目根目录
docker-compose.yml -> 项目根目录
.dockerignore -> 项目根目录
nginx.conf -> src/frontend/nginx.conf

前端：React/Vite + Nginx

包含 build 脚本的 package.json
Vite 或 CRA 配置

多阶段 Dockerfile（构建器 + nginx）
包含 SPA 路由和 API 代理的 Nginx 配置

根目录下有 *.sln 文件
包含 TargetFramework 的 *.csproj 文件

多阶段 Dockerfile（SDK 构建 + ASP.NET 运行时）
健康检查端点配置

后端：Python (FastAPI/Django)

requirements.txt 或 pyproject.toml 文件

多阶段 Dockerfile（构建器 + slim 运行时）
uvicorn (FastAPI) 或 gunicorn (Django) 入口点

安全与性能最佳实践

所有生成的文件都遵循以下准则：

实践	实现
非 root 用户	创建并使用 appuser (UID 1001)
最小化镜像	使用 Alpine/slim 变体
多阶段构建	从运行时镜像中排除构建工具
不包含密钥	使用环境变量，而非硬编码
健康检查	内置 HEALTHCHECK 指令（wget/curl）
指定版本	固定基础镜像版本（例如 nginx:1.27-alpine）
非交互模式	ARG DEBIAN_FRONTEND=noninteractive
层缓存	先复制依赖文件，最后复制源代码
BuildKit 缓存	对 pip 使用 `--mount=type=cache`
Python 优化	PYTHONDONTWRITEBYTECODE=1, PYTHONUNBUFFERED=1

生成的文件必须满足：

docker-compose config 验证无误
所有基础镜像均使用指定版本（非 latest）
所有 Dockerfile 中都配置了非 root 用户
所有服务都包含健康检查
.dockerignore 排除了所有敏感文件
没有硬编码的密钥或密码

版本检测：使用从协调器检测到的版本，而非硬编码的默认值。
幂等性：写入前检查文件是否存在。如果覆盖则发出警告。
基于模板：所有生成都使用 references/ 中的模板。不要硬编码文件内容。
安全第一：每个生成的文件都必须遵循安全最佳实践。

文件	用途
dockerfile_frontend.template	React/Vite 多阶段 Dockerfile
dockerfile_backend_dotnet.template	.NET 多阶段 Dockerfile
dockerfile_backend_python.template	Python 多阶段 Dockerfile
docker_compose.template	docker-compose.yml 模板
dockerignore.template	.dockerignore 模板
nginx.template	Nginx 配置

为所有检测到的技术栈组件（前端/后端）生成了 Dockerfile
docker-compose.yml 验证无误（docker-compose config）
.dockerignore 排除了敏感文件和构建产物
所有基础镜像都使用了固定版本（非 latest）

版本： 1.2.0 最后更新： 2026-01-21

🇺🇸English

Paths: File paths (shared/, references/, ../ln-*) are relative to skills repo root. If not found at CWD, locate this SKILL.md directory and go up one level for repo root. If shared/ is missing, fetch files via WebFetch from https://raw.githubusercontent.com/levnikolaevich/claude-code-skills/master/skills/{path}.

ln-731-docker-generator

Type: L3 Worker Category: 7XX Project Bootstrap

Generates production-ready Docker configuration for containerized development.

Purpose & Scope

Creates Docker infrastructure for local development and production:

Does : Generate Dockerfiles, docker-compose, .dockerignore, nginx config
Does NOT : Build images, start containers, manage deployments

Inputs

Input	Source	Description
Stack Type	ln-730 coordinator	frontend, backend-dotnet, backend-python
Versions	Auto-detected	Node.js, .NET, Python versions
Project Name	Directory name	Used for container naming
Ports	Defaults or detected	Frontend: 3000, Backend: 5000/8000, DB: 5432

Outputs

File	Purpose	Template
`Dockerfile.frontend`	Frontend build & serve	dockerfile_frontend.template
`Dockerfile.backend`	Backend build & run	dockerfile_backend_dotnet.template or dockerfile_backend_python.template
`docker-compose.yml`	Service orchestration	docker_compose.template

Workflow

Phase 1: Input Validation

Validate received configuration from coordinator:

Check stack type is supported (frontend, backend-dotnet, backend-python)
Verify versions are valid (Node 18+, .NET 8+, Python 3.10+)
Confirm project directory exists

Output : Validated configuration or error

Phase 2: Template Selection

Select appropriate templates based on stack:

Stack	Templates Used
Frontend only	dockerfile_frontend, nginx, dockerignore
Backend .NET	dockerfile_backend_dotnet, docker_compose, dockerignore
Backend Python	dockerfile_backend_python, docker_compose, dockerignore
Full stack .NET	All of the above (dotnet variant)
Full stack Python	All of the above (python variant)

Phase 3: Variable Substitution

Replace template variables with detected values:

Variable	Source	Example
`{{NODE_VERSION}}`	package.json engines or default	22
`{{DOTNET_VERSION}}`	*.csproj TargetFramework	9.0
`{{PYTHON_VERSION}}`	pyproject.toml or default	3.12
`{{PROJECT_NAME}}`	Directory name	my-app
`{{DLL_NAME}}`	*.csproj AssemblyName

Phase 4: File Generation

Generate files from templates:

Check if file already exists (warn before overwrite)
Apply variable substitution
Write file to appropriate location
Validate syntax where possible

File Locations :

Dockerfile.frontend -> src/frontend/Dockerfile
Dockerfile.backend -> project root
docker-compose.yml -> project root
.dockerignore -> project root
nginx.conf -> src/frontend/nginx.conf

Supported Stacks

Frontend: React/Vite + Nginx

Requirements :

package.json with build script
Vite or CRA configuration

Generated :

Multi-stage Dockerfile (builder + nginx)
Nginx config with SPA routing and API proxy

Backend: .NET 8/9

Requirements :

*.sln file in root
*.csproj with TargetFramework

Generated :

Multi-stage Dockerfile (SDK build + ASP.NET runtime)
Health check endpoint configuration

Backend: Python (FastAPI/Django)

Requirements :

requirements.txt or pyproject.toml

Generated :

Multi-stage Dockerfile (builder + slim runtime)
uvicorn (FastAPI) or gunicorn (Django) entrypoint

Security & Performance Best Practices

All generated files follow these guidelines:

Practice	Implementation
Non-root user	Create and use appuser (UID 1001)
Minimal images	Alpine/slim variants
Multi-stage builds	Exclude build tools from runtime
No secrets	Use environment variables, not hardcoded
Health checks	Built-in HEALTHCHECK instructions (wget/curl)
Specific versions	Pin base image versions (e.g., nginx:1.27-alpine)
Non-interactive mode	ARG DEBIAN_FRONTEND=noninteractive
Layer caching	Copy dependency files first, source code last
BuildKit cache	Use `--mount=type=cache` for pip

Quality Criteria

Generated files must meet:

docker-compose config validates without errors
All base images use specific versions (not latest)
Non-root user configured in all Dockerfiles
Health checks present for all services
.dockerignore excludes all sensitive files
No hardcoded secrets or passwords

Critical Notes

Version Detection : Use detected versions from coordinator, not hardcoded defaults.
Idempotent : Check file existence before writing. Warn if overwriting.
Template-based : All generation uses templates from references/. Do NOT hardcode file contents.
Security First : Every generated file must follow security best practices.

Reference Files

File	Purpose
dockerfile_frontend.template	React/Vite multi-stage Dockerfile
dockerfile_backend_dotnet.template	.NET multi-stage Dockerfile
dockerfile_backend_python.template	Python multi-stage Dockerfile
docker_compose.template	docker-compose.yml template
dockerignore.template	.dockerignore template
nginx.template	Nginx configuration

Definition of Done

Dockerfiles generated for all detected stack components (frontend/backend)
docker-compose.yml validates without errors (docker-compose config)
.dockerignore excludes sensitive files and build artifacts
All base images use pinned versions (not latest)

Version: 1.2.0 Last Updated: 2026-01-21

Weekly Installs

149

Repository

levnikolaevich/…e-skills

GitHub Stars

245

First Seen

Jan 24, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

claude-code136

gemini-cli134

cursor134

opencode134

codex133

github-copilot128

Azure 升级评估与自动化工具 - 轻松迁移 Functions 计划、托管层级和 SKU

104,900 周安装

Docker配置生成器 - 为前端/后端项目自动创建生产就绪的Dockerfile和docker-compose

🇨🇳中文介绍

ln-731-docker-generator

目的与范围

输入

相关 Skills

输出

工作流程

阶段 1：输入验证

阶段 2：模板选择

阶段 3：变量替换

阶段 4：文件生成

支持的技术栈

前端：React/Vite + Nginx

后端：.NET 8/9

后端：Python (FastAPI/Django)

安全与性能最佳实践

质量标准

重要说明

参考文件

完成定义

🇺🇸English

ln-731-docker-generator

Purpose & Scope

Inputs

Outputs

Workflow

Phase 1: Input Validation

Phase 2: Template Selection

Phase 3: Variable Substitution

Phase 4: File Generation

Supported Stacks

Frontend: React/Vite + Nginx

Backend: .NET 8/9

Backend: Python (FastAPI/Django)

Security & Performance Best Practices

Quality Criteria

Critical Notes

Reference Files

Definition of Done

最新 Skills