Cómo ejecutar Aspose.Slides en Docker

Sistemas operativos compatibles

Aspose.Slides puede ejecutarse dentro de contenedores Docker usando la plataforma .NET Core. En general, Aspose.Slides admite todos los tipos de contenedores (SO) que admite la plataforma .NET Core. Sin embargo, el GDI o libgdiplus debe estar disponible y configurado correctamente en los contenedores involucrados.

Para usar Docker, primero debe instalarlo en su sistema. Para aprender a instalar Docker en Windows o Mac, utilice estos enlaces:

También puede ejecutar Docker en Linux y Windows Server siguiendo las instrucciones en estas páginas:

Instalar y configurar Docker en Linux (apt-get libgdiplus)
Instalar y configurar Docker en Linux (make install libgdiplus)
Instalar y configurar Docker en Windows Server Core

La instalación y configuración de Docker en Windows Server Nano no está soportada. Desafortunadamente, Windows Server Nano no contiene el subsistema gráfico integrado. No incluye gdiplus.dll, que requiere la biblioteca System.Drawing.Common, y no puede usarse con la biblioteca Aspose.Slides.

Aunque es posible ejecutar contenedores Linux en Windows, recomendamos ejecutarlos de forma nativa en Linux (incluso en un Linux instalado manualmente en una VM usando VirtualBox).

Instalar y Configurar Docker en Linux (apt-get libgdiplus)

SO: Ubuntu 18.04.
Dockerfile: Dockerfile-Ubuntu18_04_apt_get_libgdiplus

Este archivo Docker contiene instrucciones para crear una imagen de contenedor con el paquete libgdiplus instalado desde los repositorios oficiales de paquetes de Ubuntu.

Aquí está el contenido del archivo Docker:


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

\# instalar libgdiplus

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

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

\# crear puntos de montaje

VOLUME /slides-src

\# compilar y probar Aspose.Slides al iniciar

WORKDIR /slides-src

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

Revisemos lo que significa cada línea de código en el archivo Docker:

La imagen del contenedor se basa en la imagen microsoft/dotnet:2.1-sdk-bionic (la imagen ya construida por Microsoft y publicada en el hub público). Esta imagen contiene el SDK dotnet 2.1 ya instalado. El sufijo Bionic indica que se tomará Ubuntu 18.04 (nombre en clave bionic) como SO del contenedor. Cambiando el sufijo es posible cambiar el SO subyacente (por ejemplo: stretch – Debian 9, alpine – Alpine Linux). En ese caso será necesario modificar el contenido del archivo Docker (por ejemplo, cambiar ‘apt-get’ por ‘yum’).


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

Actualiza la base de datos de paquetes disponibles e instala el paquete apt-utils.


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

Instala los paquetes ‘libgdiplus’ y ‘libc6-dev’ requeridos por la biblioteca System.Drawing.Common.


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

Declara la carpeta /slides-src como punto de montaje que utilizaremos para proporcionar acceso a la carpeta de fuentes slide‑net en la máquina host.


 VOLUME /slides-src

Establece slides‑src como directorio de trabajo dentro del contenedor.


 WORKDIR /slides-src

Declara un comando predeterminado que se ejecutará al iniciar el contenedor en caso de que no se especifique un comando explícito.


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

Según las instrucciones del archivo Docker, la imagen resultante del contenedor tendrá Ubuntu 18.04, dotnet‑sdk, libgdiplus y los paquetes libc6-dev ya instalados. Además, esta imagen contará con un punto de montaje predefinido y un comando predeterminado al ejecutarse.

Para construir una imagen usando este archivo Docker, debe ir a la carpeta docker de slides‑netuil y ejecutar:


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

-f Dockerfile-Ubuntu18_04_apt_get_libgdiplus – opción que especifica qué archivo Docker usar.
-t ubuntu18_04_apt_get_libgdiplus – especifica la etiqueta (nombre) para la imagen resultante.
'.' – especifica el contexto para Docker. En nuestro caso, el contexto es la carpeta actual y está vacío, ya que elegimos proporcionar las fuentes de slides‑net como punto de montaje (esto nos permite no reconstruir la imagen Docker en cada cambio de fuentes).

El resultado de la ejecución debería verse así:


 Successfully built 62dd34ddc142

Successfully tagged ubuntu18_04_apt_get_libgdiplus:latest

Para asegurar que la nueva imagen se haya añadido al repositorio local de imágenes:


 $ docker images

\----

REPOSITORY                      TAG                 IMAGE ID            CREATED             SIZE

ubuntu18_04_apt_get_libgdiplus   latest              62dd34ddc142        2 minutes ago         1.78GB

Una vez que la imagen esté lista, podemos ejecutarla con este comando:


 $ 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 – especifica que el comando debe ejecutarse de forma interactiva, permitiendo ver la salida y proporcionar entrada.
