IronPDF를 원격 컨테이너로 실행

배포 문제 방지

모든 종속성을 제대로 포함하도록 환경/컨테이너를 구성하는 것은 어려울 수 있습니다. IronPDF Docker 컨테이너를 사용하면 IronPDF가 사전에 설치되어 작동이 _보장_되므로 배포 및 종속성 관련 문제를 모두 피할 수 있습니다.

IronPDF를 설치하세요

프로젝트에 IronPdf.Slim NuGet 패키지를 추가하세요.

https://www.nuget.org/packages/IronPdf.Slim/

참고: IronPdf, IronPdf.Linux 및 IronPdf.MacOs 패키지에는 모두 IronPdf.Slim이 포함되어 있습니다.

애플리케이션 크기를 줄이려면 IronPdf.Slim만 설치하는 것이 좋습니다. 패키지 IronPdf.Native.Chrome.xxx는 더 이상 사용되지 않으므로 프로젝트에서 제거할 수 있습니다.

필요한 컨테이너 버전을 확인하세요

기본적으로 Docker용 IronPDF 버전은 NuGet에 있는 IronPDF의 현재 버전과 일치합니다. 아래 코드를 사용하여 수동으로 버전을 확인할 수 있습니다.

:path=/static-assets/pdf/content-code-examples/how-to/ironpdfengine-docker-version.cs

string ironPdfEngineVersion = IronPdf.Installation.IronPdfEngineVersion;

Docker 컨테이너용 IronPDF 설정

docker pull ironsoftwareofficial/ironpdfengine

docker pull ironsoftwareofficial/ironpdfengine

docker pull ironsoftwareofficial/ironpdfengine:2025.3.6

docker pull ironsoftwareofficial/ironpdfengine:2025.3.6

docker run -d -p 33350:33350 -e IRONPDF_ENGINE_LICENSE_KEY=MY_LICENSE_KEY ironsoftwareofficial/ironpdfengine:2025.3.6

docker run -d -p 33350:33350 -e IRONPDF_ENGINE_LICENSE_KEY=MY_LICENSE_KEY ironsoftwareofficial/ironpdfengine:2025.3.6

version: '3.6'
services:
  myironpdfengine:
    container_name: ironpdfengine
    image: ironsoftwareofficial/ironpdfengine:latest
    ports:
      - '33350:33350'
    networks:
      - ironpdf-network
  myconsoleapp:
    container_name: myconsoleapp
    build:
      # enter YOUR project directory path here
      context: ./MyConsoleApp/
      # enter YOUR dockerfile name here, relative to project directory
      dockerfile: Dockerfile
    networks:
      - ironpdf-network
    depends_on:
      myironpdfengine:
        condition: service_started
networks:
  ironpdf-network: 
    driver: 'bridge'

docker compose up --detach --force-recreate --remove-orphans --timestamps

docker compose up --detach --force-recreate --remove-orphans --timestamps

IronPdfEngine에 연결하세요

IronPDF 코드를 실행하세요. 이제 앱이 Docker의 IronPdfEngine과 통신합니다!

:path=/static-assets/pdf/content-code-examples/how-to/ironpdfengine-docker-use.cs

using IronPdf;
using IronPdf.GrpcLayer;

// Configure for Docker container
var config = IronPdfConnectionConfiguration.Docker;
config.Host = "localhost";
IronPdf.Installation.ConnectToIronPdfHost(config);

// Use IronPDF
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello IronPDF Docker!<h1>");
pdf.SaveAs("ironpdf.pdf");

연결 유형

:path=/static-assets/pdf/content-code-examples/how-to/ironpdfengine-docker-use-grpc.cs

using IronPdf;

// This code demonstrates how to use IronPdf with gRPC in a .NET Framework application.

// 1. Configure connection to use local IronPdfEngine executable
var config = IronPdf.GrpcLayer.IronPdfConnectionConfiguration.Executable;

// 2. Connect to the IronPDF host with the executable configuration
IronPdf.Installation.ConnectToIronPdfHost(config);

// 3. Create a PDF renderer instance
ChromePdfRenderer renderer = new ChromePdfRenderer();

// 4. Render HTML string as PDF document
PdfDocument pdf = renderer.RenderHtmlAsPdf("Hello world");

// 5. Save the PDF to disk
pdf.SaveAs("output.pdf");

// 6. Clean up , this is needed to work
pdf.Dispose();

:path=/static-assets/pdf/content-code-examples/how-to/ironpdfengine-docker-use-grpc-alt.cs

using IronPdf;
using IronPdf.GrpcLayer;
using Grpc.Core;

