So führen Sie Aspose.Cells in Docker aus

Microservices in Verbindung mit Containerisierung ermöglichen es, Technologien einfach zu kombinieren. Docker ermöglicht Ihnen die einfache Integration der Aspose.Cells-Funktionalität in Ihre Anwendung, unabhängig davon, welche Technologie sich in Ihrem Entwicklungsstack befindet.

Falls Sie auf Microservices abzielen oder wenn die Haupttechnologie in Ihrem Stack nicht .NET, C++ oder Java ist, Sie aber die Aspose.Cells-Funktionalität benötigen oder wenn Sie Docker bereits in Ihrem Stack verwenden, dann könnten Sie daran interessiert sein, Aspose.Cells in einem Docker zu verwenden Container.

Voraussetzungen

Docker muss auf Ihrem System installiert sein. Informationen zur Installation von Docker auf Windows oder Mac finden Sie unter den Links im Abschnitt „Siehe auch“.
Beachten Sie außerdem, dass Visual Studio 2019, .NET Core 3.1 SDK in dem unten bereitgestellten Beispiel verwendet wird.

Hello World Anwendung

In diesem Beispiel erstellen Sie eine einfache Hello World-Konsolenanwendung, die ein „Hello World!“ Dokument und speichert es in allen unterstützten Speicherformaten. Die Anwendung kann dann in Docker erstellt und ausgeführt werden.

Erstellen der Konsolenanwendung

Gehen Sie wie folgt vor, um das Programm Hello World zu erstellen:

Stellen Sie nach der Installation von Docker sicher, dass es Linux-Container verwendet (Standard). Wählen Sie bei Bedarf die Option Zu Linux-Containern wechseln im Menü Docker-Desktops aus.
Erstellen Sie in Visual Studio eine .NET Core-Konsolenanwendung.
Installieren Sie die neueste Aspose.Cells-Version von NuGet. System.Drawing.Common und System.Text.Encoding.CodePages werden als Abhängigkeit von Aspose.Cells installiert.
Da die Anwendung unter Linux ausgeführt wird, müssen die entsprechenden nativen Linux-Assets installiert werden. Beginnen Sie mit dem dotnet Core SDK 3.1-Basisimage und installieren Sie libgdiplus libc6-dev.

Wenn alle erforderlichen Abhängigkeiten hinzugefügt sind, schreiben Sie ein einfaches Programm, das ein „Hello World!“ erstellt. Arbeitsmappe und speichert sie in allen unterstützten Speicherformaten:
.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);
                    }
                }
            }
        }
    }
}

Beachten Sie, dass der Ordner „TestOut“ als Ausgabeordner zum Speichern von Ausgabedokumenten angegeben ist. Beim Ausführen der Anwendung in Docker wird ein Ordner auf dem Hostcomputer in diesen Ordner im Container gemountet. Dadurch können Sie die von Aspose.Cells generierte Ausgabe einfach im Docker-Container anzeigen.

Dockerfile konfigurieren

Der nächste Schritt besteht darin, das Dockerfile zu erstellen und zu konfigurieren.

Erstellen Sie das Dockerfile und platzieren Sie es neben der Lösungsdatei Ihrer Anwendung. Behalten Sie diesen Dateinamen ohne Erweiterung bei (Standardeinstellung).
Geben Sie in der Dockerfile Folgendes an:

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"]

Das Obige ist ein einfaches Dockerfile, das die folgenden Anweisungen enthält:

Das zu verwendende SDK-Image. Hier ist es das .Net Core SDK 3.1-Image. Docker lädt es herunter, wenn der Build ausgeführt wird. Die Version des SDK wird als Tag angegeben.
Installieren Sie Schriftarten, da das SDK-Image nur sehr wenige Schriftarten enthält. Der Befehl kopiert Schriftartdateien von lokal in das Docker-Image. Stellen Sie sicher, dass Sie über ein lokales „Fonts“-Verzeichnis verfügen, das alle Schriftarten enthält, die Sie installieren müssen. In diesem Beispiel wird das lokale „fonts“-Verzeichnis in dasselbe Verzeichnis wie die Dockerfile gestellt.
Das Arbeitsverzeichnis, das in der nächsten Zeile angegeben wird.
Der Befehl, alles in den Container zu kopieren, die Anwendung zu veröffentlichen und den Einstiegspunkt anzugeben.
Der Befehl zum Installieren von libgdiplus wird im Container ausgeführt. Dies wird von System.Drawing.Common benötigt.

Erstellen und Ausführen der Anwendung in Docker

Jetzt kann die Anwendung in Docker erstellt und ausgeführt werden. Öffnen Sie Ihre bevorzugte Eingabeaufforderung, wechseln Sie in das Verzeichnis mit der Anwendung (Ordner, in dem sich die Lösungsdatei und die Dockerfile befinden) und führen Sie den folgenden Befehl aus:

docker build -t actest .

Die erste Ausführung dieses Befehls kann länger dauern, da Docker die erforderlichen Bilder herunterladen muss. Führen Sie nach Abschluss des vorherigen Befehls den folgenden Befehl aus:

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

Achten Sie auf das Argument mount, da, wie bereits erwähnt, ein Ordner auf dem Hostcomputer in den Ordner des Containers eingehängt wird, um die Ergebnisse der Anwendungsausführung einfach anzuzeigen. Bei Pfaden in Linux wird zwischen Groß- und Kleinschreibung unterschieden.

Bilder, die Aspose.Cells unterstützen

Aspose.Cells for .NET Standard unterstützt EMF und TIFF nicht unter Linux.

Mehr Beispiele

1. So führen Sie die Anwendung in Windows Server 2019 aus

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"]

Docker-Image erstellen

docker build -t actest .

Führen Sie das Docker-Image aus

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

2. Um die Anwendung unter Linux auszuführen

Schreiben Sie ein einfaches Programm, das den Schriftartordner festlegt und eine „Hello World!“ erstellt. Arbeitsmappe und speichert sie.

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"]

Docker-Image erstellen

docker build -t actest .

Führen Sie das Docker-Image aus

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

Siehe auch

Installieren Sie Docker Desktop unter Windows
Installieren Sie Docker Desktop auf dem Mac
Visual Studio 2019, .NET Core 3.1-SDK
Wechseln Sie zu Linux-Containern Möglichkeit
Weitere Informationen auf.NET Kern-SDK

So führen Sie Aspose.Cells für .Net6 aus So führen Sie die Beispiele aus