在 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+

使用微軟官方的 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），以便正確渲染。