如何在 Docker 中运行 Aspose.Slides

受支持的操作系统

Aspose.Slides 可以在使用 .NET Core 平台的 Docker 容器中运行。一般来说，Aspose.Slides 支持 .NET Core 平台所支持的所有容器类型（操作系统）类型。然而，GDI 或 libgdiplus 必须在相关容器中可用并正确配置。

要使用 Docker，必须先在你的系统上安装它。了解如何在 Windows 或 Mac 上安装 Docker，请使用以下链接：

你也可以按照这些页面上的说明在 Linux 和 Windows Server 上运行 Docker：

在 Linux 上安装和配置 Docker（apt-get libgdiplus）
在 Linux 上安装和配置 Docker（make install libgdiplus）
在 Windows Server Core 上安装和配置 Docker

不支持在 Windows Server Nano 上安装和配置 Docker。遗憾的是，Windows Server Nano 不包含图形子系统。它不包含 System.Drawing.Common 库所需的 gdiplus.dll，因而无法与 Aspose.Slides 库一起使用。

虽然可以在 Windows 上运行 Linux 容器，但我们建议在 Linux 上原生运行它们（即使是在使用 VirtualBox 手动安装在虚拟机上的 Linux）。

在 Linux 上安装和配置 Docker（apt-get libgdiplus）

操作系统：Ubuntu 18.04。
Dockerfile：Dockerfile-Ubuntu18_04_apt_get_libgdiplus

此 Docker 文件包含从 Ubuntu 官方包仓库安装 libgdiplus 包的容器镜像构建指令。

以下是 Docker 文件内容：


 FROM microsoft/dotnet:2.1-sdk-bionic AS build

\# 安装 libgdiplus

RUN apt-get update -y && apt-get install -y apt-utils

RUN apt-get install -y libgdiplus && apt-get install -y libc6-dev

\# 创建挂载点

VOLUME /slides-src

\# 启动时构建并测试 Aspose.Slides

WORKDIR /slides-src

CMD ./build/netcore.linux.tests.sh

让我们逐行查看 Docker 文件中的代码含义：

容器镜像基于 microsoft/dotnet:2.1-sdk-bionic 镜像（该镜像已由 Microsoft 构建并发布在 Docker 的 public hub 上）。此镜像已经安装了 dotnet 2.1 SDK。Bionic 后缀表示将使用 Ubuntu 18.04（代号 bionic）作为容器的操作系统。通过更改后缀，可以更换底层操作系统（例如：stretch —— Debian 9，alpine —— Alpine Linux）。在这种情况下，需要修改 Docker 文件内容（例如，将 apt-get 改为 yum）。


 FROM microsoft/dotnet:2.1-sdk-bionic AS build:

更新可用软件包数据库并安装 apt-utils 软件包。


 RUN apt-get update -y && apt-get install -y apt-utils

安装 System.Drawing.Common 库所需的 libgdiplus 和 libc6-dev 软件包。


 RUN apt-get install -y libgdiplus && apt-get install -y libc6-dev

声明 /slides-src 文件夹为挂载点，用于提供对主机机器上 slide-net 源代码文件夹的访问。


 VOLUME /slides-src

将 slides-src 设置为容器内的工作目录。


 WORKDIR /slides-src

声明默认命令，如果未指定显式命令，则在容器启动时运行该命令。


 CMD ./build/netcore.linux.tests.sh

根据 Docker 文件中的指令，生成的容器镜像将包含 Ubuntu 18.04 操作系统、dotnet-sdk、libgdiplus 和 libc6-dev 软件包。该镜像还预设了挂载点和运行时的默认命令。

要使用此 Docker 文件构建镜像，需要进入 slides-netuil Docker 文件夹并执行：


 $ docker build -f Dockerfile-Ubuntu18_04_apt_get_libgdiplus -t ubuntu18_04_apt_get_libgdiplus .

-f Dockerfile-Ubuntu18_04_apt_get_libgdiplus – 选项指定使用的 Docker 文件。

-t ubuntu18_04_apt_get_libgdiplus – 为生成的镜像指定标签（名称）。

'.' – 指定 Docker 的上下文。这里上下文是当前文件夹，且为空——因为我们选择将 slides-net 源码作为挂载点（这样无需在每次更改源码时重新构建 Docker 镜像）。

执行结果应如下所示：


 Successfully built 62dd34ddc142

Successfully tagged ubuntu18_04_apt_get_libgdiplus:latest

为了确认新镜像已添加到本地镜像仓库：


 $ docker images

\----

REPOSITORY                      TAG                 IMAGE ID            CREATED             SIZE

ubuntu18_04_apt_get_libgdiplus   latest              62dd34ddc142        2 minutes ago         1.78GB

