Debugging Azure Functions Locally with IronPDF

Azureをローカルで実行する場合の問題

この問題に遭遇する際によく見られる例外は、"Error while locating deployment configuration file IronPdf.Native.Chrome.deployment.json"です。

推奨: WindowsホストのAzure Function Appsを.NET Core 3.1 <TargetFramework>netcoreapp3.1</TargetFramework>をターゲットとして実行する

必須: Visual StudioでAzure Functionを作成する際は、デフォルトの"インプロセス"の構成を使用する。 IronPDFの最新バージョンは、<"a href="隔離ワーカー" target="_blank">https://docs.microsoft.com/en-us/azure/azure-functions/dotnet-isolated-process-guide#differences-with-net-class-library-functions">隔離ワーカー モデルでC# Azure Functions を実行するためのガイド"で説明されているように、'アウトオブプロセス'または'隔離プロセス'で動作するAzure Functionsをサポートしています。しかし、古いバージョンはこれらのタイプのAzure Functionsをサポートしていないかもしれません。

Azure Functionsをローカルで実行する際に発生する依存関係の問題

Azureをローカルで実行する際、Azurite (VS2022) やAzure Storage Emulator (VS2019)を使用すると、Storage Emulatorがデプロイに使用する追加のbinディレクトリが作成されます。 このディレクトリにはDLLファイルのみがコピーされるため、追加のファイルを必要とするソフトウェアは動作しないか、上記の例外をスローする可能性があります。

Storage Emulatorが使用する個別の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

XCOPY "$(TargetDir)runtimes" "$(TargetDir)bin\runtimes" /S /E /Y /I /R /D

このコマンドは次のことを行います:

• _runtimes_ディレクトリの内容を_bin/runtimes_ディレクトリにコピーします。
• /Sと/Eスイッチは、すべてのサブディレクトリと空のディレクトリが含まれることを保証します。
• /Yスイッチは、既存の宛先ファイルの上書きを確認するプロンプトを抑制します。
• /Iスイッチは、宛先が存在しない場合にディレクトリであると仮定します。
• /Rスイッチは、読み取り専用ファイルを上書きします。
• /Dスイッチは、指定された日付以降に変更されたファイルをコピーします。