Docker da Aspose.Cells ı Çalıştırma

Mikrohizmetler, konteynerleştirme ile birleştirildiğinde, teknolojileri kolayca birleştirmeyi mümkün kılar. Docker, geliştirme yığınızda hangi teknolojinin olduğundan bağımsız olarak Aspose.Cells işlevselliğini kolayca entegre etmenize olanak tanır.

Mikrohizmetleri hedefliyorsanız veya yığınınızda temel teknoloji .NET, C++ veya Java değilse ancak Aspose.Cells işlevselliğine ihtiyacınız varsa veya zaten yığınınızda Docker kullanıyorsanız, bu durumda Aspose.Cells’ı bir Docker konteynırında kullanmayı düşünebilirsiniz.

Önkoşullar

• Docker’ın sisteminizde yüklü olması gerekmektedir. Windows veya Mac’te Docker’ı nasıl yükleyeceğinizle ilgili bilgi için, “Ayrıca Bakınız” bölümündeki bağlantılara başvurun.

• Ayrıca, aşağıda sağlanan örnekte Visual Studio 2019, .NET Core 3.1 SDK’nın kullanıldığını unutmayın.

Merhaba Dünya Uygulaması

Bu örnekte, desteklenen tüm kaydetme formatlarında “Merhaba Dünya!” belgesi oluşturan ve kaydeden basit bir Merhaba Dünya konsol uygulaması oluşturursunuz. Uygulama ardından Docker’da derlenebilir ve çalıştırılabilir.

Konsol Uygulaması Oluşturma

Merhaba Dünya programını oluşturmak için aşağıdaki adımları izleyin:

1. Docker kurulduktan sonra varsayılan olarak Linux Konteynerları kullanıldığından emin olun. Gerekirse, Docker Desktop menüsünden Linux konteynerlerine geçiş seçeneğini seçin.
2. In Visual Studio, create a .NET Core console application.
   
   
3. 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.
   
   
4. Uygulama Linux’ta çalıştırılacağından, uygun yerel Linux varlıkları yüklü olmalıdır. .Net core sdk 3.1 taban görüntüsü ile başlayın ve libgdiplus libc6-dev’i yükleyin.
5. 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);
                       }
                   }
               }
           }
       }
   }
   

Dikkat edin, “TestOut” klasörü, çıktı belgelerini kaydetmek için bir çıkış klasörü olarak belirtilir. Docker’da uygulamayı çalıştırdığınızda, ana makinedeki bir klasör, bu klasöre konteynerde birleştirilir. Bu, Docker konteynerinde Aspose.Cells tarafından oluşturulan çıktıları kolayca görüntülemenizi sağlar.

Bir Dockerfile Yaplandırma

Bir sonraki adım, Dockerfile’ı oluşturmak ve yapılandırmaktır.

1. Dockerfile’ı oluşturun ve uygulamanızın çözüm dosyasının yanına yerleştirin. Bu dosya adını uzantısız tutun (varsayılan).
2. Dockerfile’da aşağıdakileri belirtin:

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

Yukarıdaki, aşağıdaki talimatları içeren basit bir Dockerfile’dır:

• Kullanılacak SDK görüntüsü. Burada .Net Core SDK 3.1 görüntüsüdür. Docker, derleme çalıştırıldığında bu, indirecektir. SDK’nın sürümü etiket olarak belirtilmiştir.
• Fontları yükle çünkü SDK imajı çok az font içerir. Komut, yereldeki font dosyalarını docker imajına kopyalar. Yüklemeniz gereken tüm fontları içeren yerel bir “fonts” dizininiz olduğundan emin olun. Bu örnekte, yerel “fonts” dizini, Dockerfile ile aynı dizine konulmuştur.
• Çalışma dizini, bir sonraki satırda belirtildiği gibi.
• Her şeyi konteynıra kopyalama, uygulamayı yayınlama ve giriş noktasını belirtme komutu.
• İlgili komut, System.Drawing.Common tarafından gereklidir ve libgdiplus kurulumunu çalıştırmaktadır.

Docker’da Uygulamanın Derlenmesi ve Çalıştırılması

Artık uygulama Docker’da derlenebilir ve çalıştırılabilir. Favori komut istemini açın, uygulamanın bulunduğu klasöre değiştirin (çözüm dosyası ve Dockerfile’ın yerleştirildiği klasör) ve aşağıdaki komutu çalıştırın:

docker build -t actest .

Bu komutun ilk kez çalıştırılması biraz daha uzun sürebilir, çünkü Docker’ın gereken görüntüleri indirmesi gerekir. Önceki komut tamamlandıktan sonra aşağıdaki komutu çalıştırın:

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

Dikkatlice dağınık argümanına dikkat edin, çünkü daha önce belirtildiği gibi, ana makinedeki bir klasör, uygulama çalıştırılmasının sonuçlarını kolayca görmek için konteynerin klasörüne birleştirilir. Linux’taki yollar büyük harfe duyarlıdır.

Aspose.Cells’i Destekleyen Görüntüler

• Aspose.Cells for .NET Standart Linux’ta EMF ve TIFF’i desteklemez.

Daha Fazla Örnek

1. Windows Server 2019’da uygulamayı çalıştırmak için

• 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 İmajı Oluştur

docker build -t actest .

• Docker İmajını Çalıştır

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

2. Linux’ta uygulamayı çalıştırmak için

• Bir font klasörü belirleyen basit bir program yazın, “Merhaba Dünya!” çalışma kitabını oluşturun ve kaydedin.

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 İmajı Oluştur

docker build -t actest .

• Docker İmajını Çalıştır

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

Ayrıca Bakınız

• Windows’ta Docker Desktop Kurulumu
• Mac’te Docker Desktop Kurulumu
• Visual Studio 2019, .NET Core 3.1 SDK
• Linux konteynerlerine geçiş seçeneği
• .NET Core SDK hakkında ek bilgi