plumguide/plum-build Docker 镜像 - 轩辕镜像

.NET Core 2.2开发与部署集成镜像

镜像概述

本镜像基于官方dotnet/core/sdk:2.2构建，扩展集成了build-essential基础编译工具、npmJavaScript包管理器和pulumi云基础设施即代码工具，旨在提供一站式.NET Core 2.2应用开发、构建、打包及云部署环境。

核心功能与特性

基础开发环境

• dotnet/core/sdk:2.2：提供完整的.NET Core 2.2 SDK，包含C#编译器、.NET运行时、dotnet CLI工具链，支持.NET Core 2.2应用的开发、编译、测试和发布。

系统编译工具

• build-essential：包含GCC、G++、make等基础编译工具，支持C/C++代码编译，满足依赖原生库的.NET Core项目构建需求。

前端依赖管理

• npm：Node.js包管理器，支持JavaScript/TypeScript项目依赖管理、前端资源打包（如Webpack、Babel），适用于前后端一体化的.NET Core应用开发。

云资源部署能力

• Pulumi：多语言云基础设施即代码（IaC）工具，支持使用C#等.NET语言定义和部署AWS、Azure、GCP等云资源，实现应用与基础设施的协同部署。

使用场景

• .NET Core 2.2遗留项目的维护与开发
• 包含原生代码依赖的.NET Core应用构建
• 前后端一体化（.NET后端+JavaScript前端）项目开发
• 基于Pulumi的云基础设施与.NET应用一体化部署
• CI/CD流水线中的构建环境标准化

使用方法与配置

基础使用（交互式开发）

bash
docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  [镜像标签] \
  /bin/bash

• -v $(pwd):/app：将当前目录挂载到容器内/app工作目录
• -w /app：设置容器工作目录为/app
• 进入容器后可直接使用dotnet、npm、pulumi等命令

.NET Core应用构建示例

bash
# 编译.NET Core项目
docker run --rm \
  -v $(pwd):/app \
  -w /app \
  [镜像标签] \
  dotnet build -c Release

# 发布.NET Core应用
docker run --rm \
  -v $(pwd):/app \
  -w /app \
  [镜像标签] \
  dotnet publish -c Release -o ./publish

前端+后端一体化构建示例

bash
docker run --rm \
  -v $(pwd):/app \
  -w /app \
  [镜像标签] \
  /bin/sh -c "npm install && npm run build && dotnet build"

云资源部署示例（Pulumi）

bash
# 初始化Pulumi项目（首次使用）
docker run -it --rm \
  -v $(pwd):/app \
  -v ~/.pulumi:/root/.pulumi \  # 挂载Pulumi配置目录
  -w /app \
  [镜像标签] \
  pulumi new aws-csharp

# 部署云资源
docker run --rm \
  -v $(pwd):/app \
  -v ~/.pulumi:/root/.pulumi \
  -e PULUMI_ACCESS_TOKEN=[你的访问令牌] \  # 设置Pulumi访问令牌
  -w /app \
  [镜像标签] \
  pulumi up

环境配置说明

• .NET Core环境：支持官方dotnet/core/sdk:2.2所有环境变量，如DOTNET_CLI_TELEMETRY_OPTOUT=1可禁用遥测
• npm配置：可通过挂载.npmrc文件（-v $(pwd)/.npmrc:/root/.npmrc）自定义npm源和代理
• Pulumi配置：通过挂载~/.pulumi目录持久化配置，或设置PULUMI_ACCESS_TOKEN、AWS_ACCESS_KEY_ID等云厂商认证环境变量

注意事项

• 本镜像基于.NET Core 2.2（已停止官方支持），建议仅用于维护遗留系统
• 生产环境部署需根据应用需求裁剪镜像，移除开发依赖
• 敏感信息（如Pulumi令牌、云厂商密钥）建议通过环境变量注入而非镜像内置