镜像准备好后，可使用以下命令运行它：


 $ docker run -it -v pwd/../../:/slides-src --add-host dev.slides.external.tool.server:192.168.1.48 ubuntu18_04_apt_get_libgdiplus:latest

-it – 指定以交互模式运行命令，允许我们查看输出并获取输入。

-v pwd/../../:/slides-src – 指定预定义挂载点的文件夹——因为当前工作目录是 slides-netuilDocker，容器内的 slides-src 文件夹将指向主机上的 slides-net 文件夹。pwd 用于指定相对路径。

–add-host dev.slides.external.tool.server:192.168.1.48 – 修改容器的 hosts 文件，以解析 dev.slides.external.tool.server 地址。

ubuntu1804aptgetlibgdiplus:latest – 指定要运行的镜像。

上述命令的结果将是 netcore.linux.tests.sh 的输出（因为它被定义为容器的默认命令）：


 Restoring packages for /slides-src/targets/.NETCore/tests/Aspose.Slides.FuncTests.NetCore/Aspose.Slides.FuncTests.NetCore.csproj...

Restoring packages for /slides-src/targets/.NETStandard/main/Aspose.Slides.DOM.NetStandard/Aspose.Slides.DOM.NetStandard.csproj...

Restoring packages for /slides-src/targets/.NETStandard/main/Aspose.Slides.CompoundFile.NetStandard/Aspose.Slides.CompoundFile.NetStandard.csproj...

Installing System.Text.Encoding.CodePages 4.4.0.

Installing System.Drawing.Common 4.5.0.

...

Results File: /slides-src/build-out/netstandard20/test-results/main/Aspose.Slides.FuncTests.NetCore.trx

Total tests: Unknown. Passed: 2110. Failed: 108. Skipped: 210.

...

Results File: /slides-src/build-out/netstandard20/test-results/main/Aspose.Slides.RegrTests.NetCore.trx

Total tests: 2124. Passed: 1550. Failed: 103. Skipped: 471.

从结果可以看出，Func 和 Regr 测试的日志文件已放置在 /build-out/netstandard20/test-results/main/ 目录下。同时，总计约有 200 条测试失败——全部是由于容器缺少必需字体而导致的渲染问题。

若要在运行时覆盖容器的默认命令，可使用以下命令：


 $ docker run -it -v pwd/../../:/slides-src --add-host dev.slides.external.tool.server:192.168.1.48 ubuntu18_04_apt_get_libgdiplus:latest /bin/bash

因此，除了运行 netcore.linux.tests.sh 之外，还可以执行 /bin/bash，获得容器的交互终端会话，以便手动运行（./build/netcore.linux.tests.sh）。此方法在故障排查场景中非常有用。

在 Linux 上安装和配置 Docker（make install libgdiplus）

操作系统：Ubuntu 18.04。
Dockerfile：Dockerfile-Ubuntu18_04_make_libgdiplus

目前，Ubuntu 只提供 libgdiplus 的 4.2 版，而 5.6 版已经在产品的 official site 上可用。要测试最新版本的 libgdiplus，需要准备一个从源码构建 libgdiplus 的镜像。

以下是 Docker 文件内容：

 FROM microsoft/dotnet:2.1-sdk-bionic AS build

\# 构建最新稳定版 libgdiplus

RUN apt-get update -y

RUN apt-get install -y libgif-dev autoconf libtool automake build-essential gettext libglib2.0-dev libcairo2-dev libtiff-dev libexif-dev

RUN git clone -b 5.6 https://github.com/mono/libgdiplus

WORKDIR /libgdiplus

RUN ./autogen.sh

RUN make

RUN make install

RUN ln -s /usr/local/lib/libgdiplus.so /usr/lib/libgdiplus.so

\# 创建挂载点

VOLUME /slides-src

\# 启动时构建并测试 Aspose.Slides

WORKDIR /slides-src

CMD ./build/netcore.linux.tests.sh

唯一的区别在于 build latest stable libgdiplus 部分。该部分安装构建 libgdiplus 所需的所有工具，克隆源码，然后编译并安装到正确的位置。其他内容与在 Linux 上安装和配置 Docker（apt-get libgdiplus）相同。

注意：在 docker build 和 docker run 命令中，请使用不同的镜像标签（名称）：


 $ docker build \-f Dockerfile-Ubuntu18_04_apt_get_libgdiplus \-t ubuntu18_04_make_libgdiplus .

$ docker run \-it \-v pwd/../../:/slides-src \--add-host dev.slides.external.tool.server:192.168.1.48 ubuntu18_04_make_libgdiplus:latest

