Docker で Aspose.Words を実行する方法

マイクロサービスをコンテナ化と組み合わせることで、テクノロジーを簡単に組み合わせることができます。 Docker を使用すると、開発スタックにどのようなテクノロジが含まれているかに関係なく、Aspose.Words 機能をアプリケーションに簡単に統合できます。

マイクロサービスを対象としている場合、またはスタックの主要なテクノロジーが .NET、C++、Java ではないが Aspose.Words 機能が必要な場合、またはスタックですでに Docker を使用している場合は、Docker で Aspose.Words を利用することに興味があるかもしれません。容器。

前提条件

Docker がシステムにインストールされている必要があります。 Windows または Mac に Docker をインストールする方法については、「関連項目」セクションのリンクを参照してください。
また、以下の例では Visual Studio 2017、.NET Core 2.2 SDK が使用されていることにも注意してください。

ハローワールドアプリケーション

この例では、「Hello World!」と言う単純な Hello World コンソールアプリケーションを作成します。ドキュメントを保存し、サポートされているすべての保存形式で保存します。その後、アプリケーションを Docker で構築して実行できます。

コンソールアプリケーションの作成

Hello World プログラムを作成するには、次の手順に従います。

Docker をインストールしたら、Linux コンテナ (デフォルト) を使用していることを確認します。必要に応じて、Docker デスクトップメニューから Linux コンテナに切り替えるオプションを選択します。
Visual Studio で、.NET Core コンソールアプリケーションを作成します。
NuGet から最新の Aspose.Words バージョンをインストールします。 SkiaSharp は Aspose.Words の依存関係としてインストールされます。
アプリケーションは Linux 上で実行されるため、適切なネイティブ Linux アセットをインストールする必要があります。 Debian ベースイメージから始めて、SkiaSharp.NativeAssets.Linux をインストールします。
必要な依存関係をすべて追加したら、「Hello World!」を作成する簡単なプログラムを作成します。ドキュメントを保存し、サポートされているすべての保存形式で保存します。

なお、出力ドキュメントを保存する出力フォルダとして「TestOut」フォルダが指定されています。 Docker でアプリケーションを実行すると、ホストマシン上のフォルダーがコンテナ内のこのフォルダーにマウントされます。これにより、Docker コンテナ内の Aspose.Words によって生成された出力を簡単に表示できるようになります。

Dockerfileの構成

次のステップは、Dockerfile を作成して構成することです。

Dockerfile を作成し、アプリケーションのソリューションファイルの隣に配置します。このファイル名は拡張子なしでそのままにしておきます (デフォルト)。
Dockerfile で次を指定します。

FROM mcr.microsoft.com/dotnet/core/sdk:2.2
WORKDIR /app
RUN apt-get update && apt-get install -y libfontconfig1
COPY . ./
RUN dotnet publish -c Release -o out
ENTRYPOINT ["dotnet", "Aspose.Words.Docker.Sample/out/Aspose.Words.Docker.Sample.dll"]

上記は単純な Dockerfile であり、次の命令が含まれています。

使用する SDK イメージ。これは .NET Core SDK 2.2 イメージです。ビルドの実行時に Docker によってダウンロードされます。 SDKのバージョンをタグで指定します。
作業ディレクトリ。次の行で指定します。
libfontconfig1 をインストールするコマンドはコンテナーで実行されます。これは SkiaSharp に必要です。
すべてをコンテナにコピーし、アプリケーションを公開し、エントリポイントを指定するコマンド。

Docker でのアプリケーションの構築と実行

これで、アプリケーションを Docker で構築して実行できるようになりました。お気に入りのコマンドプロンプトを開き、アプリケーションのあるフォルダー (ソリューションファイルと Dockerfile が配置されているフォルダー) にディレクトリを変更し、次のコマンドを実行します。

docker build -t awtest .

このコマンドを初めて実行するときは、Docker が必要なイメージをダウンロードする必要があるため、時間がかかることがあります。前のコマンドが完了したら、次のコマンドを実行します。

