기존 Docker 컨테이너에 IronPDF 추가하기

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF for .NET Standard는 이제 Linux 및 Windows용 Azure Docker 컨테이너를 포함하여 Docker를 완벽하게 지원합니다.

IronPDF를 별도의 Docker 컨테이너로 배포하시겠습니까? IronPDFEngine 튜토리얼 가이드 에 대해 자세히 알아보세요.

Docker 로고
Azure 로고
리눅스 로고
AWS 로고
윈도우 로고

Azure에서 Docker를 사용해야 하는 이유는 무엇일까요?

Azure의 Docker 컨테이너는 뛰어난 Enterprise급 확장성을 제공할 뿐만 아니라 일반 웹 앱보다 더 많은 권한을 갖습니다. 이를 통해 시스템이 GDI+ 그래픽에 접근할 수 있으므로 SVG 글꼴을 렌더링할 수 있습니다.

IronPDF와 Linux 입문

Docker와 .NET을 처음 사용하시는 분이라면 Visual Studio 프로젝트와 Docker 디버깅 및 통합 설정 에 대한 이 훌륭한 글을 읽어보시기를 권장합니다.

IronPDF Linux 설치 및 호환성 가이드 도 읽어보시기를 강력히 권장합니다.

권장 Linux Docker 배포판

IronPDF의 "간편한 설정"을 위해 아래에 제시된 최신 64비트 Linux 운영 체제를 권장합니다.

Microsoft의 공식 .NET용 Docker 이미지를 사용하는 것을 권장합니다. 다른 리눅스 배포판도 부분적으로 지원되지만, 수동 구성이 필요할 수 있습니다. 저희 " 리눅스 수동 설치 " 가이드를 참조하세요.

IronPDF Linux Docker 설치

Linux에 최적화된 NuGet 패키지를 사용하세요

Docker 인스턴스를 시작할 때 디스크 공간을 절약하고 자산 다운로드를 방지하려면 일반 IronPdf 패키지 대신 IronPdf.Linux NuGet 패키지를 사용하는 것이 좋습니다. 걱정하지 마세요. 윈도우나 macOS에서 개발할 때도 똑같이 작동합니다. 다만 리눅스에 최적화되어 있을 뿐입니다.

Install-Package IronPdf.Linux

또 다른 해결책은 일반 IronPdf NuGet 패키지 위에 IronPdf.Native.Chrome.Linux를 추가하는 것입니다.

Install-Package IronPdf.Native.Chrome.Linux

자동 종속성 설치를 방지하세요

많은 사용자가 LinuxAndDockerDependenciesAutoConfig를 false로 설정했을 때 Linux 및 Docker에서 더 나은 결과를 얻었다고 보고합니다. 이는 필수 구성 요소가 Docker 파일에 있는 apt-get 스타일 패키지 관리자에 의해 이미 설치되었기 때문입니다.

// Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;
// Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;
$vbLabelText   $csharpLabel

GPU 가속 비활성화

리눅스 Docker 컨테이너는 종종 GPU에 접근할 수 없습니다. GPU 가속은 기본적으로 비활성화되어 있습니다. ChromeGpuModes.Enabled를 활성화한 경우 Docker 배포 시에는 비활성화하는 것을 강력히 권장합니다.

// Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
// Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
$vbLabelText   $csharpLabel

우분투 리눅스 Docker 파일

Docker 로고
우분투 로고

.NET 8이 설치된 Ubuntu 22

.NET 7이 설치된 Ubuntu 22

.NET 6이 설치된 Ubuntu 20

.NET 5가 포함된 Ubuntu 20

.NET 3.1 LTS가 설치된 Ubuntu 20

.NET 3.1 LTS가 설치된 Ubuntu 18

데비안 리눅스 Docker 파일

Docker 로고
데비안 로고

.NET 8이 설치된 Debian 12

.NET 7이 설치된 Debian 11

.NET 6이 설치된 Debian 11

.NET 5가 설치된 Debian 11

.NET 3.1 LTS가 설치된 Debian 11

.NET 5가 설치된 데비안 10

.NET 3.1 LTS가 설치된 Debian 10

Alpine Linux Docker 파일

Alpine Linux에서 IronPDF를 실행하는 것은 지원되지 않습니다. 저희도 그러고 싶지만, 그럴 수 없습니다. 솔직히 저희는 알파인을 좋아하고 이 프로젝트가 계속되고 성장하기를 바랍니다. 2023년 현재, Alpine은 여전히 구식 "musl" C 언어 라이브러리를 사용하고 있어 Chromium 개발자가 이 운영 체제를 완벽하게 지원할 수 없습니다.

.NET 6에서 Alpine Docker와 IronPdfEngine을 함께 사용하는 방법

IronPDF는 모든 IronPDF 기능을 포함하는 컨테이너 이미지를 제공합니다. 이를 통해 Alpine에서 실행되는 프로젝트는 IronPdfEngine 컨테이너에 연결하여 IronPD 기능을 사용할 수 있습니다.

1단계: IronPDF 엔진 Docker 이미지 다운로드 및 실행

터미널에서 다음 명령어를 실행하여 IronPDF 엔진 Docker 이미지를 다운로드하고 실행하십시오.

# Pull the IronPDF Engine Docker Image
docker pull ironsoftwareofficial/ironpdfengine
# Pull the IronPDF Engine Docker Image
docker pull ironsoftwareofficial/ironpdfengine
SHELL
# Run the IronPDF Engine Docker container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine
# Run the IronPDF Engine Docker container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine
SHELL

2단계: 콘솔 앱 설정

