IRONSOFTWAREHOME

IronPDF 사용하여 Azure Functions를 로컬에서 디버깅하기

Curtis Chau
Curtis Chau
Updated: 2026년 4월 24일

Azure를 로컬에서 실행할 때 발생하는 문제점

이 문제를 겪을 때 흔히 보이는 예외는 "IronPdf.Native.Chrome.deployment.json 배포 구성 파일을 찾는 동안 오류"입니다.

추천: .NET Core 3.1 <TargetFramework>netcoreapp3.1</TargetFramework>을 대상으로 하는 Windows 호스팅 Azure Function Apps를 실행하세요

필수: Visual Studio에서 Azure Function을 생성할 때 기본 "프로세스 내" 구성을 사용하십시오. 최신 버전의 IronPDF " 격리된 작업자 모델에서 C# Azure Functions 실행 가이드 "에 설명된 대로 '프로세스 외부' 또는 '격리된 프로세스'에서 실행되는 Azure Functions를 지원합니다. 그러나 이전 버전에서는 이러한 유형의 Azure Functions를 지원하지 않을 수 있습니다.

Azure Function 다이어그램

Azure Functions를 로컬에서 실행할 때 종속성 관련 문제 발생

Azure를 로컬에서 실행할 때 Azurite(VS2022) 또는 Azure Storage Emulator(VS2019)를 사용하면 Storage Emulator가 배포에 사용하는 추가 bin 디렉터리가 생성됩니다. 이 디렉터리에는 DLL 파일만 복사되므로 추가 파일이 필요한 소프트웨어는 작동하지 않거나 위와 같은 예외가 발생할 수 있습니다.

이 문제를 해결하려면 런타임 디렉토리를 스토리지 에뮬레이터에서 사용하는 별도의 bin 디렉토리로 복사하면 됩니다. 로컬에서 실행할 경우, 이 작업을 빌드 후 단계 로 수행하는 것을 권장합니다(아래 지침 참조). (재컴파일/빌드를 하면 bin 디렉토리가 원래 상태로 되돌아갑니다.) 클라우드 환경에 배포할 경우에는 이러한 문제가 발생하지 않습니다.

  • 문제: Azure Function 프로젝트를 로컬에서 실행할 때, 함수가 실행되는 bin 폴더가 추가로 생성됩니다. 하지만 필요한 모든 파일을 해당 bin 폴더에 복사하지는 않습니다.
  • 예시: C:\code\azure-functions-test 경로에 있는 프로젝트가 C:\code\azure-functions-test\bin\Debug\netcoreapp3.1 경로로 빌드되는 경우
  • 해결 방법: C:\code\azure-functions-test\bin\Debug\netcoreapp3.1\runtimes 디렉터리를 복사하여 C:\code\azure-functions-test\bin\Debug\netcoreapp3.1\bin 디렉터리에도 생성하십시오.
  • 기존 파일이 있는 경우 덮어쓰기 여부를 묻는 메시지가 표시되면 덮어쓰기를 선택합니다.

의존성 다이어그램

빌드 후 이벤트

필요한 파일을 로컬 Azure Function bin 디렉터리로 복사하는 프로세스를 자동화하려면 다음 지침에 따라 Visual Studio에서 빌드 후 이벤트를 설정하세요.

  1. Azure Functions 프로젝트를 마우스 오른쪽 버튼으로 클릭하고 속성을 선택합니다.
  2. 이벤트 섹션까지 아래로 스크롤하세요.
  3. 아래와 같이 빌드 후 이벤트를 입력합니다.
XCOPY "$(TargetDir)runtimes" "$(TargetDir)bin\runtimes" /S /E /Y /I /R /D
SHELL

이 명령은 다음을 수행합니다.

  • runtimes 디렉토리의 내용을 bin/runtimes 디렉토리로 복사하십시오.
  • 모든 하위 디렉토리 및 빈 디렉토리가 포함되도록 /S/E 스위치를 사용하십시오.
  • 기존 대상 파일을 덮어쓰기를 확인하게하는 프롬프트를 억제하는 /Y 스위치를 사용하십시오.
  • 만약 목적지가 디렉토리가 아니라면, 그것이 디렉토리라고 가정하는 /I 스위치를 사용하십시오.
  • 읽기 전용 파일을 덮어쓰는 /R 스위치를 사용하십시오.
  • 지정된 날짜에 변경된 파일을 복사하는 /D 스위치를 사용하십시오.

Post-Build 이벤트 구성

Curtis Chau
기술 문서 작성자

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

...
더 읽어보기

시작할 준비 되셨나요?

Nuget Downloads 20,756,830버전:2026.7방금 출시

지금 바로 30일 무료 체험판 키를 받으세요.
신용카드나 계정 생성은 필요하지 않습니다.
PDF용 C# NuGet 라이브러리
NuGet을 사용하여 설치하세요

버전: 2026.7

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 솔루션 탐색기에서 참조를 마우스 오른쪽 버튼으로 클릭하고 NuGet 패키지 관리를 선택합니다.
  2. 찾아보기를 선택하고 "IronPDF"를 검색하세요.
  3. 패키지를 선택하고 설치하세요
C# PDF DLL
DLL 다운로드

버전: 2026.7

또는 여기에서 Windows 설치 프로그램을 다운로드하십시오.

  1. IronPDF를 다운로드하고 솔루션 디렉터리 내의 ~/Libs와 같은 위치에 압축을 푸세요.
  2. Visual Studio 솔루션 탐색기에서 참조를 마우스 오른쪽 버튼으로 클릭합니다. 찾아보기를 선택하고 "IronPDF.dll"을 선택합니다.

라이선스 가격은 749달러 부터 시작합니다.

Key in blue circle

무료 30일 체험 키를 즉시 받으세요.

Your trial license will be sent to your email address

제한 없음. 100% 무제한 이용. 신용카드 불필요.

bullet_checked신용카드나 계정 생성은 필요하지 않습니다.제한 없음. 100% 무제한 이용. 신용카드 불필요.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
무료 라이브 데모를 예약하세요
Booking Badge

전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.

Iron Software의 고객 로고
부담 없는 무료 상담을 받아보세요
아래 양식을 작성하시거나 sales@ironsoftware.com으로 이메일을 보내주세요.
고객님의 정보는 항상 비밀로 유지됩니다.
전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.
Iron Software의 고객 로고
지금 바로 30일 무료 체험판 키를 받으세요.
신용카드나 계정 생성은 필요하지 않습니다.