كيفية تشغيل Aspose.PDF for .NET 6 في Docker

المتطلبات الأساسية

تم اختبار الأمثلة التالية مع:

• Docker v.20.10.11 و Docker Desktop 4.3.2.
• Visual Studio 2022 Community Edition v.17.0.5.
• تم استخدام .NET 6 SDK في المثال المقدم أدناه.
• Aspose.PDF for .NET v.22.01.

إنشاء تطبيق عينة لحاوية Docker لنظام Linux

1. قم بتشغيل Visual Studio 2022 واختر قالب ASP.NET Core Web App (Model-View-Controller) واضغط على التالي.
2. في نافذة تكوين مشروعك الجديد، قم بتعيين اسم المشروع والموقع المطلوبين واضغط على التالي.
3. في نافذة معلومات إضافية، اختر .NET 6.0 (دعم طويل الأمد) وقم بتمكين دعم Docker. يمكنك أيضًا تعيين نظام تشغيل Docker إلى Linux إذا لزم الأمر.
4. اضغط على إنشاء.
5. اختر الأدوات->مدير حزم Nuget->وحدة التحكم في إدارة الحزم وقم بتثبيت Aspose.PDF for .NET (استخدم الأمر Install-Package Aspose.PDF).

توليد مستند PDF باستخدام تطبيق ASP.NET Core Web في حاوية Linux

سنستخدم الكود من المثال المعقد في هذا التطبيق. يرجى اتباع هذا الرابط لمزيد من الشرح التفصيلي.

1. أنشئ مجلد images في مجلد wwwroot وضع الصورة logo.png. يمكنك تنزيل هذه الصورة من هنا.
2. استبدل الكود في HomeController.cs بالمقتطف التالي (يرجى ملاحظة أنه يمكنك أن يكون لديك مساحة اسم أخرى):

يعمل المقتطف البرمجي التالي أيضًا مع مكتبة Aspose.PDF.Drawing.

using Aspose.Pdf;
using Aspose.Pdf.Text;
using Docker.Linux.Demo01.Models;
using Microsoft.AspNetCore.Mvc;
using System.Diagnostics;

namespace Docker.Linux.Demo01.Controllers
{
    public class HomeController : Controller
    {
        private readonly ILogger<HomeController> _logger;
        private readonly IWebHostEnvironment _appEnvironment;

        public HomeController(ILogger<HomeController> logger, IWebHostEnvironment appEnvironment)
        {
            _logger = logger;
            _appEnvironment = appEnvironment;
        }

        public IActionResult Index()
        {
            return View();
        }
        
        public IActionResult Generate()
        {
            const string file_type = "application/pdf";
            const string file_name = "sample.pdf";
            var memoryStream = new MemoryStream();

            _logger.LogInformation("Start");
            // Initialize document object
            using (var document = new Aspose.Pdf.Document())
            {
                // Add page
                var page = document.Pages.Add();

                // Add image
                var imageFileName = Path.Combine(_appEnvironment.WebRootPath, "images", "logo.png");
                page.AddImage(imageFileName, new Rectangle(20, 730, 120, 830));

                // -------------------------------------------------------------
                // Add Header
                var header = new TextFragment("New ferry routes in Fall 2020");
                header.TextState.Font = FontRepository.FindFont("Arial");
                header.TextState.FontSize = 24;
                header.HorizontalAlignment = HorizontalAlignment.Center;
                header.Position = new Position(130, 720);
                page.Paragraphs.Add(header);

                // Add description
                var descriptionText = "Visitors must buy tickets online and tickets are limited to 5,000 per day. Ferry service is operating at half capacity and on a reduced schedule. Expect lineups.";
                var description = new TextFragment(descriptionText);
                description.TextState.Font = FontRepository.FindFont("Times New Roman");
                description.TextState.FontSize = 14;
                description.HorizontalAlignment = HorizontalAlignment.Left;
                page.Paragraphs.Add(description);

                // Add table
                var table = new Table
                {
                    ColumnWidths = "200",
                    Border = new BorderInfo(BorderSide.Box, 1f, Color.Black),
                    DefaultCellBorder = new BorderInfo(BorderSide.Box, 0.5f, Color.Gray),
                    DefaultCellPadding = new MarginInfo(4.5, 4.5, 4.5, 4.5),
                    Margin =
                    {
                        Top = 10,
                        Bottom = 10
                    },
                    DefaultCellTextState =
                    {
                        Font =  FontRepository.FindFont("Helvetica")
                    }
                };

                var headerRow = table.Rows.Add();
                headerRow.Cells.Add("Departs City");
                headerRow.Cells.Add("Departs Island");
                foreach (Cell headerRowCell in headerRow.Cells)
                {
                    headerRowCell.BackgroundColor = Color.LightGray;
                    headerRowCell.DefaultCellTextState.ForegroundColor = Color.FromRgb(0.1, 0.1, 0.1);
                }

                var time = new TimeSpan(6, 0, 0);
                var incTime = new TimeSpan(0, 30, 0);
                for (int i = 0; i < 10; i++)
                {
                    var dataRow = table.Rows.Add();
                    dataRow.Cells.Add(time.ToString(@"hh\:mm"));
                    time = time.Add(incTime);
                    dataRow.Cells.Add(time.ToString(@"hh\:mm"));
                }

                page.Paragraphs.Add(table);

                document.Save(memoryStream);
            }
            _logger.LogInformation("Finish");
            return File(memoryStream, file_type, file_name);
        }