// 1. Create custom gRPC channel (.NET Framework style)
var channel = new Channel("123.456.7.8:80", ChannelCredentials.SecureSsl);

// 2. (Optional) Add metadata headers if needed
var metadata = new Metadata
{
    { "Authorization", "Bearer your_token_here" }
};

// 3. Configure IronPDF with custom channel
var config = IronPdfConnectionConfiguration.WithCustomChannel(channel, metadata);
IronPdf.Installation.ConnectToIronPdfHost(config);

// 4. Generate PDF
var renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("Hello world");

// 5. Save the PDF to disk
pdf.SaveAs("output.pdf");

// 6. Clean up , this is needed to work
pdf.Dispose();

필수 조건

• IronPdfEngine Docker 이미지를 다운로드하세요. 이는 위의 Docker 컨테이너용 IronPDF 설정 부분에 있습니다.
• ECS에 접근 권한이 있는 AWS 계정.

설정

1. ECS 클러스터를 생성합니다. 콘솔을 사용하여 Fargate 및 외부 시작 유형에 대한 클러스터를 생성하려면 이 가이드를 따르십시오.
2. 작업 정의를 생성합니다. 콘솔을 사용하여 작업 정의를 생성 하려면 이 가이드를 따르세요.

권장 설정:

• AWS Fargate
• 최소 1개의 vCPU와 2GB의 RAM을 권장합니다. 작업량에 따라, 10페이지가 넘는 PDF 파일을 다루거나 요청량이 많은 경우에는 더 높은 요금제를 선택하십시오.
• 네트워크 모드 : awsvpc
• 포트 매핑 :

  {
    "containerPort": 33350,
    "hostPort": 33350,
    "protocol": "tcp",
    "appProtocol": "grpc"
  }

• 이미지 URI : 당사에서 제공하는 IronPdfEngine을 가리키도록 설정하십시오. 예를 들어, "ironsoftwareofficial/ironpdfengine:2024.1.20"(DockerHub에서 가져옴)
• AWS 권한 및 네트워킹은 사용자 스스로 해결해야 합니다.
• Amazon CloudWatch를 활성화하는 것이 좋습니다. (Enable logging)
• 애플리케이션 컨테이너를 동일한 작업 정의 내에 배포하려면 컨테이너 시작 순서가 중요합니다.

3. 작업 정의를 실행합니다. 작업 정의를 작업 또는 서비스 로 실행할 수 있습니다. 콘솔을 사용하여 서비스를 생성하는 방법 에 대한 이 가이드를 따르세요.

권장 설정:

• 시작 유형: AWS Fargate
• 공용 IP: 테스트 시에는 활성화되고 , 실제 운영 시에는 비활성화됩니다 . 보안 및 AWS 네트워킹은 사용자 스스로 해결해야 합니다.

4. 즐기세요! IronPdfEngine Docker 컨테이너가 AWS에서 정상적으로 실행 중입니다!

필수 조건

• IronPdfEngine Docker 이미지를 다운로드하세요. 이는 위의 Docker 컨테이너용 IronPDF 설정 부분에 있습니다.
• Azure 계정

설정

1. Azure 컨테이너를 생성합니다. Azure 포털을 사용하여 Azure에 컨테이너 인스턴스를 배포하는 방법에 대한 빠른 시작 가이드를 따르세요.

권장 설정:

• 이미지 출처 : 기타 레지스트리
• 이미지 : ironsoftwareofficial/ironpdfengine:2024.1.20 (Docker Hub에서 가져옴)
• 운영체제 종류 : Linux
• 크기 : 최소 1개의 vCPU와 2GiB 이상의 메모리
• 포트 : TCP 포트 33350

2. 즐기세요! IronPdfEngine Docker가 Azure 컨테이너 인스턴스에서 실행 중입니다!

필수 조건

Docker가 설치되어 있어야 합니다.

설정

1. 다음으로 이동하세요https://gallery.ecr.aws/v1m9w8y1/ironpdfengine
2. v1m9w8y1/ironpdfengine 이미지를 다운로드하세요.

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine

또는 특정 버전을 다운로드하세요(권장).

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine:2023.12.6

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine:2023.12.6

3. ironpdfengine 컨테이너를 실행합니다.

이 명령은 컨테이너를 생성하고 33350번 포트에서 백그라운드로 실행합니다.

docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

IronPdfEngine을 사용하도록 IronPdf 클라이언트를 구성하는 방법을 알아보려면 " IronPdfEngine을 사용하도록 코드 업데이트 " 섹션을 참조하십시오.

