Docker Konteynerlerinde IronWord Kurulumu

Docker Neden Kullanılmalı?

Docker, IronWord'u hafif, kendinden bağımsız bir konteyner olarak paketleyip çalıştırmanıza olanak tanır. Bu, geliştirme, test ve üretim arasında tutarlı bir davranış sağlar - özellikle programlı olarak Word belgeleri oluşturup işleri yaparken değerli.

IronWord, .NET 5-9, .NET Standard (2.x, 3.x) ve .NET Framework 4.6.2+ destekler, bunların hepsi Linux ve Windows üzerinde Docker'da sorunsuz çalışır.

Tavsiye Edilen Linux Docker Dağıtımları

IronWord'un düzgün çalışması için aşağıdaki 64-bit Linux dağıtımlarını öneriyoruz:

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

.NET çalışma zamanı ve SDK ile birlikte Microsoft'un resmi Docker görüntülerini kullanarak kurulum ve bağımlılık yönetimini basitleştirin.

IronWord NuGet Paketi

IronWord, herhangi bir .NET projesine NuGet paketi üzerinden kolayca eklenebilir. NuGet Paket Yöneticisi Konsolu'nda aşağıdaki komutu çalıştırmanız yeterlidir ve kütüphane otomatik olarak eklenecektir:

Install-Package IronWord

Ubuntu Dockerfile Örnekleri

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

Debian Dockerfile Örneği

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

IronWord uyumluluğu için mcr.microsoft.com/dotnet/runtime:6.0-centos7 gibi CentOS tabanlı .NET çalıştırma ortamlarını kullanın.

# Yapı aşaması
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

# Çalışma zamanı aşaması - 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"]

Notlar ve Sorun Giderme

• IronWord, .NET5–9, .NET Standard (2.x, 3.x) ve .NET Framework 4.6.2+ tam olarak destekler.
• Eğer gerekli ise fontları yükleyin (örn. fonts-liberation, ttf-mscorefonts-installer) Linux konteynerlerinde düzgün render için.