Setting up IronWord in Docker Containers

なぜDockerを使用するのか？

Dockerを使用すると、IronWordを軽量で自己完結型のコンテナとしてパッケージ化して実行できます。 これは、開発、テスト、本番環境での一貫した動作を保証し、特にWord文書のプログラムによる生成や操作時に貴重です。

IronWordは、.NET 5〜9、.NET Standard (2.x, 3.x)、および.NET Framework 4.6.2+をサポートしており、これらはすべてLinuxおよびWindows上のDockerでシームレスに動作します。

推奨されるLinux Dockerディストリビューション

IronWordのスムーズな操作のために、次の64ビットLinuxディストリビューションをお勧めします:

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

.NETランタイムとSDKを使用してセットアップと依存関係管理を簡素化するためにMicrosoftの公式Dockerイメージを使用してください

IronWord NuGet パッケージ

IronWordは、そのNuGetパッケージを通じて任意の.NETプロジェクトに簡単に追加できます。 NuGetパッケージマネージャーコンソールで次のコマンドを実行するだけで、ライブラリが自動的に追加されます:

Install-Package IronWord

Ubuntu Dockerfile 例

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 例

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の互換性のために、mcr.microsoft.com/dotnet/runtime:6.0-centos7のようなCentOSベースの.NETランタイムを使用してください。

# Build stage
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

# Runtime stage - 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"]

注意事項 & トラブルシューティング

• IronWordは.NET5〜9、.NET Standard (2.x, 3.x)、および.NET Framework 4.6.2+を完全にサポートします。
• 適切なレンダリングのために、Linuxコンテナ上でフォントが必要であれば（例：fonts-liberation、ttf-mscorefonts-installer）、インストールしてください。