在 Windows Server Core 上安装和配置 Docker

操作系统：Ubuntu 18.04。
Dockerfile：DockerfileWinServerCore

注意：运行 Windows 容器需要 Windows 10 Pro 或 Windows Server 2016。

不幸的是，Microsoft 未提供预装 dotnet SDK 的 Windows Server Core 镜像，因此必须手动安装：

# escape=

FROM microsoft/windowsservercore:1803 AS installer-env

# 设置 PowerShell 默认执行程序
SHELL ["powershell", "-Command", "$ErrorActionPreference = 'Stop'; $ProgressPreference = 'SilentlyContinue';"]

# escape=

FROM microsoft/windowsservercore:1803 AS installer-env

# 设置 PowerShell 默认执行程序
SHELL ["powershell", "-Command", "$ErrorActionPreference = 'Stop'; $ProgressPreference = 'SilentlyContinue';"]

# 检索 .NET Core SDK
ENV DOTNET_SDK_VERSION 2.1.301

ENV DOTNET_PATH "c:/Program Files/dotnet"

RUN Invoke-WebRequest -OutFile dotnet.zip https://dotnetcli.blob.core.windows.net/dotnet/Sdk/$Env:DOTNET_SDK_VERSION/dotnet-sdk-$Env:DOTNET_SDK_VERSION-win-x64.zip; 

    $dotnet_sha512 = 'f2f6cc020f89dc4d4f8064cc914cffabde0ce422715138778a6bcbbb6803ca66d6fd967097a0209c47c89b85dd9e93db48486ac86999bd3a533e45b789fcea89'; 

    if ((Get-FileHash dotnet.zip -Algorithm sha512).Hash -ne $dotnet_sha512) { 

        Write-Host 'CHECKSUM VERIFICATION FAILED!'; 

        exit 1; 

    }; 

    

    Expand-Archive dotnet.zip -DestinationPath $Env:DOTNET_PATH;

# 将 cmd 设置为默认执行程序
SHELL ["cmd", "/S", "/C"]

# 为了设置系统 PATH，必须使用 ContainerAdministrator
USER ContainerAdministrator

RUN setx /M PATH "%PATH%;c:/Program Files/dotnet"

USER ContainerUser

# 创建挂载点
VOLUME c:/slides-src

# 启动时构建并测试 Aspose.Slides
WORKDIR c:/slides-src

CMD .\external\buildtools\nant\nant.exe -buildfile:.\build\netcore.tests.build -D:obfuscate_eaz_use_mock=true -D:slidesnet.run.func.tests=true -D:slidesnet.run.regr.tests=true

生成的镜像将基于 Microsoft 在 docker hub 上提供的 microsoft/windowsservercore:1803 镜像。指定版本的 dotnet-sdk 将被下载并解压；系统的 PATH 变量将更新以包含 dotnet 可执行文件的路径。最后一行定义了容器运行时使用 nant.exe 作为默认操作执行 func 与 regr 测试的命令。

构建镜像的命令：


 docker build -f Dockerfile_WinServerCore -t winservercore_slides .

运行镜像的命令：


 docker run -it --cpu-count 3 --memory 8589934592 -v e:\Project\Aspose\slides-net:c:\slides-src winservercore_slides:latest

注意：Windows 容器的命令使用了两个额外参数：

-cpu-count 3

-memory 8589934592

它们分别设置容器可用的 CPU 核心数和内存大小。默认情况下，Windows 容器仅提供 1 核心和 1 GB 内存（Linux 容器默认没有此类限制）。

与运行 Linux 容器的相同命令相比，缺少了以下参数：

-add-host dev.slides.external.tool.server:192.168.1.48

因为运行在 Windows 上的容器不需要 external.tool.server。

上述命令的运行结果应如下所示：


 NAnt 0.92 (Build 0.92.4543.0; release; 6/9/2012)

Copyright (C) 2001-2012 Gerry Shaw

http://nant.sourceforge.net

netcore20_runtests:

   [delete] Deleting directory 'c:\slides-src\build-out\netcore20\test-results\'.

   [mkdir] Creating directory 'c:\slides-src\build-out\netcore20\test-results\'.

...

[exec] Results File: C:\slides-src\/build-out/netcore20/test-results//main\Aspose.Slides.FuncTests.NetCore.trx

[exec] Total tests: 2338. Passed: 2115. Failed: 19. Skipped: 204.

...

[exec] Results File: C:\slides-src\/build-out/netcore20/test-results//main\Aspose.Slides.RegrTests.NetCore.trx

[exec] Total tests: 2728. Passed: 2147. Failed: 110. Skipped: 471.

如何运行示例 Aspose.Slides 适用于 Xamarin