        public IActionResult Privacy()
        {
            return View();
        }

        [ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)]
        public IActionResult Error()
        {
            return View(new ErrorViewModel { RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier });
        }
    }
}

1. استبدل المحتوى في Dockerfile بالمحتوى التالي:

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
RUN apt-get update && apt-get install -y libgdiplus
RUN sed -i'.bak' 's/$/ contrib/' /etc/apt/sources.list
RUN apt-get update; apt-get install -y ttf-mscorefonts-installer fontconfig

WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["Docker.Linux.Demo01/Docker.Linux.Demo01.csproj", "Docker.Linux.Demo01/"]
RUN dotnet restore "Docker.Linux.Demo01/Docker.Linux.Demo01.csproj"
COPY . .
WORKDIR "/src/Docker.Linux.Demo01"
RUN dotnet build "Docker.Linux.Demo01.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "Docker.Linux.Demo01.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "Docker.Linux.Demo01.dll"]

إنشاء تطبيق عينة لحاوية Docker لنظام Windows

1. قم بتشغيل Visual Studio 2022 واختر قالب ASP.NET Core Web App (Model-View-Controller) واضغط على التالي.
2. في نافذة تكوين مشروعك الجديد، قم بتعيين اسم المشروع والموقع المطلوبين واضغط على التالي.
3. في نافذة معلومات إضافية، اختر .NET 6.0 (دعم طويل الأمد) وقم بتمكين دعم Docker. إذا لزم الأمر، يمكنك أيضًا تعيين نظام تشغيل Docker إلى Windows.
4. اضغط على إنشاء.
5. اختر الأدوات->مدير حزم Nuget->وحدة التحكم في إدارة الحزم وقم بتثبيت Aspose.PDF for .NET (استخدم الأمر Install-Package Aspose.PDF).

توليد مستند PDF باستخدام تطبيق ASP.NET Core Web في حاوية Windows

سنستخدم نفس الكود كما في المثال السابق.

1. أنشئ مجلد images في مجلد wwwroot وضع الصورة logo.png. يمكنك تنزيل هذه الصورة من هنا.
2. استبدل الكود في HomeController.cs بالمقتطف أعلاه.

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/sdk:6.0.101-nanoserver-ltsc2022 AS build
WORKDIR /src
COPY ["Docker.Windows.Demo01/Docker.Windows.Demo01.csproj", "Docker.Windows.Demo01/"]
RUN dotnet restore "Docker.Windows.Demo01/Docker.Windows.Demo01.csproj"
COPY . .
WORKDIR "/src/Docker.Windows.Demo01"
RUN dotnet build "Docker.Windows.Demo01.csproj" -c Release -o /app/build -r win-x64 --self-contained true

FROM build AS publish
RUN dotnet publish "Docker.Windows.Demo01.csproj" -c Release -o /app/publish -r win-x64 --self-contained true

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "Docker.Windows.Demo01.dll"]