Configuración de IronWord en contenedores Docker

¿Por qué utilizar Docker?

Docker te permite empaquetar y ejecutar IronWord como un contenedor ligero y autónomo. Esto garantiza un comportamiento coherente durante el desarrollo, pruebas y producción, especialmente valioso al generar o manipular documentos de Word programáticamente.

IronWord soporta .NET 5-9, .NET Standard (2.x, 3.x) y .NET Framework 4.6.2+, todos los cuales funcionan sin problemas en Docker en Linux y Windows.

Distribuciones recomendadas de Docker para Linux

Recomendamos las siguientes distribuciones de Linux de 64 bits para un funcionamiento fluido de IronWord:

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

Use las imágenes oficiales de Docker de Microsoft con el runtime y SDK de .NET para simplificar la configuración y gestión de dependencias

Paquete NuGet de IronWord

IronWord se añade fácilmente a cualquier proyecto .NET a través de su paquete NuGet. Simplemente ejecute el siguiente comando en la Consola del Administrador de Paquetes NuGet, y añadirá la librería automáticamente:

Install-Package IronWord

Ejemplos de Dockerfiles de 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"]

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

Utilice los runtimes de .NET basados en CentOS como mcr.microsoft.com/dotnet/runtime:6.0-centos7 para la compatibilidad con IronWord.

# Etapa de construcción
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

# Etapa de ejecución - 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"]

Notas y solución de problemas

• IronWord soporta totalmente .NET5–9, .NET Standard (2.x, 3.x) y .NET Framework 4.6.2+.
• Instale fuentes si es necesario (por ejemplo, fonts-liberation, ttf-mscorefonts-installer) en contenedores Linux para un renderizado adecuado.