.NET 6을 대상으로 하는 새 콘솔 애플리케이션을 만듭니다. NuGet 패키지 관리자를 사용하여 IronPdf.Slim NuGet 패키지를 설치합니다.

윈도우 Docker 파일

Docker 로고
윈도우 로고

Windows Docker 컨테이너는 성능과 확장성이 뛰어나고 개발자에게 인스턴스 구성에 대한 더 많은 권한을 제공하기 때문에 Azure에서 점점 더 인기를 얻고 있습니다.

IronPDF는 그래픽 라이브러리와 가상 그래픽 카드에 대한 접근 권한이 높아짐에 따라 Azure의 Docker 컨테이너(Windows 또는 Linux) 내에서 더욱 매력적인 텍스트 렌더링을 제공합니다.

' Visual Studio Container Tools for Docker '라는 문서는 정말 훌륭한 시작 가이드입니다.

다음은 .NET Core 3.1용 Windows 컨테이너 Dockerfile 예시입니다.

Windows Server 2019 .NET 6.0

사전 구성된 Windows 컨테이너에는 IronPDF 실행에 필요한 모든 종속성이 포함되어 있습니다.

참고해 주세요이 컨테이너는 .NET 애플리케이션을 빌드하기 위한 것이 아니라 실행하기 위한 것임을 유의하십시오.

IronPDF 실행을 위한 추가 사전 구성 이미지를 살펴보려면 Docker 저장소를 방문하세요.

자주 묻는 질문

.NET PDF 생성 라이브러리를 Docker 컨테이너에 통합하려면 어떻게 해야 할까요?

PDF 생성을 위한 .NET 라이브러리인 IronPDF를 Docker 컨테이너에 통합하려면 Linux 환경에서는 Microsoft의 공식 Docker 이미지와 IronPdf.Linux NuGet 패키지를 사용하고, Windows 환경에서는 사전 구성된 Windows Docker 컨테이너를 사용하면 됩니다.

Azure에서 PDF 조작에 Docker 컨테이너를 사용하면 어떤 이점이 있나요?

Azure에서 Docker 컨테이너를 사용하여 PDF를 조작하면 일반 웹 앱보다 향상된 Enterprise 확장성과 더 많은 권한을 제공합니다. 이 구성은 GDI+ 그래픽 액세스를 통해 SVG 글꼴 렌더링과 같은 고급 기능을 활성화하는 데 이상적입니다.

Docker에서 .NET PDF 라이브러리를 실행하는 데 가장 적합한 Linux 배포판은 무엇입니까?

Docker에서 IronPDF를 실행하는 데 가장 적합한 Linux 배포판으로는 Ubuntu 18/20/22, Debian 10/11, CentOS 8 및 Amazon AWS Linux 2가 있습니다. 이러한 배포판은 구성이 간단하고 호환성이 뛰어나기 때문입니다.

Linux Docker 컨테이너에서 .NET PDF 라이브러리의 성능을 최적화하려면 어떻게 해야 할까요?

성능을 최적화하려면 IronPdf.Linux 패키지를 사용하고, 자동 종속성 설치를 비활성화하고, `IronPdf.Installation.ChromeGpuMode` 를 `IronPdf.Engines.Chrome.ChromeGpuModes.Disabled` 로 구성하여 GPU 가속을 끄십시오.

IronPDF는 Docker 컨테이너 내에서 Alpine Linux를 실행할 수 있습니까?

IronPDF는 'musl' 라이브러리의 호환성 문제로 인해 Alpine Linux를 기본적으로 지원하지 않습니다. Alpine Linux에서 IronPDF를 사용하려면 IronPdfEngine Docker 컨테이너를 통해 실행하는 것을 고려해 보세요.

.NET 라이브러리에 사전 구성된 Docker 컨테이너를 사용하는 목적은 무엇입니까?

사전 구성된 Docker 컨테이너는 IronPDF를 효율적으로 실행하는 데 필요한 모든 종속성을 제공하여 높은 성능과 확장성을 보장하며, 특히 Azure와 같은 플랫폼에 배포할 때 유용합니다.

Docker 환경에서 .NET 애플리케이션용 .NET PDF 라이브러리를 어떻게 구성할 수 있나요?

IronPDF를 Linux 및 Windows Docker 컨테이너와 통합하여 Docker 환경에서 .NET 애플리케이션용으로 구성할 수 있으므로 마이크로서비스 아키텍처 내에서 강력한 PDF 기능을 구현할 수 있습니다.

Docker에 .NET 라이브러리를 배포하기 위한 권장 설정 단계는 무엇입니까?

권장 조치에는 IronPdf.Linux와 같은 Linux 최적화 패키지 사용, 자동 종속성 설치 비활성화, Docker 환경에서 런타임 지연을 방지하기 위해 IronPDF를 사전 초기화하는 것이 포함됩니다.

.NET 6.0이 실행되는 Windows Server 2019 Docker 컨테이너에 .NET PDF 라이브러리를 설정하는 방법은 무엇입니까?

.NET 6.0에서 IronPDF를 실행하는 데 필요한 모든 종속성 및 구성이 포함된 사전 구성된 Dockerfile을 사용하여 Windows Server 2019 Docker 컨테이너에 .NET PDF 라이브러리를 설정합니다.

.NET 라이브러리의 Docker 설정에서 GPU 가속을 비활성화하는 이유는 무엇입니까?

Docker 환경에서 IronPDF의 GPU 가속을 비활성화하면 GPU 리소스가 제한된 환경에서 발생할 수 있는 그래픽 관련 문제를 방지하여 배포 및 성능을 향상시킬 수 있습니다.

커티스 차우
기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?
Nuget 다운로드 17,527,568 | 버전: 2026.2 방금 출시되었습니다