Azure 마켓플레이스

설정

1. Azure 마켓플레이스에서 IronPDF Docker 컨테이너 로 이동합니다. "지금 받기"를 클릭하고 "계속"을 누르세요.
2. "기본 사항", "클러스터 세부 정보" 및 "애플리케이션 세부 정보"를 완료하여 Kubernetes 서비스를 생성합니다.
3. 배포가 완료되면 왼쪽 사이드바에서 Kubernetes 리소스 > 명령 실행을 선택합니다. 다음 명령어를 실행하세요:

kubectl get services

kubectl get services

외부 IP 주소와 포트 정보를 이용하여 IronPDFEngine 연결을 적절하게 구성할 수 있습니다.

:path=/static-assets/pdf/content-code-examples/how-to/pull-run-ironpdfengine-azure-marketplace.cs

using IronPdf;
using IronPdf.GrpcLayer;

IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01";

IronPdfConnectionConfiguration configuration = new IronPdfConnectionConfiguration();
configuration.ConnectionType = IronPdfConnectionType.RemoteServer;
configuration.Host = "http://48.216.143.233";
configuration.Port = 80;
IronPdf.Installation.ConnectToIronPdfHost(configuration);

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");
pdf.SaveAs("output.pdf");

AWS 마켓플레이스

필수 조건

Docker가 설치되어 있어야 합니다.

• AWS CLI가 설치되어 있고 로그인되어 있어야 합니다.

설정

1. AWS 마켓플레이스에서 IronPdfEngine 페이지 로 이동합니다. '구독 계속하기'를 클릭하세요.

2. 약관에 동의하십시오.

4. 설정을 계속 진행하세요.

5. ironpdfengine 이미지를 가져옵니다. 이 단계에서는 ironpdfengine 이미지를 다운로드하는 명령어를 보여줍니다.

예를 들어:

aws ecr get-login-password \
    --region us-east-1 | docker login \
    --username AWS \
    --password-stdin 000000000000.dkr.ecr.us-east-1.amazonaws.com
CONTAINER_IMAGES="000000000000.dkr.ecr.us-east-1.amazonaws.com/iron-software/ironpdfengine:2024.1.15"    
for i in $(echo $CONTAINER_IMAGES | sed "s/,/ /g"); do docker pull $i; done

aws ecr get-login-password \
    --region us-east-1 | docker login \
    --username AWS \
    --password-stdin 000000000000.dkr.ecr.us-east-1.amazonaws.com
CONTAINER_IMAGES="000000000000.dkr.ecr.us-east-1.amazonaws.com/iron-software/ironpdfengine:2024.1.15"    
for i in $(echo $CONTAINER_IMAGES | sed "s/,/ /g"); do docker pull $i; done

6. ironpdfengine 컨테이너를 실행합니다. 이 명령은 컨테이너를 생성하고 33350번 포트를 사용하여 백그라운드에서 실행합니다.

docker run -d -p 33350:33350 000000000000.dkr.ecr.us-east-1.amazonaws.com/iron-software/ironpdfengine:2024.1.15

docker run -d -p 33350:33350 000000000000.dkr.ecr.us-east-1.amazonaws.com/iron-software/ironpdfengine:2024.1.15

gRPC를 이용한 건강 진단

IronPdfEngine은 표준 gRPC 상태 점검 패턴을 준수하며, 다음과 같은 프로토콜 구조를 사용합니다.

message HealthCheckRequest {
 string service = 1; // Name of the service to check (e.g., "IronPdfEngine")
}

IronPdfEngine을 확인하고 있으므로 서비스 이름을 IronPdfEngine로 바꿉니다.

다음은 Postman 에서 JavaScript를 사용하여 기본 포트 번호인 33350으로 로컬 IronPdfEngine 서비스에 gRPC 요청을 보내는 예입니다.

응답에서 보시는 바와 같이 상태 응답은 SERVING이며, 이는 서비스가 정상적으로 실행 중임을 나타냅니다. 컨테이너가 정상 상태가 아닌 경우 상태 응답은 NOT_SERVING가 됩니다.

Kubernetes 설정을 통한 상태 점검

Kubernetes 환경에서는 다음을 사용하여 서비스의 정상 여부를 확인할 수 있습니다.

 livenessProbe:
          exec:
            command:
            - /bin/grpc_health_probe
            - -addr=:33350
            - -rpc-timeout=5s

 livenessProbe:
          exec:
            command:
            - /bin/grpc_health_probe
            - -addr=:33350
            - -rpc-timeout=5s