docker run --mount type=bind,source=C:\Temp,target=/TestOut --rm awtest from Docker

前述したように、アプリケーションの実行結果を簡単に確認できるように、ホストマシン上のフォルダーがコンテナーのフォルダーにマウントされるため、マウント引数に注意してください。 Linux のパスでは大文字と小文字が区別されます。

Aspose.Wordsをサポートするイメージ

Aspose.Words は .NET Framework と .NET Core の両方で使用できます。 .NET Core イメージは .NET Framework イメージよりもサイズがはるかに小さいため、マイクロサービスの作成やコンテナーでの使用には .NET Core が適しています。 Windows コンテナよりも軽量な Linux Docker コンテナ (クロスプラットフォーム展開用) にアプリを展開することができます。

.NET Core SDK の公式イメージは次の目的で提供されています。

Debian 9 および 10
Ubuntu 18.04 および 19.04
Alpine 3.7 および 3.9
WindowsナノServer

グラフィックスを操作するには、Aspose.Words for .NET Standard は SkiaSharp に依存します。これにより、Aspose.Words を実行できるイメージが次のものに制限されます。

Debian 9 および 10
Ubuntu 18.04 および 19.04
Alpine 3.9

SkiaSharp は、ネイティブの依存関係、これは SkiaSharp の既知の問題ですが欠如しているため、Windows Nano Server では動作しません。この問題は、SkiaSharp バージョン 1.68.1.1 で解決される予定です。 Windows コンテナーで Aspose.Words を実行する必要がある場合は、SkiaSharp に依存しない .NET Framework バージョンの Aspose.Words で .NET Framework ベースイメージを使用します。

SkiaSharp は、ネイティブ Skia ライブラリのラッパーです。 SkiaSharp NuGet パッケージでは、次のランタイムが提供されます。

OSX
ティゼン・アーメル
tizen-x86
win10-arm
win10-x64
win10-x86
win-x64
win-x86

Linux で実行するには、以下に示す Skia ライブラリのネイティブビルドなど、対応するネイティブアセットを含む追加の NuGet パッケージを使用する必要があります。

SkiaSharp.NativeAssets.Linux – x64 Debian ベースの Linux ディストリビューション用のネイティブ Skia ビルドを提供します。
SkiaSharp.NativeAssets.Linux.NoDependencies – このパッケージは、libfontconfig 依存関係のない Linux ディストリビューションで使用することを目的としています。 RHEL 7 (x64) でテスト済み。
Goelze.SkiaSharp.NativeAssets.AlpineLinux – x64 Alpine Linux 3.9 用のネイティブ Skia ビルドを提供します。
Jellyfin.SkiaSharp.NativeAssets.LinuxArm – arm32 および arm64 Debian ベースの Linux ディストリビューション用のネイティブ Skia ビルドを提供します。

他の例

上記の例では、アプリケーションは SDK イメージで実行されました。 SDK イメージはランタイムイメージよりも重いです。以下の例は、SDK イメージを使用してアプリケーションを構築し、ランタイムイメージを使用してアプリケーションを実行するために、Docker ファイルをどのように変更する必要があるかを示しています。

