Comment exécuter Aspose.Cells dans Docker

Les microservices, conjointement avec la conteneurisation, permettent de combiner facilement les technologies. Docker vous permet d’intégrer facilement la fonctionnalité Aspose.Cells dans votre application, quelle que soit la technologie utilisée dans votre pile de développement.

Si vous visez les microservices, ou si la technologie principale de votre pile n’est pas .NET, C++ ou Java, mais que vous avez besoin de la fonctionnalité Aspose.Cells, ou si vous utilisez déjà Docker dans votre pile, alors vous pourriez être intéressé par l’utilisation Aspose.Cells dans un conteneur Docker.

Prérequis

Docker doit être installé sur votre système. Pour des informations sur l’installation de Docker sur Windows ou Mac, reportez-vous aux liens dans la section “Voir aussi”.
De plus, notez que Visual Studio 2019, .NET Core 3.1 SDK est utilisé dans l’exemple ci-dessous.

Application Hello World

Dans cet exemple, vous créez une simple application console Hello World qui crée un document “Hello World!” et l’enregistre dans tous les formats d’enregistrement pris en charge. L’application peut ensuite être construite et exécutée dans Docker.

Création de l’application Console

Pour créer le programme Hello World, suivez les étapes ci-dessous:

Une fois Docker est installé, assurez-vous qu’il utilise les conteneurs Linux (par défaut). Si nécessaire, sélectionnez l’option Changer pour les conteneurs Linux dans le menu de Docker Desktops.
In Visual Studio, create a .NET Core console application.
Install the latest Aspose.Cells version from NuGet. System.Drawing.Common and System.Text.Encoding.CodePages will be installed as a dependency of Aspose.Cells.
Comme l’application sera exécutée sur Linux, les ressources natives Linux appropriées doivent être installées. Commencez par l’image de base dotnet core sdk 3.1 et installez libgdiplus libc6-dev.

When all required dependencies are added, write a simple program that creates a “Hello World!” workbook and saves it in all supported save formats:
.NET

using System;
namespace Aspose.Cells.Docker
{
    class Program
    {
        static void Main(string[] args)
        {
            Workbook workbook = new Workbook();
            workbook.Worksheets[0].Cells[0, 0].PutValue("Hello from Aspose.Cells!!!");
            foreach (SaveFormat sf in Enum.GetValues(typeof(SaveFormat)))
            {
                if (sf != SaveFormat.Unknown)
                {
                    try
                    {
                        // The folder specified will be mounted as a volume when run the application in Docker image.
                        var fileName = string.Format("out{0}", FileFormatUtil.SaveFormatToExtension(sf));
                        workbook.Save(fileName, sf);
                        Console.WriteLine("Saving {0}\t\t[OK]", sf);
                    }
                    catch
                    {
                        Console.WriteLine("Saving {0}\t\t[FAILED]", sf);
                    }
                }
            }
        }
    }
}

Notez que le dossier “TestOut” est spécifié comme dossier de sortie pour sauvegarder les documents de sortie. Lors de l’exécution de l’application dans Docker, un dossier sur la machine hôte sera monté dans ce dossier du conteneur. Cela vous permettra de facilement visualiser la sortie générée par Aspose.Cells dans le conteneur Docker.

Configuration d’un Dockerfile

La prochaine étape consiste à créer et configurer le Dockerfile.

Créez le Dockerfile et placez-le à côté du fichier de solution de votre application. Gardez ce nom de fichier sans extension (par défaut).
Dans le Dockerfile, spécifiez:

