Как запустить Aspose.HTML for .NET в Docker

Docker Container

Docker – популярная платформа с открытым исходным кодом, позволяющая автоматизировать развертывание и управление приложениями внутри контейнеров. Контейнеры имеют множество функций и преимуществ, предоставляя облегченную и изолированную среду для запуска приложений и позволяя им согласованно работать в разных операционных системах и инфраструктурах.

Контейнер похож на виртуальную машину. Его можно установить, удалить, остановить, возобновить или подключить к терминалу. Итак, docker container – это легкий автономный исполняемый программный пакет, который включает в себя все необходимое для запуска приложения: код, среду выполнения, системные инструменты, системные библиотеки и настройки.

В этой статье мы рассмотрим, как контейнеризовать приложение .NET с помощью docker и интегрировать функциональность Aspose.HTML в ваш проект. Здесь вы найдете пошаговые инструкции о том, как запустить Aspose.HTML в docker – как создать консольное приложение и настроить Dockerfile.

Системные Требования

Прежде чем вы сможете запустить Aspose.HTML в docker, в вашей системе должен быть установлен docker. Чтобы успешно установить Docker Desktop, вы должны убедиться, что ваша система соответствует минимальным требованиям для установки Docker. Для получения информации о том, как установить Docker на Windows, Mac или Linux, перейдите по ссылкам:

• Установить Docker Desktop в Windows
• Установить Docker Desktop на Mac
• Установить Docker Desktop в Linux

Как создать консольное приложение с поддержкой Docker

Рассмотрим пример: мы создаем простое Консольное приложение ConsoleApp, которое преобразует документ HTML (document.html) и сохраняет его в формате TIFF. Это приложение вы можете собрать и запустить в docker. Чтобы создать проект консольного приложения, выполните несколько шагов:

1. Откройте Visual Studio (в примере используется Visual Studio 2022) и на этапе «Создать новый проект» выберите «Консольное приложение C#».

2. Директорию и параметры для проекта консольного приложения оставьте по умолчанию (как в примере) или укажите свои:

3. Выберите .NET 6.0 (долгосрочная поддержка) в меню Framework.

4. Добавьте в проект поддержку docker и выберите целевую ОС Linux.

После добавления поддержки Docker создается файл Dockerfile с содержимым по умолчанию.

Как настроить Dockerfile

Правильно настроив Dockerfile, вы можете определить шаги для создания образа docker и создать контейнерную среду, включающую все необходимые зависимости и конфигурации для запуска вашего приложения.

1. Вот содержимое Dockerfile по умолчанию:

#See https://aka.ms/containerfastmode to understand how Visual Studio uses this Dockerfile to build your images for faster debugging.

FROM mcr.microsoft.com/dotnet/runtime:6.0 AS base
WORKDIR /app

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

FROM build AS publish
RUN dotnet publish "ConsoleApp.csproj" -c Release -o /app/publish

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

2. Вам необходимо отредактировать Dockerfile, установить необходимые шрифты и настроить поддержку глобализации UTF-8.

# 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.

# ---------- Base runtime stage ----------
# .NET runtime + font and globalization support
FROM mcr.microsoft.com/dotnet/runtime:6.0 AS base
WORKDIR /app

