Setting up IronWord in Docker Containers

Warum Docker verwenden?

Docker ermöglicht es Ihnen, IronWord als leichtgewichtigen, eigenständigen Container zu paketieren und auszuführen. Dies gewährleistet konsistentes Verhalten über Entwicklung, Test und Produktion hinweg—besonders wertvoll beim programmgesteuerten Erstellen oder Bearbeiten von Word-Dokumenten.

IronWord unterstützt .NET 5-9, .NET Standard (2.x, 3.x) und .NET Framework 4.6.2+, die alle nahtlos in Docker auf Linux und Windows funktionieren.

Empfohlene Linux-Docker-Distributionen

Wir empfehlen die folgenden 64-bit Linux-Distros für einen reibungslosen Betrieb von IronWord:

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

Verwenden Sie Microsofts offizielle Docker-Images mit der .NET-Runtime und dem SDK, um die Einrichtung und das Abhängigkeitsmanagement zu vereinfachen.

IronWord NuGet-Paket

IronWord lässt sich leicht in jedes .NET-Projekt über sein NuGet-Paket integrieren. Führen Sie einfach den folgenden Befehl in der NuGet-Paket-Manager-Konsole aus, und die Bibliothek wird automatisch hinzugefügt:

Install-Package IronWord

Ubuntu Dockerfile-Beispiele

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-Beispiel

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

Verwenden Sie CentOS-basierte .NET-Runtimes wie mcr.microsoft.com/dotnet/runtime:6.0-centos7 für die Kompatibilität mit IronWord.

# Build stage
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

# Runtime stage - 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"]

Anmerkungen und Fehlersuche

• IronWord unterstützt vollständig .NET5–9, .NET Standard (2.x, 3.x) und .NET Framework 4.6.2+.
• Installieren Sie bei Bedarf Schriftarten (z.B. fonts-liberation, ttf-mscorefonts-installer) in Linux-Containern für die richtige Darstellung.