FROM mcr.microsoft.com/dotnet/core/sdk:3.1-buster 
COPY fonts/* /usr/share/fonts/
WORKDIR /app
COPY . ./
RUN apt-get update && \
    apt-get install -y --allow-unauthenticated libgdiplus libc6-dev
RUN dotnet publish "Aspose.Cells.Docker.csproj" -c Release -o /app/publish
ENTRYPOINT ["dotnet", "publish/Aspose.Cells.Docker.dll"]

Ci-dessus se trouve un Dockerfile simple, contenant les instructions suivantes:

L’image SDK à utiliser. Ici, il s’agit de l’image .Net Core SDK 3.1. Docker la téléchargera lors de l’exécution de la construction. La version du SDK est spécifiée en tant que balise.
Installer les polices car l’image SDK contient très peu de polices. La commande copie les fichiers de police du local à l’image docker. Assurez-vous d’avoir un répertoire local de “polices” contenant toutes les polices dont vous avez besoin d’installer. Dans cet exemple, le répertoire local de “polices” est placé dans le même répertoire que le Dockerfile.
Le répertoire de travail, qui est spécifié à la ligne suivante.
La commande pour copier tout dans le conteneur, publier l’application et spécifier le point d’entrée.
La commande pour installer libgdiplus est exécutée dans le conteneur. Ceci est requis par System.Drawing.Common.

Construction et Exécution de l’Application dans Docker

Maintenant l’application peut être construite et exécutée dans Docker. Ouvrez votre invite de commande préférée, changez de répertoire vers le dossier de l’application (dossier où le fichier de solution et le Dockerfile sont placés) et exécutez la commande suivante:

docker build -t actest .

La première fois que cette commande est exécutée, cela peut prendre plus de temps, car Docker doit télécharger les images requises. Une fois la commande précédente terminée, exécutez la commande suivante:

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

Faites attention à l’argument de montage, car, comme mentionné précédemment, un dossier sur la machine hôte est monté dans le dossier du conteneur, pour voir facilement les résultats de l’exécution de l’application. Les chemins sous Linux sont sensibles à la casse.

Images Supportant Aspose.Cells

Aspose.Cells for .NET Standard ne prend pas en charge EMF et TIFF sur Linux.

Plus d’exemples

1. Pour exécuter l’application dans Windows Server 2019

Dockerfile

FROM microsoft/dotnet-framework:4.7.2-sdk-windowsservercore-ltsc2019
WORKDIR /app
COPY . ./
RUN dotnet publish "Aspose.Cells.Docker.csproj" -c Release -o /app/publish
ENTRYPOINT ["dotnet", "publish/Aspose.Cells.Docker.dll"]

Construire l’image Docker

docker build -t actest .

Exécuter l’image Docker

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

2. Pour exécuter l’application dans Linux

Écrire un programme simple qui définit le dossier de police, crée un classeur “Hello World!” et l’enregistre.

namespace Aspose.Cells.Docker.Fonts
{
    using System;
    using System.IO;

    class Program
    {
        static void Main(string[] args)
        {
            try
            {
                // Set font folders on linux.
                string[] fonts = { "/Fonts" };
                FontConfigs.SetFontFolders(fonts, true);
                // build workbook
                Workbook workbook = new Workbook();
                MemoryStream memoryStream = new MemoryStream();
                workbook.Worksheets[0].Cells[0, 0].PutValue("Hello from Aspose.Cells!!!");
                Style style = workbook.CreateStyle();
                style.Font.Name = "Arial";
                style.Font.Size = 16;
                workbook.Worksheets[0].Cells[0, 0].SetStyle(style);
                workbook.Save("/TestOut/TestFontsOut.xlsx");
            }
            catch (Exception e)
            {
                Console.WriteLine("Saving outfonts.xlsx\t\t[FAILED],{0}", e.Message);
            }

        }
    }
}

Dockerfile

FROM mcr.microsoft.com/dotnet/core/sdk:3.1-buster 
WORKDIR /app
COPY . ./
RUN apt-get update && \
    apt-get install -y --allow-unauthenticated libgdiplus libc6-dev
WORKDIR /app
COPY . ./
RUN dotnet publish "Aspose.Cells.Docker.Fonts.csproj" -c Release -o /app/publish
ENTRYPOINT ["dotnet", "publish/Aspose.Cells.Docker.Fonts.dll"]

Construire l’image Docker

docker build -t actest .

Exécuter l’image Docker

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

Voir aussi

Installer Docker Desktop sur Windows
Installer Docker Desktop sur Mac
Visual Studio 2019, .NET Core 3.1 SDK
Option pour passer aux conteneurs Linux
Informations supplémentaires sur le .NET Core SDK

Comment exécuter Aspose.Cells pour .Net6 Comment exécuter les exemples