Ocelot .NET (개발자에게 어떻게 작동하는가)

라우팅

Ocelot의 기능의 핵심은 라우팅 기능입니다. Ocelot은 개발자가 지정한 구성에 따라 들어오는 요청을 적절한 서비스 라우트에 연결하며, 서비스 검색 메커니즘과 통합할 수 있습니다. 이는 와일드카드 라우팅 지원을 포함하며, 이는 다양한 API 버전이나 다수의 서비스 엔드포인트를 처리할 때 특히 유용합니다.

미들웨어 / 위임 핸들러

Ocelot은 개발자가 클라이언트 또는 서비스에 도달하기 전에 요청과 응답을 처리할 수 있는 맞춤형 미들웨어 또는 핸들러를 주입할 수 있도록 합니다. 이는 헤더 추가, 요청 로깅, 또는 응답 구조 수정 등 필요한 대로 유용합니다.

로드 밸런싱

Ocelot은 상자 없이 여러 로드 밸런싱 전략을 지원하며, Round Robin, Least Connection, 미리 정의된 전략 중 요구 사항에 맞지 않는 경우 사용자 정의 제공자를 사용할 수 있습니다. 이 기능은 이용 가능한 서비스 간에 부하를 고르게 분배하여 애플리케이션의 전체적인 회복력과 효율성을 향상시킵니다.

인증 및 권한 부여

API 엔드포인트 보안은 매우 중요하며, Ocelot은 Identity Server와 같은 기존 인증 제공자와의 통합을 지원합니다. JWT 및 OAuth2를 포함한 인기 있는 인증 체계를 지원하며, 사용자 서비스 접근에 대해 세밀한 제어를 허용합니다.

속도 제한 및 QoS

속도 제한은 사용자가 지정된 기간 내에 요청할 수 있는 요청 수를 제한하여 남용을 방지하고 공정한 서비스를 보장하는 데 필수적입니다. QoS(품질 서비스) 옵션으로 타임아웃 및 재시도 설정이 가능하며, 이를 통해 다양한 네트워크 조건 및 부하에서 서비스가 가용하고 응답이 가능하도록 보장합니다.

1단계: .NET Core 웹 애플리케이션 설정

먼저 새로운 .NET Core 웹 API 프로젝트를 만듭니다. .NET CLI 또는 Visual Studio를 사용할 수 있습니다.

.NET CLI 사용:

dotnet new webapi -n OcelotWithIronPDF
cd OcelotWithIronPDF

dotnet new webapi -n OcelotWithIronPDF
cd OcelotWithIronPDF

2단계: 필수 패키지 추가

Ocelot과 IronPDF를 설치해야 합니다. NuGet을 통해 이러한 패키지를 추가할 수 있습니다.

dotnet add package Ocelot
dotnet add package IronPdf

dotnet add package Ocelot
dotnet add package IronPdf

3단계: Ocelot 구성

Ocelot의 라우팅을 구성하기 위해 프로젝트의 루트에 ocelot.json 파일을 추가하십시오. 이 설정은 Ocelot이 PDF 생성 요청을 같은 애플리케이션 내에서 IronPDF가 처리할 특정 경로로 라우팅하도록 가정합니다.

{
    "ReRoutes": [
        {
            "DownstreamPathTemplate": "/api/pdf",
            "DownstreamScheme": "https",
            "DownstreamHostAndPorts": [
                {
                    "Host": "localhost",
                    "Port": 5001
                }
            ],
            "UpstreamPathTemplate": "/generatepdf",
            "UpstreamHttpMethod": ["Post"]
        }
    ],
    "GlobalConfiguration": {
        "BaseUrl": "http://localhost:5000"
    }
}

4단계: Startup.cs 구성

