Конвертация документов с помощью Microsoft Azure App Service

Эта статья предоставляет подробные пошаговые инструкции по конвертации PDF-документов в Microsoft Azure с использованием Aspose.PDF for .NET и Azure App Service.

Предварительные требования

Visual Studio 2022 Community Edition с установленной разработкой для Azure или Visual Studio Code.
Учетная запись Azure: вам нужна подписка Azure, создайте бесплатную учетную запись перед началом.
.NET 6 SDK.
Aspose.PDF for .NET.

Создание ресурсов Azure

Создание App Service

Перейдите в Azure Portal (https://portal.azure.com).
Создайте новую группу ресурсов.
Создайте новый App Service:
- Выберите среду выполнения .NET 6 (LTS).
- Выберите соответствующий уровень цен.
Создайте ресурс Application Insights для ведения журналов.

Создание проекта

Создание проекта в Visual Studio

Откройте Visual Studio 2022.
Нажмите “Создать новый проект”.
Выберите “ASP.NET Core Web API”.
Назовите ваш проект “PdfConversionService”.
Выберите “.NET 6.0” или более позднюю версию.
Нажмите “Создать”.

Создание проекта в Visual Studio Code

Установка предварительных требований

Расширения Visual Code:

code --install-extension ms-dotnettools.csharp
code --install-extension ms-azuretools.vscode-azureappservice

Установите Azure CLI:

Windows: загрузите с сайта Microsoft.
macOS: brew install azure-cli.
Linux: curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash.

Настройка проекта

Откройте проект в Visual Studio Code:

code .

Добавьте пакеты NuGet, создав/обновив PdfConverterApp.csproj:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Aspose.PDF" Version="24.10.0" />
    <PackageReference Include="Microsoft.ApplicationInsights.AspNetCore" Version="2.22.0" />
    <PackageReference Include="Microsoft.Extensions.Logging.AzureAppServices" Version="8.0.10" />
  </ItemGroup>
</Project>

Добавьте конфигурацию:

// .vscode/launch.json
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": ".NET Core Launch (web)",
            "type": "coreclr",
            "request": "launch",
            "preLaunchTask": "build",
            "program": "${workspaceFolder}/bin/Debug/net6.0/PdfConversionService.dll",
            "args": [],
            "cwd": "${workspaceFolder}",
            "stopAtEntry": false,
            "env": {
                "ASPNETCORE_ENVIRONMENT": "Development"
            }
        }
    ]
}

Создайте структуру проекта:

mkdir Controllers
touch Controllers/PdfController.cs

Установка необходимых пакетов NuGet

В Visual Studio откройте консоль диспетчера пакетов и выполните:

Install-Package Aspose.PDF
Install-Package Microsoft.ApplicationInsights.AspNetCore
Install-Package Microsoft.Extensions.Logging.AzureAppServices

В Visual Studio Code выполните:

dotnet restore

Настройка лицензии Aspose

В Visual Studio:

Скопируйте файл лицензии Aspose.PDF в проект.
Щелкните правой кнопкой мыши на файле лицензии и выберите “Свойства”.
Установите “Копировать в выходной каталог” на “Копировать всегда”.
Добавьте код инициализации лицензии в Program.cs:

var license = new Aspose.Pdf.License();
license.SetLicense("Aspose.PDF.lic");

Создание кода

В Visual Studio:

Щелкните правой кнопкой мыши на папке Controllers.
Добавить → Новый элемент → API Controller - Пустой.
Назовите ваш файл “PdfController.cs”.

// PdfController.cs
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/[controller]")]
public class PdfController : ControllerBase
{
    private readonly ILogger<PdfController> _logger;

    public PdfController(ILogger<PdfController> logger)
    {
        _logger = logger;
    }

