Konfigurowanie IronWord w kontenerach Docker

Dłączego używać Docker?

Docker umożliwia zapakowanie i uruchomienie IronWord jako lekkiego, samodzielnego kontenera. Zapewnia to spójne zachowanie w trakcie pracy z Word dokumentami 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łaja w Docker na Linux i Windows.

Zalecane dystrybucje Linux dla Docker

Zalecamy następujące 64‑bitowe dystrybucje Linux dla plynnej pracy IronWord:

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

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

Pakiet NuGet IronWord

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

Install-Package IronWord

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

Przyklad 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

Uzyj runtime'ow .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 problemow

• IronWord w pelni 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 prawidlowej wizualizacji.