levnikolaevich/aspnet3.1

文档生成基础镜像

镜像概述

本镜像基于 mcr.microsoft.com/dotnet/core/aspnet:3.1-buster-slim 构建，专为需要生成PDF文档的.NET Core应用设计。通过集成必要的系统库、字体文件和PDF生成工具（wkhtmltopdf），解决了基础镜像中缺少文档生成相关依赖的问题，支持在容器环境中直接进行PDF文档生成。

核心功能与特性

核心功能

• 提供PDF文档生成能力，基于wkhtmltopdf工具实现HTML到PDF的转换
• 支持中文字体及多种系统字体渲染
• 配置莫斯科时区（Europe/Moscow），确保时间相关文档的准确性

关键特性

• 依赖库集成：包含libgdiplus、libx11-dev、libfontconfig1等图形渲染和字体支持库
• 字体支持：安装ttf-mscorefonts-installer及自定义字体，确保文档中文字正常显示
• 工具集成：内置wkhtmltopdf工具，版本来自https://github.com/levnikolaevich/rosgrant.wkhtmltopdf.git
• 轻量级基础：基于slim版本的.NET Core镜像，减少镜像体积

使用场景

• 需要在.NET Core应用中动态生成PDF报表、合同、凭证等文档的场景
• 要求容器化部署且依赖特定字体和PDF生成工具的服务
• 需要统一时区配置的文档生成服务

使用方法

构建前准备（v2版本要求）

在Dockerfile所在目录执行以下命令克隆字体和工具仓库：

bash
git clone https://github.com/levnikolaevich/rosgrant.wkhtmltopdf.git wkhtmltopdf_fonts/

构建镜像

创建Dockerfile（基于v2版本）：

dockerfile
FROM ***-mcr.xuanyuan.run/dotnet/core/aspnet:3.1-buster-slim AS base

WORKDIR /app

RUN apt-get update && apt-get install -y libjpeg62-turbo libpng16-16 libfontconfig1 libxrender-dev libxtst6

RUN apt-get install -y --allow-unauthenticated libc6-dev libgdiplus libx11-dev tzdata && rm -rf /var/lib/apt/lists/*

ENV TZ="Europe/Moscow"

RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

COPY wkhtmltopdf_fonts/WkHtmlToPdf/Linux htmltopdf/

RUN chmod 755 htmltopdf/wkhtmltopdf -v

COPY wkhtmltopdf_fonts/fonts/*.ttf /usr/share/fonts/

EXPOSE 80

构建命令：

bash
docker build -t document-generator-base:v2 .

运行容器示例

bash
docker run -d -p 8080:80 --name doc-gen-service docker.xuanyuan.run/document-generator-base:v2

docker-compose配置示例

yaml
version: '3'
services:
  doc-generator:
    image: docker.xuanyuan.run/document-generator-base:v2
    ports:
      - "8080:80"
    environment:
      - TZ=Europe/Moscow  # 可根据需求修改时区
    volumes:
      - ./fonts:/usr/share/fonts  # 如需添加自定义字体，可挂载字体目录

基础镜像测试与更新流程

1. 构建新版本镜像并标记为new：docker build -t document-generator-base:new .
2. 将一个非关键服务切换到new标签镜像进行测试
3. 验证服务功能及文档生成是否正常
4. 测试通过后，将new标签重命名为base：docker tag document-generator-base:new document-generator-base:base
5. 将测试服务切换回base标签镜像
6. 删除测试标签：docker rmi document-generator-base:new

版本说明

• v1：通过镜像内部git clone获取wkhtmltopdf工具，包含字体安装步骤
• v2（2020-09-16更新）：优化构建流程，要求构建前本地克隆工具仓库，通过COPY指令添加工具和字体，减少镜像层和构建时间

环境变量

暴露端口

• 80：默认HTTP端口，用于.NET Core应用对外提供服务