defradigital/dotnetcore-development

defra-docker-dotnetcore 镜像文档

镜像概述和主要用途

defra-docker-dotnetcore 是一个专为.NET Core开发设计的父镜像，旨在为.NET Core应用提供统一的开发基础环境。该镜像通过预配置必要的开发依赖和工具，简化开发环境搭建流程，确保团队内部开发环境的一致性，减少因环境差异导致的开发问题。

核心功能和特性

• 预安装.NET Core SDK：包含指定版本的.NET Core SDK，支持应用代码的编译、测试和调试
• 标准化基础环境：基于稳定的Linux发行版（如Ubuntu）构建，提供统一的系统级依赖
• 开发工具集成：包含常用开发工具和依赖库，减少项目Dockerfile中的重复配置
• 多阶段构建支持：可作为多阶段构建流程中的基础构建镜像，与运行时镜像配合使用
• 版本化管理：通过标签管理不同.NET Core版本，满足不同项目的框架版本需求

使用场景和适用范围

• 基于.NET Core框架的应用程序开发过程
• 需要统一开发环境的团队协作项目
• 作为其他.NET Core应用镜像的基础父镜像，简化自定义镜像构建
• CI/CD流程中用于构建和测试阶段的环境标准化

使用方法和配置说明

基本使用方式

在项目Dockerfile中引用该镜像作为基础镜像：

dockerfile
# 引用defra-docker-dotnetcore父镜像（指定版本标签）
FROM defra/dotnetcore:3.1 AS build

# 设置工作目录
WORKDIR /app

# 复制项目文件并还原依赖
COPY *.csproj ./
RUN dotnet restore

# 复制源代码并构建
COPY . ./
RUN dotnet build -c Release -o out

构建应用镜像

使用以下命令构建基于该父镜像的应用镜像：

bash
docker build -t my-dotnet-app:latest .

作为父镜像扩展

在自定义镜像中扩展该父镜像以添加项目特定依赖：

dockerfile
# 继承父镜像
FROM defra/dotnetcore:5.0

# 添加项目特定依赖
RUN apt-get update && apt-get install -y \
    some-additional-package \
    && rm -rf /var/lib/apt/lists/*

# 设置环境变量
ENV APP_ENV=development

配置参数与环境变量

构建参数

• DOTNET_SDK_VERSION：指定.NET Core SDK版本（如3.1.401、5.0.100等）
• BASE_IMAGE_TAG：指定基础系统镜像标签（如ubuntu-20.04）

环境变量

• ASPNETCORE_ENVIRONMENT：设置.NET Core运行环境（默认为Development）
• DOTNET_CLI_TELEMETRY_OPTOUT：禁用.NET CLI遥测（默认为1，即禁用）

注意事项

• 该镜像主要面向开发环境，生产环境建议通过多阶段构建结合官方.NET Core运行时镜像（如mcr.microsoft.com/dotnet/aspnet）使用，以减小最终镜像体积
• 使用特定版本标签（如:3.1）而非:latest以确保构建稳定性
• 定期更新父镜像版本以获取最新的安全补丁和.NET Core SDK更新

参考信息

完整文档和最新版本信息请参考官方仓库：
https://github.com/DEFRA/defra-docker-dotnetcore