    [HttpPost("convert")]
    public async Task<IActionResult> ConvertPdf(
        IFormFile file,
        [FromQuery] string outputFormat = "docx")
    {
        try
        {
            if (file == null || file.Length == 0)
            {
                return BadRequest("No file uploaded");
            }

            // Validate input file is PDF
            if (!file.ContentType.Equals("application/pdf", StringComparison.OrdinalIgnoreCase))
            {
                return BadRequest("File must be a PDF");
            }

            using var inputStream = file.OpenReadStream();
            using var document = new Aspose.Pdf.Document(inputStream);
            using var outputStream = new MemoryStream();

            switch (outputFormat.ToLower())
            {
                case "docx":
                    document.Save(outputStream, Aspose.Pdf.SaveFormat.DocX);
                    return File(outputStream.ToArray(),
                        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
                        "converted.docx");

                case "html":
                    document.Save(outputStream, Aspose.Pdf.SaveFormat.Html);
                    return File(outputStream.ToArray(),
                        "text/html",
                        "converted.html");

                case "jpg":
                case "jpeg":
                    var jpegDevice = new Aspose.Pdf.Devices.JpegDevice();
                    jpegDevice.Process(document.Pages[1], outputStream);
                    return File(outputStream.ToArray(),
                        "image/jpeg",
                        "converted.jpg");

                case "png":
                    var pngDevice = new Aspose.Pdf.Devices.PngDevice();
                    pngDevice.Process(document.Pages[1], outputStream);
                    return File(outputStream.ToArray(),
                        "image/png",
                        "converted.png");

                default:
                    return BadRequest("Unsupported output format");
            }
        }
        catch (Exception ex)
        {
            _logger.LogError(ex, "Error converting PDF");
            return StatusCode(500, "Internal server error");
        }
    }
}

// Program.cs
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers();
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

// Add logging
builder.Services.AddApplicationInsightsTelemetry();
builder.Services.AddLogging(logging =>
{
    logging.AddConsole();
    logging.AddDebug();
    logging.AddAzureWebAppDiagnostics();
});

var app = builder.Build();

// Initialize license
var license = new Aspose.Pdf.License();
license.SetLicense("Aspose.PDF.lic");

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();
app.Run();

Настройка параметров приложения

Откройте appsettings.json.
Добавьте конфигурацию:

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "ApplicationInsights": {
    "ConnectionString": "Your-Connection-String"
  }
}

Замените Your-Connection-StringG на вашу фактическую строку подключения из Azure Portal.

Тестирование локально

В Visual Studio:

Нажмите F5, чтобы запустить приложение.
Откроется Swagger UI.
Протестируйте конечную точку /api/pdf/convert:
- Нажмите “Попробовать”.
- Загрузите PDF-файл.
- Выберите формат вывода.
- Выполните и проверьте конвертацию.

В Visual Studio Code:

dotnet run

curl -X POST "https://localhost:5001/api/pdf/convert?outputFormat=docx" \
     -F "file=@sample.pdf" \
     -o converted.docx

Развертывание в Azure

В Visual Studio:

Щелкните правой кнопкой мыши на проекте.
Выберите “Опубликовать”.
Выберите “Azure” в качестве цели.
Выберите “Azure App Service (Windows)”.
Выберите вашу подписку и App Service.
Нажмите “Опубликовать”.

В Visual Studio Code:

dotnet publish -c Release

az webapp deployment source config-zip \
    --resource-group $resourceGroup \
    --name $appName \
    --src bin/Release/net6.0/publish.zip

az webapp deploy \
    --resource-group $resourceGroup \
    --name $appName \
    --src-path "Aspose.PDF.lic" \
    --target-path "site/wwwroot/Aspose.PDF.lic"

Настройка Azure App Service

Перейдите в Azure Portal.
Откройте ваш App Service.

Настройте параметры:

App Settings:
- WEBSITE_RUN_FROM_PACKAGE=1
- ASPNETCORE_ENVIRONMENT=Production

Тестирование развернутого сервиса

Используйте Postman или curl для тестирования:

curl -X POST "https://your-app.azurewebsites.net/api/pdf/convert?outputFormat=docx" \
     -F "file=@sample.pdf" \
     -o converted.docx

Поддерживаемые форматы

Список поддерживаемых форматов можно найти здесь.

Устранение неполадок

Важные параметры конфигурации

Ограничения по размеру файла Добавьте в web.config:

<configuration>
  <system.webServer>
    <security>
      <requestFiltering>
        <requestLimits maxAllowedContentLength="104857600" />
      </requestFiltering>
    </security>
  </system.webServer>
</configuration>

CORS (если необходимо) В Program.cs:

builder.Services.AddCors(options =>
{
    options.AddPolicy("AllowSpecificOrigin",
        builder => builder
            .WithOrigins("https://your-frontend-domain.com")
            .AllowAnyMethod()
            .AllowAnyHeader());
});

Аутентификация (если необходимо)

builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
    .AddJwtBearer(options => {
        // Configure JWT options
    });

Конвертация документов с помощью функции Microsoft Azure