1030626: Created a “Getting Started” Sample Project for Docker

Getting Started/Docker/Create-PDF-using-Docker/.dockerignore

@@ -0,0 +1,30 @@
+**/.classpath
+**/.dockerignore
+**/.env
+**/.git
+**/.gitignore
+**/.project
+**/.settings
+**/.toolstarget
+**/.vs
+**/.vscode
+**/*.*proj.user
+**/*.dbmdl
+**/*.jfm
+**/azds.yaml
+**/bin
+**/charts
+**/docker-compose*
+**/Dockerfile*
+**/node_modules
+**/npm-debug.log
+**/obj
+**/secrets.dev.yaml
+**/values.dev.yaml
+LICENSE
+README.md
+!**/.gitignore
+!.git/HEAD
+!.git/config
+!.git/packed-refs
+!.git/refs/heads/**

Getting Started/Docker/Create-PDF-using-Docker/Create-PDF-using-Docker.slnx

@@ -0,0 +1,3 @@
+<Solution>
+  <Project Path="Create-PDF-using-Docker/Create-PDF-using-Docker.csproj" />
+</Solution>

Getting Started/Docker/Create-PDF-using-Docker/Create-PDF-using-Docker/Controllers/HomeController.cs

@@ -0,0 +1,110 @@
+using Create_PDF_using_Docker.Models;
+using Microsoft.AspNetCore.Mvc;
+using Syncfusion.Drawing;
+using Syncfusion.Pdf;
+using Syncfusion.Pdf.Graphics;
+using Syncfusion.Pdf.Grid;
+using System.Diagnostics;
+
+namespace Create_PDF_using_Docker.Controllers
+{
+    public class HomeController : Controller
+    {
+        private readonly ILogger<HomeController> _logger;
+
+        public HomeController(ILogger<HomeController> logger)
+        {
+            _logger = logger;
+        }
+
+        public IActionResult Index()
+        {
+            return View();
+        }
+
+        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 });
+        }
+
+        public ActionResult CreatePDF()
+        {
+            List<WeatherForecastPdfRow> forecasts = GetForecasts();
+
+            // Create a new PDF document.
+            using (PdfDocument pdfDocument = new PdfDocument())
+            {
+                int paragraphAfterSpacing = 8;
+                int cellMargin = 8;
+
+                // Add page to the PDF document.
+                PdfPage page = pdfDocument.Pages.Add();
+                // Create title and description.
+                PdfStandardFont font = new PdfStandardFont(PdfFontFamily.TimesRoman, 16);
+                PdfTextElement title = new PdfTextElement("Weather Forecast", font, PdfBrushes.Black);
+                PdfLayoutResult result = title.Draw(page, new PointF(0, 0));
+
+                PdfStandardFont contentFont = new PdfStandardFont(PdfFontFamily.TimesRoman, 12);
+                PdfTextElement content = new PdfTextElement(
+                    "This component demonstrates fetching data from a service and exporting the data to a PDF document using Syncfusion .NET PDF library.",
+                    contentFont,
+                    PdfBrushes.Black);
+                PdfLayoutFormat format = new PdfLayoutFormat
+                {
+                    Layout = PdfLayoutType.Paginate
+                };
+                result = content.Draw(
+                    page,
+                    new RectangleF(0, result.Bounds.Bottom + paragraphAfterSpacing, page.GetClientSize().Width, page.GetClientSize().Height),
+                    format);
+                // Create and style the PDF grid.
+                PdfGrid pdfGrid = new PdfGrid();
+                pdfGrid.Style.CellPadding.Left = cellMargin;
+                pdfGrid.Style.CellPadding.Right = cellMargin;
+                pdfGrid.ApplyBuiltinStyle(PdfGridBuiltinStyle.GridTable4Accent1);
+                // Assign data source.
+                pdfGrid.DataSource = forecasts;
+                pdfGrid.Style.Font = contentFont;
+                // Draw PDF grid into the PDF page.
+                pdfGrid.Draw(page, new PointF(0, result.Bounds.Bottom + paragraphAfterSpacing));
+                using (MemoryStream stream = new MemoryStream())
+                {
+                    // Save the PDF document into the stream.
+                    pdfDocument.Save(stream);
+                    pdfDocument.Close(true);
+
+                    return File(stream.ToArray(), "application/pdf", "Output.pdf");
+                }
+            }
+        }
+
+        private static List<WeatherForecastPdfRow> GetForecasts()
+        {
+            string[] summaries = ["Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"];
+
+            return Enumerable.Range(1, 5)
+                .Select(index => new WeatherForecastPdfRow
+                {
+                    Date = DateTime.UtcNow.AddDays(index).ToString("yyyy-MM-dd"),
+                    TemperatureC = Random.Shared.Next(-20, 55),
+                    Summary = summaries[Random.Shared.Next(summaries.Length)]
+                })
+                .ToList();
+        }
+
+        private sealed class WeatherForecastPdfRow
+        {
+            public string Date { get; set; } = string.Empty;
+
+            public int TemperatureC { get; set; }
+
+            public string Summary { get; set; } = string.Empty;
+        }
+    }
+}

Getting Started/Docker/Create-PDF-using-Docker/Create-PDF-using-Docker/Create-PDF-using-Docker.csproj

@@ -0,0 +1,17 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <RootNamespace>Create_PDF_using_Docker</RootNamespace>
+    <UserSecretsId>b58f638d-e820-4bbb-ba08-e6bbaba9c1be</UserSecretsId>
+    <DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.VisualStudio.Azure.Containers.Tools.Targets" Version="1.23.0" />
+    <PackageReference Include="Syncfusion.Pdf.Net.Core" Version="*" />
+  </ItemGroup>
+
+</Project>

Getting Started/Docker/Create-PDF-using-Docker/Create-PDF-using-Docker/Create-PDF-using-Docker.csproj.user

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project ToolsVersion="Current" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <PropertyGroup>
+    <ActiveDebugProfile>Container (Dockerfile)</ActiveDebugProfile>
+  </PropertyGroup>
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'">
+    <DebuggerFlavor>ProjectDebugger</DebuggerFlavor>
+  </PropertyGroup>
+</Project>

Getting Started/Docker/Create-PDF-using-Docker/Create-PDF-using-Docker/Dockerfile

@@ -0,0 +1,34 @@
+# See https://aka.ms/customizecontainer to learn how to customize your debug container and how Visual Studio uses this Dockerfile to build your images for faster debugging.
+
+# This stage is used when running from VS in fast mode (Default for Debug configuration)
+FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
+RUN apt-get update && \
+apt-get install -yq --no-install-recommends \
+libgdiplus && \
+rm -rf /var/lib/apt/lists/*
+USER $APP_UID
+WORKDIR /app
+EXPOSE 8080
+EXPOSE 8081
+
+
+# This stage is used to build the service project
+FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
+ARG BUILD_CONFIGURATION=Release
+WORKDIR /src
+COPY ["Create-PDF-using-Docker/Create-PDF-using-Docker.csproj", "Create-PDF-using-Docker/"]
+RUN dotnet restore "./Create-PDF-using-Docker/Create-PDF-using-Docker.csproj"
+COPY . .
+WORKDIR "/src/Create-PDF-using-Docker"
+RUN dotnet build "./Create-PDF-using-Docker.csproj" -c $BUILD_CONFIGURATION -o /app/build
+
+# This stage is used to publish the service project to be copied to the final stage
+FROM build AS publish
+ARG BUILD_CONFIGURATION=Release
+RUN dotnet publish "./Create-PDF-using-Docker.csproj" -c $BUILD_CONFIGURATION -o /app/publish /p:UseAppHost=false
+
+# This stage is used in production or when running from VS in regular mode (Default when not using the Debug configuration)
+FROM base AS final
+WORKDIR /app
+COPY --from=publish /app/publish .
+ENTRYPOINT ["dotnet", "Create-PDF-using-Docker.dll"]

Getting Started/Docker/Create-PDF-using-Docker/Create-PDF-using-Docker/Models/ErrorViewModel.cs

@@ -0,0 +1,9 @@
+namespace Create_PDF_using_Docker.Models
+{
+    public class ErrorViewModel
+    {
+        public string? RequestId { get; set; }
+
+        public bool ShowRequestId => !string.IsNullOrEmpty(RequestId);
+    }
+}

Getting Started/Docker/Create-PDF-using-Docker/Create-PDF-using-Docker/Program.cs

@@ -0,0 +1,27 @@
+var builder = WebApplication.CreateBuilder(args);
+
+// Add services to the container.
+builder.Services.AddControllersWithViews();
+
+var app = builder.Build();
+
+// Configure the HTTP request pipeline.
+if (!app.Environment.IsDevelopment())
+{
+    app.UseExceptionHandler("/Home/Error");
+    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
+    app.UseHsts();
+}
+
+app.UseHttpsRedirection();
+app.UseStaticFiles();
+
+app.UseRouting();
+
+app.UseAuthorization();
+
+app.MapControllerRoute(
+    name: "default",
+    pattern: "{controller=Home}/{action=Index}/{id?}");
+
+app.Run();

Getting Started/Docker/Create-PDF-using-Docker/Create-PDF-using-Docker/Properties/launchSettings.json

@@ -0,0 +1,49 @@
+{
+  "profiles": {
+    "http": {
+      "commandName": "Project",
+      "launchBrowser": true,
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      },
+      "dotnetRunMessages": true,
+      "applicationUrl": "http://localhost:5185"
+    },
+    "https": {
+      "commandName": "Project",
+      "launchBrowser": true,
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      },
+      "dotnetRunMessages": true,
+      "applicationUrl": "https://localhost:7229;http://localhost:5185"
+    },
+    "IIS Express": {
+      "commandName": "IISExpress",
+      "launchBrowser": true,
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    },
+    "Container (Dockerfile)": {
+      "commandName": "Docker",
+      "launchBrowser": true,
+      "launchUrl": "{Scheme}://{ServiceHost}:{ServicePort}",
+      "environmentVariables": {
+        "ASPNETCORE_HTTPS_PORTS": "8081",
+        "ASPNETCORE_HTTP_PORTS": "8080"
+      },
+      "publishAllPorts": true,
+      "useSSL": true
+    }
+  },
+  "$schema": "http://json.schemastore.org/launchsettings.json",
+  "iisSettings": {
+    "windowsAuthentication": false,
+    "anonymousAuthentication": true,
+    "iisExpress": {
+      "applicationUrl": "http://localhost:62434",
+      "sslPort": 44329
+    }
+  }
+}

Getting Started/Docker/Create-PDF-using-Docker/Create-PDF-using-Docker/Views/Home/Index.cshtml

@@ -0,0 +1,18 @@
+@{
+    ViewData["Title"] = "Home Page";
+}
+
+<div class="text-center">
+    <h1 class="display-4">Welcome</h1>
+    <p>Learn about <a href="https://learn.microsoft.com/aspnet/core">building Web apps with ASP.NET Core</a>.</p>
+</div>
+
+@{
+    Html.BeginForm("CreatePDF", "Home", FormMethod.Get);
+    {
+        <div>
+            <input type="submit" value="Create PDF document" style="width:200px;height:27px" />
+        </div>
+    }
+    Html.EndForm();
+}

Getting Started/Docker/Create-PDF-using-Docker/Create-PDF-using-Docker/Views/Home/Privacy.cshtml

@@ -0,0 +1,6 @@
+@{
+    ViewData["Title"] = "Privacy Policy";
+}
+<h1>@ViewData["Title"]</h1>
+
+<p>Use this page to detail your site's privacy policy.</p>

Getting Started/Docker/Create-PDF-using-Docker/Create-PDF-using-Docker/Views/Shared/Error.cshtml

@@ -0,0 +1,25 @@
+@model ErrorViewModel
+@{
+    ViewData["Title"] = "Error";
+}
+
+<h1 class="text-danger">Error.</h1>
+<h2 class="text-danger">An error occurred while processing your request.</h2>
+
+@if (Model.ShowRequestId)
+{
+    <p>
+        <strong>Request ID:</strong> <code>@Model.RequestId</code>
+    </p>
+}
+
+<h3>Development Mode</h3>
+<p>
+    Swapping to <strong>Development</strong> environment will display more detailed information about the error that occurred.
+</p>
+<p>
+    <strong>The Development environment shouldn't be enabled for deployed applications.</strong>
+    It can result in displaying sensitive information from exceptions to end users.
+    For local debugging, enable the <strong>Development</strong> environment by setting the <strong>ASPNETCORE_ENVIRONMENT</strong> environment variable to <strong>Development</strong>
+    and restarting the app.
+</p>