Ocelot의 미들웨어를 포함하도록 Startup.cs를 업데이트하십시오. IronPDF가 로컬 파일 시스템에서 자산을 로드해야 할 수 있으므로 정적 파일을 사용하도록 애플리케이션을 구성했는지 확인하십시오.

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddControllers();
        services.AddOcelot();
    }

    public async void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }

        app.UseRouting();
        app.UseAuthorization();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapControllers();
        });

        await app.UseOcelot();
    }
}

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddControllers();
        services.AddOcelot();
    }

    public async void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }

        app.UseRouting();
        app.UseAuthorization();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapControllers();
        });

        await app.UseOcelot();
    }
}

Public Class Startup
	Public Sub ConfigureServices(ByVal services As IServiceCollection)
		services.AddControllers()
		services.AddOcelot()
	End Sub

	Public Async Sub Configure(ByVal app As IApplicationBuilder, ByVal env As IWebHostEnvironment)
		If env.IsDevelopment() Then
			app.UseDeveloperExceptionPage()
		End If

		app.UseRouting()
		app.UseAuthorization()

		app.UseEndpoints(Sub(endpoints)
			endpoints.MapControllers()
		End Sub)

		Await app.UseOcelot()
	End Sub
End Class

5단계: IronPDF로 PDF 생성 구현

Controllers 폴더에 새로운 컨트롤러 PdfController.cs를 만드십시오. 이 컨트롤러는 PDF 생성 요청을 처리합니다.

using Microsoft.AspNetCore.Mvc;
using IronPdf;

namespace OcelotWithIronPdf.Controllers
{
    [ApiController]
    [Route("api/[controller]")]
    public class PdfController : ControllerBase
    {
        [HttpPost]
        public IActionResult CreatePdfFromHtml([FromBody] string htmlContent)
        {
            var renderer = new ChromePdfRenderer();
            var pdf = renderer.RenderHtmlAsPdf(htmlContent);
            var output = pdf.BinaryData;

            // Return the PDF as a file result
            return File(output, "application/pdf", "generated.pdf");
        }
    }
}

using Microsoft.AspNetCore.Mvc;
using IronPdf;

namespace OcelotWithIronPdf.Controllers
{
    [ApiController]
    [Route("api/[controller]")]
    public class PdfController : ControllerBase
    {
        [HttpPost]
        public IActionResult CreatePdfFromHtml([FromBody] string htmlContent)
        {
            var renderer = new ChromePdfRenderer();
            var pdf = renderer.RenderHtmlAsPdf(htmlContent);
            var output = pdf.BinaryData;

            // Return the PDF as a file result
            return File(output, "application/pdf", "generated.pdf");
        }
    }
}

Imports Microsoft.AspNetCore.Mvc
Imports IronPdf

Namespace OcelotWithIronPdf.Controllers

    <ApiController>
    <Route("api/[controller]")>
    Public Class PdfController
        Inherits ControllerBase

        <HttpPost>
        Public Function CreatePdfFromHtml(<FromBody> htmlContent As String) As IActionResult
            Dim renderer = New ChromePdfRenderer()
            Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
            Dim output = pdf.BinaryData

            ' Return the PDF as a file result
            Return File(output, "application/pdf", "generated.pdf")
        End Function

    End Class

End Namespace

6단계: 애플리케이션 실행

애플리케이션이 ocelot.json에 지정된 포트를 청취하도록 올바르게 구성되었는지 확인하십시오. 이는 Properties/launchSettings.json에서 설정할 수 있습니다.

{
  "profiles": {
    "OcelotWithIronPDF": {
      "commandName": "Project",
      "launchBrowser": false,
      "applicationUrl": "https://localhost:5001;http://localhost:5000",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

이제 애플리케이션을 실행하여 http://localhost:5000/generatepdf에 HTML 콘텐츠를 게시하고 PDF를 응답으로 받을 수 있어야 합니다.

이 예제는 동일한 애플리케이션 내에서 IronPDF와 함께 Ocelot의 기본 구현을 보여줍니다. 생산 시나리오의 경우, 엔드포인트 보안, 오류 시나리오 처리, 특정 요구 사항에 따라 PDF 생성 프로세스 최적화를 고려하십시오.