如何在 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 程序,请按照以下步骤操作:

  1. 安装 Docker 后,请确保它使用 Linux 容器(默认)。如有必要,请从 Docker 桌面菜单中选择切换到 Linux 容器选项。
  2. 在 Visual Studio 中,创建 .NET Core 控制台应用程序。
    net-console-application
  3. 从 NuGet 安装最新的 Aspose.Words 版本。 SkiaSharp 将作为 Aspose.Words 的依赖项安装。
    skiasharp-dependency
  4. 由于应用程序将在 Linux 上运行,因此必须安装适当的本机 Linux 资产。从 Debian 基础映像开始并安装 SkiaSharp.NativeAssets.Linux
  5. 添加所有必需的依赖项后,编写一个简单的程序来创建"Hello World!“文档并将其保存为所有支持的保存格式:

请注意,“TestOut"文件夹被指定为用于保存输出文档的输出文件夹。当在 Docker 中运行应用程序时,主机上的一个文件夹将被挂载到容器中的该文件夹中。这将使您能够轻松查看 Docker 容器中 Aspose.Words 生成的输出。

配置 Dockerfile

下一步是创建和配置 Dockerfile。

  1. 创建 Dockerfile 并将其放置在应用程序的解决方案文件旁边。保留此文件名,不带扩展名(默认)。
  2. 在 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

支持 Aspose.Words 的图像

Aspose.Words 可用于 .NET Framework 和 .NET Core。 .NET Core 图像的大小比 .NET Framework 图像小得多,这使得 .NET Core 成为创建微服务和在容器中使用的更好选择。可以将应用程序部署到 Linux Docker 容器(用于跨平台部署),该容器比 Windows 容器更轻。

.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,请使用 .NET Framework 基础映像和 Aspose.Words 的 .NET Framework 版本,它不依赖于 SkiaSharp。

SkiaSharp 是原生 Skia 库的包装器。 SkiaSharp NuGet 包中提供了以下运行时:

  • 操作系统
  • 蒂森-阿梅尔
  • tizen-x86
  • win10-arm
  • win10-x64
  • win10-x86
  • win-x64
  • win-x86

要在 Linux 中运行它,您应该使用其他 NuGet 包以及相应的本机资源,例如 Skia 库的本机构建,如下所示:

  • 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 构建。

更多示例

  1. 在上面的示例中,应用程序在 SDK 映像中运行。 SDK 图像比运行时图像重。下面的示例演示了如何修改 Docker 文件,以便使用 SDK 映像来构建应用程序,并使用运行时映像来运行它:
    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"]
  2. 要在 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"]
  3. 要在 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"]
  4. 要在 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"]

也可以看看