# Install fonts, fontconfig, locale support, and CA certificates
RUN apt-get update && apt-get install -y --no-install-recommends \
        libc6-dev \
        libgdiplus \
        fontconfig \
        fonts-dejavu-core \
        fonts-dejavu-extra \
        fonts-liberation \
        fonts-freefont-ttf \
        locales \
        ca-certificates \
    && rm -rf /var/lib/apt/lists/*

# Enable and generate UTF-8 locale
RUN sed -i 's/# \(en_US.UTF-8 UTF-8\)/\1/' /etc/locale.gen \
    && locale-gen

# Configure globalization
ENV LANG=en_US.UTF-8 \
    LANGUAGE=en_US:en \
    LC_ALL=en_US.UTF-8 \
    DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=false

# Build font cache (useful for predictable font discovery)
RUN fc-cache -f -v

# ---------- Build stage ----------
# Restore and build the application
FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["ConsoleApp/ConsoleApp.csproj", "ConsoleApp/"]
RUN dotnet restore "ConsoleApp/ConsoleApp.csproj"
COPY . .
WORKDIR "/src/ConsoleApp"
RUN dotnet build "ConsoleApp.csproj" -c Release -o /app/build

# ---------- Publish stage ----------
FROM build AS publish
RUN dotnet publish "ConsoleApp.csproj" -c Release -o /app/publish /p:UseAppHost=false

# ---------- Final runtime stage ----------
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "ConsoleApp.dll"]

Dockerfile – это текстовый файл, содержащий набор инструкций, используемых для создания образа Docker. Его можно разделить на четыре отдельных блока: base runtime stage, build stage, publish stage и final runtime stage. Давайте рассмотрим команды в Dockerfile и их значения:

1. base runtime stage определяет базовый образ и устанавливает необходимые зависимости, необходимые для обработки изображений и шрифтов в контейнере.

• Для ключевого слова FROM требуется полное имя образа контейнера Docker. В первой строке указывается базовый образ mcr.microsoft.com/dotnet/runtime:6.0. Этот базовый образ обеспечивает среду выполнения для приложений .NET.
• Команда WORKDIR устанавливает рабочий каталог внутри docker в /app.
• Команды RUN обновляют списки пакетов, устанавливают собственные зависимости среды выполнения (libc6-dev, libgdiplus), fontconfig и пакеты шрифтов с открытым исходным кодом, поддержку локали и сертификаты CA, настраивают параметры глобализации UTF-8 для .NET, перестраивают кэш шрифтов и очищают кэш пакетов для минимизации размера образа.

2. build stage содержит инструкции, используемые для сборки приложений .NET.

• Команда FROM указывает базовый образ mcr.microsoft.com/dotnet/sdk:6.0. Сегмент dotnet – это репозиторий контейнера, тогда как сегмент sdk – это имя образа контейнера Docker. Образ включает пакет SDK для .NET 6.0, позволяющий создавать приложения .NET.
• Инструкция WORKDIR устанавливает рабочий каталог внутри контейнера в /src.
• Команда COPY копирует файл проекта ConsoleApp.csproj из локального каталога ConsoleApp/ в каталог контейнера /src/ConsoleApp/.
• Команда RUN выполняет dotnet restore для восстановления пакетов NuGet для проекта. – Команда COPY указывает docker скопировать указанную папку на вашем компьютере в папку в контейнере докера – /scr/.
• Команда RUN dotnet build "ConsoleApp.csproj" -c Release -o /app/build компилирует приложение .NET, указанное в ConsoleApp.csproj, используя конфигурацию Release, и сохраняет выходные данные сборки в /app/build внутри контейнера.

3. publish stage объявляет приложение для развертывания.

• Строка FROM build AS publish устанавливает новую стадию образа docker с именем publish на основе предыдущей стадии build. Это указывает на то, что этап publish унаследует все файлы, зависимости и конфигурации от этапа build.
• Команда RUN выполняет dotnet publish, чтобы опубликовать приложение в конфигурации Release, с выходным каталогом, заданным как /app/publish.

4. final runtime stage запускает приложение при старте контейнера докера.

• Инструкция FROM использует base стадию в качестве базового образа.
• Команда WORKDIR изменяет текущий каталог внутри контейнера на /app.
• Команда COPY указывает docker скопировать опубликованные файлы из этапа publish в текущий каталог на final этапе.
• Команда ENTRYPOINT используется для запуска исполняемого файла, которым является ConsoleApp.dll.

Эти четыре блока в Dockerfile работают вместе для создания многоэтапного образа Docker. Начальные base и build этапы используются для установки зависимостей, восстановления пакетов и сборки приложения. Следующие publish и final блоки используются для публикации приложения для развертывания и запуска при старте контейнера.

Пример консольного приложения

В примере мы предлагаем использовать простую программу, которая конвертирует HTML-документ в формат изображения TIFF:

using Aspose.Html;
using Aspose.Html.Rendering.Image;

namespace ConsoleApp
{
    internal class Program
    {
        static void Main(string[] args)
        {
            using var doc = new HTMLDocument("document.html");
            using var dev = new ImageDevice(new ImageRenderingOptions(ImageFormat.Tiff), "result.tiff");
            doc.RenderTo(dev);
        }
    }
}

Настройте консольное приложение и запустите Aspose.HTML в Docker

1. Чтобы запустить Aspose.HTML в docker, установите последнюю версию Aspose.HTML и System.Drawing.Common 6.0 из NuGet.

2. Отредактируйте проект ConsoleApp.csproj – добавьте параметр InvariantGlobalization = false:

Следующий файл представляет собой файл проекта .NET. Он определяет параметры проекта, зависимости и дополнительные файлы, необходимые для создания исполняемого приложения. <InvariantGlobalization> – это дополнительный элемент, отключающий инвариантное поведение глобализации в проекте. Если установлено значение false, проект будет использовать поведение глобализации по умолчанию.

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net6.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Aspose.HTML" Version="23.5.0" />
    <PackageReference Include="Microsoft.VisualStudio.Azure.Containers.Tools.Targets" Version="1.14.0" />
    <PackageReference Include="System.Drawing.Common" Version="6.0.0" />
  </ItemGroup>

  <ItemGroup>
    <None Update="document.html">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
  </ItemGroup>

  <ItemGroup>
    <RuntimeHostConfigurationOption Include="System.Drawing.EnableUnixSupport" Value="true" />
  </ItemGroup>

  <PropertyGroup>
	  <InvariantGlobalization>false</InvariantGlobalization>
  </PropertyGroup>

</Project>

3. Установите для конвертируемого файла свойство «Копировать в выходной каталог»:

4. Запустите преобразование HTML в TIFF для Linux в докер-контейнере, нажав зеленую кнопку.

Помощь и поддержка

Если вам нужна помощь или у вас есть вопросы по запуску Aspose.HTML в docker, обратитесь на Форум бесплатной поддержки или воспользуйтесь Бесплатной консультацией. Мы будем рады вам помочь!

Смотрите также

• Information on .NET Core SDK
• Tutorial: Containerize a .NET app
• Docker Desktop