beamableinc/beamservice

C#微服务基础镜像文档

1. 镜像概述

本镜像为基于C#开发的微服务提供标准化基础运行环境，集成必要的运行时依赖与配置模板，旨在简化C#微服务的构建流程，确保不同微服务实例间基础环境的一致性，降低跨环境部署差异带来的问题。

2. 核心功能与特性

• 预配置运行时环境：内置.NET Core/.NET Runtime，无需手动安装基础运行时组件
• 微服务优化：针对微服务架构特点优化启动流程，减少初始化耗时
• 依赖标准化：统一基础依赖版本，避免因底层依赖差异导致的兼容性问题
• 轻量级设计：基于官方.NET镜像精简，减少镜像体积，提升部署效率
• 多环境适配：支持开发、测试及生产环境的基础配置切换

3. 使用场景与适用范围

• 开发环境：作为本地开发C#微服务的基础镜像，确保开发环境与目标运行环境一致
• 测试环境：为自动化测试提供标准化基础环境，保证测试结果的可靠性
• 生产环境：作为生产级C#微服务的基础镜像，支撑微服务集群的稳定运行
• 适用架构：适用于所有基于C#语言开发的微服务，尤其适合采用Docker容器化部署的微服务架构体系

4. 使用方法与配置说明

4.1 基础使用方式

本镜像需作为基础镜像（FROM指令）在微服务的Dockerfile中引用，用于构建微服务应用镜像。

4.1.1 示例Dockerfile

dockerfile
# 引用C#微服务基础镜像
FROM [镜像名称]:[版本标签]

# 复制微服务应用程序文件
COPY ./publish /app

# 设置工作目录
WORKDIR /app

# 暴露微服务端口（根据实际需求调整）
EXPOSE 8080

# 启动命令（基础镜像已预配置默认启动逻辑，可根据需要覆盖）
CMD ["dotnet", "YourService.dll"]

4.2 构建与运行示例

4.2.1 构建微服务镜像

bash
docker build -t your-csharp-microservice:1.0 .

4.2.2 运行微服务容器

bash
docker run -d -p 8080:8080 --name csharp-service-instance your-csharp-microservice:1.0

4.3 环境变量配置

基础镜像支持通过环境变量调整基础行为，常用配置如下：

4.3.1 带环境变量运行示例

bash
docker run -d -p 8080:8080 \
  -e ASPNETCORE_ENVIRONMENT=Development \
  -e LOG_LEVEL=Debug \
  --name dev-csharp-service your-csharp-microservice:1.0

5. 版本兼容性

• 支持.NET Core 3.1+及.NET 5+运行时环境
• 兼容Docker 19.03+及Kubernetes 1.18+容器编排平台