clementfifty/fifty

aspnetcore2.1Spa/aspnetcore2.2Spa 镜像文档

镜像概述

aspnetcore2.1Spa和aspnetcore2.2Spa是两个Docker镜像，分别基于.NET Core SDK 2.1和2.2版本构建，并预装了Node.js环境。这些镜像主要用于简化单页应用(SPA)的构建流程，特别适合需要同时处理.NET Core后端代码和前端SPA资源（如React、Vue、Angular等）的开发场景。

核心功能与特性

主要组件

• 基础环境：分别基于.NET Core SDK 2.1和2.2官方镜像
• 附加组件：预装Node.js，支持前端依赖管理和构建工具（如npm、yarn、webpack等）

核心优势

• 整合.NET Core后端开发与前端SPA构建环境，减少多环境配置复杂度
• 适用于需要在同一容器内完成"后端编译-前端构建-资源整合"全流程的场景
• 由Fifty团队维护，针对SPA应用构建场景优化

使用场景

• 开发阶段：本地开发环境统一配置，确保团队成员开发环境一致性
• 构建阶段：CI/CD流水线中用于执行SPA应用的完整构建流程（后端编译、前端依赖安装、前端打包、资源合并等）
• 测试环境：快速部署包含前后端构建结果的测试环境

使用方法

基础使用（以aspnetcore2.2Spa为例）

直接运行容器

bash
docker run -it --rm fifty/aspnetcore2.2spa

挂载项目目录并执行构建

假设项目目录包含.NET Core后端代码和前端SPA源代码：

bash
docker run -it --rm -v $(pwd):/app -w /app fifty/aspnetcore2.2spa \
  sh -c "dotnet restore && npm install && npm run build && dotnet publish -c Release"

docker-compose配置示例

yaml
version: '3'
services:
  spa-builder:
    image: fifty/aspnetcore2.2spa
    volumes:
      - ./:/app
    working_dir: /app
    command: sh -c "dotnet restore && npm install && npm run build && dotnet publish -o /app/publish"

镜像选择建议

• 若项目基于.NET Core 2.1开发，选择aspnetcore2.1spa
• 若项目基于.NET Core 2.2开发，选择aspnetcore2.2spa

注意事项

• 镜像仅包含构建环境，不建议直接用于生产环境部署
• 生产环境部署建议使用对应版本的ASP.NET Core运行时镜像（如mcr.microsoft.com/dotnet/core/aspnet:2.1）
• Node.js版本继承自基础镜像配置，如需特定版本需自行调整或联系维护团队