-v pwd/../../:/slides-src – especifica la carpeta para el punto de montaje predefinido; como el directorio de trabajo actual es slides‑netuildocker, la carpeta slides‑src dentro del contenedor apuntará a la carpeta slides‑net en el host. pwd se usa para indicar la ruta relativa.
–add-host dev.slides.external.tool.server:192.168.1.48 – modifica el archivo hosts del contenedor para resolver la URL dev.slides.external.tool.server.
ubuntu1804aptgetlibgdiplus:latest – especifica la imagen que se ejecutará en el contenedor.

El resultado del comando anterior será la salida de netcore.linux.tests.sh (ya que se definió como comando predeterminado para el contenedor):


 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.

Del resultado se observa que los archivos de registro de las pruebas Func y Regr se colocaron en el directorio /build-out/netstandard20/test-results/main/. Además, aproximadamente 200 pruebas fallaron en total, y todas están relacionadas con problemas de renderizado debidos a la ausencia de fuentes requeridas en el contenedor.

Para sobrescribir el comando predeterminado del contenedor en una ejecución, podríamos usar este comando:


 $ 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

Así, en lugar de netcore.linux.tests.sh, se ejecutará /bin/bash y proporcionará una sesión terminal activa del contenedor desde la cual podrá ejecutarse (./build/netcore.linux.tests.sh). Este enfoque puede ser útil en escenarios de solución de problemas.

Instalar y Configurar Docker en Linux (make install libgdiplus)

SO: Ubuntu 18.04.
Dockerfile: Dockerfile-Ubuntu18_04_make_libgdiplus

Actualmente, Ubuntu solo contiene la versión 4.2 de libgdiplus, mientras que la versión 5.6 ya está disponible en el sitio oficial del producto. Para probar la última versión de libgdiplus, necesitamos preparar una imagen con libgdiplus construido a partir de las fuentes.

Revisemos el contenido del archivo Docker:

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

\# construir libgdiplus estable más reciente

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

\# crear puntos de montaje

VOLUME /slides-src

\# compilar y probar Aspose.Slides al iniciar

WORKDIR /slides-src

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

La única diferencia es la sección build latest stable libgdiplus. Esta sección instala todas las herramientas necesarias para compilar libgdiplus, clona las fuentes, las compila y las instala en la ubicación correcta. Todo lo demás es idéntico a Instalar y configurar Docker en Linux (apt-get libgdiplus).

Nota: No olvide usar etiquetas de imagen diferentes (nombre) para la imagen resultante en los comandos docker build y 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

Instalar y Configurar Docker en Windows Server Core

SO: Ubuntu 18.04.
Dockerfile: DockerfileWinServerCore

Nota: Se requiere Windows 10 Pro o Windows Server 2016 para ejecutar contenedores Windows.

Desafortunadamente, Microsoft no proporciona una imagen Windows Server Core con el SDK dotnet instalado, por lo que debemos instalarlo manualmente:


 # escape=

FROM microsoft/windowsservercore:1803 AS installer-env

# establecer ejecutor predeterminado de powershell

SHELL ["powershell", "-Command", "$ErrorActionPreference = 'Stop'; $ProgressPreference = 'SilentlyContinue';"]

\# escape=

FROM microsoft/windowsservercore:1803 AS installer-env

# establecer ejecutor predeterminado de powershell

SHELL ["powershell", "-Command", "$ErrorActionPreference = 'Stop'; $ProgressPreference = 'SilentlyContinue';"]

\# Obtener .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;

# devolver cmd como ejecutor predeterminado

SHELL ["cmd", "/S", "/C"]

# Para establecer la variable PATH del sistema, se debe usar ContainerAdministrator

USER ContainerAdministrator

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

USER ContainerUser

# crear puntos de montaje

VOLUME c:/slides-src

# compilar y probar Aspose.Slides al iniciar

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

La imagen resultante se construirá sobre la imagen microsoft/windowsservercore:1803 proporcionada por Microsoft en el docker hub. El dotnet‑sdk de la versión especificada se descargará y descomprimirá; la variable de entorno PATH del sistema se actualizará para incluir la ruta al ejecutable dotnet. La última línea define el comando que ejecuta las pruebas func & regr en el contenedor usando nant.exe como acción predeterminada al ejecutar el contenedor.

Comando para construir la imagen:


 docker build -f Dockerfile_WinServerCore -t winservercore_slides .

Comando para ejecutar la imagen:

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

Nota: El comando para el contenedor Windows utiliza 2 argumentos adicionales: -cpu-count 3 – establece el número de núcleos disponibles para el contenedor.
-memory 8589934592 – establece la cantidad de memoria disponible para el contenedor. Por defecto, solo 1 núcleo y 1 GB de RAM están disponibles para el contenedor Windows (los contenedores Linux no tienen limitaciones por defecto).

Además, falta 1 argumento en comparación con el mismo comando que usamos para ejecutar el contenedor Linux: -add-host dev.slides.external.tool.server:192.168.1.48 – modifica el archivo hosts para resolver esa URL.
Esto se debe a que un contenedor que se ejecuta en Windows simplemente no requiere external.tool.server.

El resultado del comando anterior debería verse así:

 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.

Cómo ejecutar ejemplos Aspose.Slides para Xamarin