Konfigurowanie IronWord w kontenerach Docker

Dlaczego używać Docker?

Docker umożliwia zapakowanie i uruchomienie IronWord jako lekkiego, samodzielnego kontenera. Zapewnia to spójne zachowanie w trakcie pracy z dokumentami Word zarówno na etapie programowania, jak i w środowisku produkcyjnym oraz testowym.

IronWord obsługuje .NET 5-9, .NET Standard (2.x, 3.x) i .NET Framework 4.6.2+, które harmonijnie działają w Docker na Linux i Windows.

Zalecane dystrybucje Linux dla Docker

Zalecamy następujące 64‑bitowe dystrybucje Linux dla płynnej pracy IronWord:

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

Użyj oficjalnych obrazów Docker Microsoftu z runtimem i SDK .NET, aby uprościć konfigurację i zarządzanie zależnościami.

Pakiet NuGet IronWord

IronWord łatwo dodać do dowolnego projektu .NET za pomocą pakietu NuGet. Po prostu uruchom następujące polecenie w konsoli NuGet Package Manager, a automatycznie doda bibliotekę:

Install-Package IronWord

Przykłady Dockerfile dla Ubuntu

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"]

Przykład Dockerfile dla Debian

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

Użyj runtime'ów .NET opartych na CentOS jak mcr.microsoft.com/dotnet/runtime:6.0-centos7 dla zgodności z IronWord.

# Etap budowy
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

# Etap runtime - 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"]

Notatki i rozwiązywanie problemów

• IronWord w pełni wspiera .NET5–9, .NET Standard (2.x, 3.x) oraz .NET Framework 4.6.2+.
• Zainstaluj czcionki, jeśli to konieczne (np. fonts-liberation, ttf-mscorefonts-installer) w kontenerach Linux dla prawidłowej wizualizacji.