在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套件

可以通過其NuGet套件輕鬆新增IronWord到任何.NET專案中。 只需在NuGet套件管理器控制台中運行以下命令，就會自動新增程式庫：

Install-Package IronWord

Ubuntu Dockerfile範例

FROM mcr.microsoft.com/dotnet/runtime:8.0-jammy AS base
WORKDIR /app

FROM mcr.microsoft.com/dotnet/sdk:8.0-jammy AS build
WORKDIR /src
COPY ["Example/Example.csproj", "Example/"]
RUN 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"]

FROM mcr.microsoft.com/dotnet/runtime:6.0-focal AS base
WORKDIR /app

FROM mcr.microsoft.com/dotnet/sdk:6.0-focal AS build
WORKDIR /src
COPY ["Example/Example.csproj", "Example/"]
RUN 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範例

FROM mcr.microsoft.com/dotnet/aspnet:7.0-bullseye-slim AS base
WORKDIR /app

FROM mcr.microsoft.com/dotnet/sdk:7.0-bullseye-slim AS build
WORKDIR /src
COPY ["Example/Example.csproj", "Example/"]
RUN 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

使用基於CentOS的.NET運行時，例如mcr.microsoft.com/dotnet/runtime:6.0-centos7，以確保IronWord的相容性。

# 建構階段
FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /app

COPY ./Example/Example.csproj ./Example/
RUN dotnet restore "./Example/Example.csproj"

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

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

RUN yum install -y liberation-fonts && yum clean all

COPY --from=build /out ./

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

注意事項 & 疑難排解

• IronWord完全支援.NET5–9、.NET Standard (2.x, 3.x) 和.NET Framework 4.6.2+。
• 如有需要，在Linux容器上安裝字體（例如fonts-liberation, ttf-mscorefonts-installer），以確保正確的渲染。