在 Docker 容器中设置 IronWord

为什么要使用 Docker？

Docker 允许您将 IronWord 打包并运行为一个轻量级的、自包含的容器。 这确保了开发、测试和生产过程中行为的一致性——这在以编程方式生成或操作 Word 文档时尤其有价值。

IronWord 支持 .NET 5-9、.NET Standard (2.x, 3.x) 和 .NET Framework 4.6.2+，所有这些都可以在 Linux 和 Windows 上的 Docker 中无缝运行。

推荐的 Linux Docker 发行版

为了确保 IronWord 流畅运行，我们推荐以下 64 位 Linux 发行版：

• Ubuntu 22.04+ (Jammy)
• Ubuntu 20.04 (Focal)
• Debian 11+ (Bullseye) CentOS 7+

使用 Microsoft官方的 Docker 镜像以及 .NET 运行时和 SDK，可以简化安装和依赖项管理。

IronWord NuGet 包

IronWord 可以通过其 NuGet 包轻松添加到任何 .NET 项目中。 只需在 NuGet 包管理器控制台中运行以下命令，它就会自动添加库：

Install-Package IronWord

Ubuntu Dockerfile 示例

来自 mcr.microsoft.com/dotnet/runtime:8.0-jammy AS base
工作目录 /app

来自 mcr.microsoft.com/dotnet/sdk:8.0-jammy AS 构建
工作目录 /src
复制 ["Example/Example.csproj", "Example/"]
运行 dotnet restore "Example/Example.csproj"

复制 。 .
工作目录"/src/Example"
运行 dotnet build "Example.csproj" -c Release -o /app/build

从构建 AS 发布
运行 dotnet publish "Example.csproj" -c Release -o /app/publish

从基地 AS 最终
工作目录 /app
COPY --from=publish /app/publish .
入口点 ["dotnet", "Example.dll"]

来自 mcr.microsoft.com/dotnet/runtime:6.0-focal AS base
工作目录 /app

来自 mcr.microsoft.com/dotnet/sdk:6.0-focal AS 构建
工作目录 /src
复制 ["Example/Example.csproj", "Example/"]
运行 dotnet restore "Example/Example.csproj"

复制 。 .
工作目录"/src/Example"
运行 dotnet build "Example.csproj" -c Release -o /app/build

从构建 AS 发布
运行 dotnet publish "Example.csproj" -c Release -o /app/publish

从基地 AS 最终
工作目录 /app
COPY --from=publish /app/publish .
入口点 ["dotnet", "Example.dll"]

Debian Dockerfile 示例

来自 mcr.microsoft.com/dotnet/aspnet:7.0-bullseye-slim AS base
工作目录 /app

来自 mcr.microsoft.com/dotnet/sdk:7.0-bullseye-slim AS 构建
工作目录 /src
复制 ["Example/Example.csproj", "Example/"]
运行 dotnet restore "Example/Example.csproj"

复制 。 .
工作目录"/src/Example"
运行 dotnet build "Example.csproj" -c Release -o /app/build

从构建 AS 发布
运行 dotnet publish "Example.csproj" -c Release -o /app/publish

从基地 AS 最终
工作目录 /app
COPY --from=publish /app/publish .
入口点 ["dotnet", "Example.dll"]

CentOS 7

为了与 IronWord 兼容，请使用基于 CentOS 的 .NET 运行时，例如 mcr.microsoft.com/dotnet/runtime:6.0-centos7。

# 构建阶段
来自 mcr.microsoft.com/dotnet/sdk:6.0 AS 版本
工作目录 /app

复制 ./Example/Example.csproj ./Example/
运行 dotnet restore "./Example/Example.csproj"

复制 ./示例 ./示例/
工作目录 /app/示例
运行 dotnet publish -c Release -o /out

# 运行时阶段 - CentOS 7
FROM mcr.microsoft.com/dotnet/runtime:6.0-centos7 AS runtime
工作目录 /app

运行 yum install -y liberation-fonts && yum clean all

COPY --from=build /out ./

入口点 ["dotnet", "Example.dll"]

注意事项和故障排除

• IronWord 完全支持 .NET5–9、.NET Standard (2.x, 3.x) 和 .NET Framework 4.6.2+。
• 如果需要，请在 Linux 容器上安装字体（例如 fonts-liberation、ttf-mscorefonts-installer），以便正确渲染。