Docker에서의 Vulkan 및 ANGLE 초기화 오류

Curtis Chau

Updated: 2026년 6월 10일

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # Docker에서의 Vulkan 및 ANGLE 초기화 오류 IronPDF는 Docker 컨테이너, AWS Lambda, Azure App Service, Google Cloud Run, CI/CD 파이프라인에서 Vulkan 또는 ANGLE 초기화 오류를 기록합니다. ```txt ERR: Display.cpp:1021 (initialize): ANGLE Display::initialize error 0: Internal Vulkan error (-3): Initialization of an object could not be completed for implementation-specific reasons... ``` IronPDF에 내장된 Chrome Embedded Framework (CEF)는 명시적인 GPU 모드가 설정되지 않은 경우 Vulkan을 통한 GPU 렌더링을 시도합니다. GPU 액세스 또는 디스플레이 드라이버 없이 실행되는 Docker 컨테이너는 Vulkan을 초기화할 수 없으며, 이로 인해 오류가 발생합니다. 로그 메시지에도 불구하고, IronPDF는 렌더링을 계속하여 유효한 PDF 출력을 생성합니다. 오류는 차단되지 않습니다. ## 해결책 GPU 초기화 시도를 방지하고 오류를 억제하려면 GPU 렌더링을 비활성화하고 싱글 프로세스 모드를 활성화하십시오: ```csharp IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled; IronPdf.Installation.ChromeBrowserEngineSettings.SingleProcess = true; ``` 이 속성들은 `ChromePdfRenderer`에 대한 첫 번째 호출 전에 설정해야 합니다. GPU 액세스가 불가능한 모든 Docker 배포를 위해 이 구성이 권장됩니다. 전체 Docker 설정 참조를 보려면 [IronPDF Docker 가이드](/get-started/ironpdf-docker/)를 참조하십시오.

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

IronPDF는 Docker 컨테이너, AWS Lambda, Azure App Service, Google Cloud Run, CI/CD 파이프라인에서 Vulkan 또는 ANGLE 초기화 오류를 기록합니다.

ERR: Display.cpp:1021 (initialize): ANGLE Display::initialize error 0: Internal Vulkan error (-3): Initialization of an object could not be completed for implementation-specific reasons...

ERR: Display.cpp:1021 (initialize): ANGLE Display::initialize error 0: Internal Vulkan error (-3): Initialization of an object could not be completed for implementation-specific reasons...

IronPDF에 내장된 Chrome Embedded Framework (CEF)는 명시적인 GPU 모드가 설정되지 않은 경우 Vulkan을 통한 GPU 렌더링을 시도합니다. GPU 액세스 또는 디스플레이 드라이버 없이 실행되는 Docker 컨테이너는 Vulkan을 초기화할 수 없으며, 이로 인해 오류가 발생합니다. 로그 메시지에도 불구하고, IronPDF는 렌더링을 계속하여 유효한 PDF 출력을 생성합니다. 오류는 차단되지 않습니다.

해결책

GPU 초기화 시도를 방지하고 오류를 억제하려면 GPU 렌더링을 비활성화하고 싱글 프로세스 모드를 활성화하십시오:

IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
IronPdf.Installation.ChromeBrowserEngineSettings.SingleProcess = true;

IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
IronPdf.Installation.ChromeBrowserEngineSettings.SingleProcess = true;

Imports IronPdf

IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
IronPdf.Installation.ChromeBrowserEngineSettings.SingleProcess = True

Imports IronPdf

IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
IronPdf.Installation.ChromeBrowserEngineSettings.SingleProcess = True

이 속성들은 ChromePdfRenderer에 대한 첫 번째 호출 전에 설정해야 합니다. GPU 액세스가 불가능한 모든 Docker 배포를 위해 이 구성이 권장됩니다.

전체 Docker 설정 참조를 보려면 IronPDF Docker 가이드를 참조하십시오.

Curtis Chau

지금 바로 엔지니어링 팀과 채팅하세요

기술 문서 작성자

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

...

더 읽어보기