在 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 發行版

我們建議使用以下 64 位元 Linux 發行版，以確保 IronWord 運作順暢：

• 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 作為基礎
WORKDIR /app

來源：mcr.microsoft.com/dotnet/sdk:8.0-jammy AS build
WORKDIR /src
COPY ["Example/Example.csproj", "Example/"]
執行 dotnet restore "Example/Example.csproj"

COPY . .
WORKDIR "/src/Example"
RUN dotnet build "Example.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "Example.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "Example.dll"]

來源：mcr.microsoft.com/dotnet/runtime:6.0-focal 作為基礎
WORKDIR /app

來源：mcr.microsoft.com/dotnet/sdk:6.0-focal AS build
WORKDIR /src
COPY ["Example/Example.csproj", "Example/"]
執行 dotnet restore "Example/Example.csproj"

COPY . .
WORKDIR "/src/Example"
RUN dotnet build "Example.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "Example.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "Example.dll"]

Debian Dockerfile 範例

來源：mcr.microsoft.com/dotnet/aspnet:7.0-bullseye-slim 作為基礎
WORKDIR /app

來源：mcr.microsoft.com/dotnet/sdk:7.0-bullseye-slim AS build
WORKDIR /src
COPY ["Example/Example.csproj", "Example/"]
執行 dotnet restore "Example/Example.csproj"

COPY . .
WORKDIR "/src/Example"
RUN dotnet build "Example.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "Example.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "Example.dll"]

CentOS 7

為確保與 IronWord 的相容性，請使用基於 CentOS 的 .NET 執行環境，例如 mcr.microsoft.com/dotnet/runtime:6.0-centos7。

# 建置階段
來源：mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /app

COPY ./Example/Example.csproj ./Example/
執行 dotnet restore "./Example/Example.csproj"

COPY ./Example ./Example/
WORKDIR /app/Example
執行 dotnet publish -c Release -o /out

# 執行階段 - CentOS 7
FROM mcr.microsoft.com/dotnet/runtime:6.0-centos7 AS runtime
WORKDIR /app

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

COPY --from=build /out ./

ENTRYPOINT ["dotnet", "Example.dll"]

注意事項與疑難排解

• IronWord 完全支援 .NET 5–9、.NET Standard (2.x、3.x) 以及 .NET Framework 4.6.2 以上版本。
• 如有需要，請在 Linux 容器中安裝字型（例如 fonts-liberation、ttf-mscorefonts-installer），以確保正確顯示。