Configurer IronWord dans des conteneurs Docker

Pourquoi utiliser Docker ?

Docker vous permet d'emballer et d'exécuter IronWord en tant que conteneur léger et autonome. Cela garantit un comportement cohérent à travers le développement, le test et la production - particulièrement valuable lors de la génération ou manipulation de documents Word programmaticalement.

IronWord prend en charge .NET 5-9, .NET Standard (2.x, 3.x) et .NET Framework 4.6.2+, qui fonctionnent tous parfaitement dans Docker sur Linux et Windows.

Distributions Docker Linux Recommandées

Nous recommandons les distributions Linux 64 bits suivantes pour un fonctionnement fluide d'IronWord :

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

Utilisez les images Docker officielles de Microsoft avec le runtime et SDK .NET pour simplifier la configuration et la gestion des dépendances.

Package NuGet IronWord

IronWord est facilement ajouté à tout projet .NET via son package NuGet. Il suffit d'exécuter la commande suivante dans la console du gestionnaire de packages NuGet, et il ajoutera automatiquement la bibliothèque :

Install-Package IronWord

Exemples de Dockerfile 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"]

Exemple de Dockerfile 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

Utilisez des runtimes .NET basée sur CentOS comme mcr.microsoft.com/dotnet/runtime:6.0-centos7 pour la compatibilité IronWord.

# Étape de construction
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

# Étape 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"]

Notes & Dépannage

• IronWord prend en charge entièrement .NET5–9, .NET Standard (2.x, 3.x), et .NET Framework 4.6.2+.
• Installez des polices si nécessaire (par ex., fonts-liberation, ttf-mscorefonts-installer) sur des conteneurs Linux pour un rendu correct.