Configurando o IronWord em contêineres Docker

Por que usar o Docker?

O Docker permite empacotar e executar o IronWord como um contêiner leve e independente. Isso garante um comportamento consistente durante o desenvolvimento, os testes e a produção — algo especialmente valioso ao gerar ou manipular documentos do Word programaticamente.

O IronWord é compatível com .NET 5-9, .NET Standard (2.x, 3.x) e .NET Framework 4.6.2+, todos funcionando perfeitamente no Docker em Linux e Windows.

Distribuições Linux recomendadas para Docker

Recomendamos as seguintes distribuições Linux de 64 bits para um funcionamento perfeito do IronWord :

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

Use as imagens oficiais do Docker da Microsoft com o runtime e o SDK do .NET para simplificar a configuração e o gerenciamento de dependências.

Pacote NuGet IronWord

O IronWord pode ser facilmente adicionado a qualquer projeto .NET através do seu pacote NuGet . Basta executar o seguinte comando no Console do Gerenciador de Pacotes NuGet , e a biblioteca será adicionada automaticamente:

Install-Package IronWord

Exemplos de Dockerfile para Ubuntu

DE mcr.microsoft.com/dotnet/runtime:8.0-jammy COMO base
DIRETÓRIO DE TRABALHO /aplicativo

DE mcr.microsoft.com/dotnet/sdk:8.0-jammy COMO build
WORKDIR /src
COPIAR ["Exemplo/Exemplo.csproj", "Exemplo/"]
RUN dotnet restore "Example/Example.csproj"

CÓPIA. .
DIRETÓRIO DE TRABALHO "/src/Exemplo"
Execute o comando `dotnet build "Example.csproj" -c Release -o /app/build`.

A partir de build AS publish
RUN dotnet publish "Example.csproj" -c Release -o /app/publish

A PARTIR DA BASE COMO FINAL
DIRETÓRIO DE TRABALHO /aplicativo
COPIAR --de=publicar /app/publicar .
ENTRYPOINT ["dotnet", "Example.dll"]

DE mcr.microsoft.com/dotnet/runtime:6.0-focal COMO base
DIRETÓRIO DE TRABALHO /aplicativo

DE mcr.microsoft.com/dotnet/sdk:6.0-focal COMO build
WORKDIR /src
COPIAR ["Exemplo/Exemplo.csproj", "Exemplo/"]
RUN dotnet restore "Example/Example.csproj"

CÓPIA. .
DIRETÓRIO DE TRABALHO "/src/Exemplo"
Execute o comando `dotnet build "Example.csproj" -c Release -o /app/build`.

A partir de build AS publish
RUN dotnet publish "Example.csproj" -c Release -o /app/publish

A PARTIR DA BASE COMO FINAL
DIRETÓRIO DE TRABALHO /aplicativo
COPIAR --de=publicar /app/publicar .
ENTRYPOINT ["dotnet", "Example.dll"]

Exemplo de Dockerfile para Debian

FROM mcr.microsoft.com/dotnet/aspnet:7.0-bullseye-slim AS base
DIRETÓRIO DE TRABALHO /aplicativo

DE mcr.microsoft.com/dotnet/sdk:7.0-bullseye-slim COMO build
WORKDIR /src
COPIAR ["Exemplo/Exemplo.csproj", "Exemplo/"]
RUN dotnet restore "Example/Example.csproj"

CÓPIA. .
DIRETÓRIO DE TRABALHO "/src/Exemplo"
Execute o comando `dotnet build "Example.csproj" -c Release -o /app/build`.

A partir de build AS publish
RUN dotnet publish "Example.csproj" -c Release -o /app/publish

A PARTIR DA BASE COMO FINAL
DIRETÓRIO DE TRABALHO /aplicativo
COPIAR --de=publicar /app/publicar .
ENTRYPOINT ["dotnet", "Example.dll"]

CentOS 7

Use ambientes de execução .NET baseados em CentOS, como mcr.microsoft.com/dotnet/runtime:6.0-centos7, para compatibilidade com o IronWord .

# Fase de construção
DE mcr.microsoft.com/dotnet/sdk:6.0 COMO build
DIRETÓRIO DE TRABALHO /aplicativo

COPIAR ./Example/Example.csproj ./Example/
EXECUTE dotnet restore "./Example/Example.csproj"

COPIAR ./Exemplo ./Exemplo/
DIRETÓRIO DE TRABALHO /aplicativo/Example
RUN dotnet publish -c Release -o /out

# Estágio de execução - CentOS 7
DE mcr.microsoft.com/dotnet/runtime:6.0-centos7 COMO runtime
DIRETÓRIO DE TRABALHO /aplicativo

EXECUTE yum install -y liberation-fonts && yum clean all

COPIAR --de=construir /saída ./

ENTRYPOINT ["dotnet", "Example.dll"]

Notas e resolução de problemas

• O IronWord oferece suporte completo ao .NET 5–9, .NET Standard (2.x, 3.x) e .NET Framework 4.6.2+.
• Instale as fontes, se necessário (por exemplo, fonts-liberation, ttf-mscorefonts-installer), nos contêineres Linux para uma renderização adequada.