FROM mcr.microsoft.com/dotnet/core/sdk:2.2 AS build
WORKDIR /app
\# copy csproj and restore as distinct layers
COPY Aspose.Words.Docker.Sample/*.csproj ./Aspose.Words.Docker.Sample/
WORKDIR /app/Aspose.Words.Docker.Sample
RUN dotnet restore
\# copy and publish app and libraries
WORKDIR /app/
COPY Aspose.Words.Docker.Sample/. ./Aspose.Words.Docker.Sample/
WORKDIR /app/Aspose.Words.Docker.Sample
RUN dotnet publish -c Release -o out
\# copy to runtime environment
FROM mcr.microsoft.com/dotnet/core/runtime:2.2 AS runtime
WORKDIR /app
\# libfontconfig1 is required to properly work with fonts in Linux.
RUN apt-get update && apt-get install -y libfontconfig1
RUN apt install libharfbuzz-icu0
COPY --from=build /app/Aspose.Words.Docker.Sample/out ./
ENTRYPOINT ["dotnet", "Aspose.Words.Docker.Sample.dll"]

Ubuntu 18.04 でアプリケーションを実行するには、Dockerfile は実質的に同じままです (タグのみが変更されます)。

FROM mcr.microsoft.com/dotnet/core/sdk:2.2-bionic AS build
WORKDIR /app
\# copy csproj and restore as distinct layers
COPY Aspose.Words.Docker.Sample/*.csproj ./Aspose.Words.Docker.Sample/
WORKDIR /app/Aspose.Words.Docker.Sample
RUN dotnet restore
\# copy and publish app and libraries
WORKDIR /app/
COPY Aspose.Words.Docker.Sample/. ./Aspose.Words.Docker.Sample/
WORKDIR /app/Aspose.Words.Docker.Sample
RUN dotnet publish -c Release -o out
\# copy to runtime environment
FROM mcr.microsoft.com/dotnet/core/runtime:2.2-bionic AS runtime
WORKDIR /app
\# libfontconfig1 is required to properly work with fonts in Linux.
RUN apt-get update && apt-get install -y libfontconfig1
RUN apt install libharfbuzz-icu0
COPY --from=build /app/Aspose.Words.Docker.Sample/out ./
ENTRYPOINT ["dotnet", "Aspose.Words.Docker.Sample.dll"]

Alpine Linux でアプリケーションを実行するには、SkiaSharp ネイティブアセットを追加し、次の Dockerfile を使用する必要があります。

FROM mcr.microsoft.com/dotnet/core/sdk:2.2-alpine3.9 AS build
WORKDIR /app
\# copy csproj and restore as distinct layers
COPY Aspose.Words.Docker.Sample/*.csproj ./Aspose.Words.Docker.Sample/
WORKDIR /app/Aspose.Words.Docker.Sample
RUN dotnet restore
\# copy and publish app and libraries
WORKDIR /app/
COPY Aspose.Words.Docker.Sample/. ./Aspose.Words.Docker.Sample/
WORKDIR /app/Aspose.Words.Docker.Sample
RUN dotnet publish -c Release -o out
\# copy to runtime environment
FROM mcr.microsoft.com/dotnet/core/runtime:2.2-alpine3.9 AS runtime
WORKDIR /app
\# fontconfig is required to properly work with fonts in Linux.
RUN apk update && apk upgrade && apk add fontconfig && apk add harfbuzz
COPY --from=build /app/Aspose.Words.Docker.Sample/out ./
ENTRYPOINT ["dotnet", "Aspose.Words.Docker.Sample.dll"]

RHEL 7 でアプリケーションを実行するには、SkiaSharp ネイティブアセットを追加し、次の Dockerfile を使用する必要があります。

FROM mcr.microsoft.com/dotnet/core/sdk:2.1 AS build
WORKDIR /app
\# copy csproj and restore as distinct layers
COPY Aspose.Words.Docker.Sample/*.csproj ./Aspose.Words.Docker.Sample/
WORKDIR /app/Aspose.Words.Docker.Sample
RUN dotnet restore
\# copy and publish app and libraries
WORKDIR /app/
COPY Aspose.Words.Docker.Sample/. ./Aspose.Words.Docker.Sample/
WORKDIR /app/Aspose.Words.Docker.Sample
RUN dotnet publish -c Release -o out
\# copy to runtime environment
FROM kkamberta/dotnet-21-rhel7 AS runtime
WORKDIR /app
COPY --from=build /app/Aspose.Words.Docker.Sample/out ./
ENTRYPOINT ["/opt/rh/rh-dotnet21/root/usr/bin/dotnet", "Aspose.Words.Docker.Sample.dll"]