IronPDF for JavaをAzureに設定する方法

必要な前提条件は何ですか？

開始前に、必要なすべてのツールがインストールされていることと、Azureサブスクリプションがアクティブであることを確認してください。これらのチェックをスキップすると、展開プロセスの途中でビルドの失敗が多発します。

必要なローカルツール：

• Azure CLI（バージョン2.40以降）
• Linuxコンテナが有効になっているDocker Desktop
• Maven 3.8以降
• JDK 11またはJDK 17（JDK 17が推奨されるLTSバージョン）
• Azure Functions Core Tools v4

必要なAzureリソース：

• アクティブなAzureサブスクリプション
• リソースグループ、ストレージアカウント、Function Appプランを作成する権限
• 作成したイメージをホストするためのDocker Hubアカウント（またはAzure Container Registry）

次のセクションに進む前に、Azure CLIを認証するためにaz loginを実行します。

Azure Functionプロジェクトをどのように設定しますか？

Linuxでカスタムイメージを使用して関数を作成するためのMicrosoftガイドは、完全なスキャフォルディングプロセスをカバーしています。 その手順を"プログラミング言語"にJavaを選択する重要な選択を行ってください。

スキャフォルドされたプロジェクトがビルドされ、プレースホルダ関数をAzure Functions Core Toolsを使用してローカルで実行するまでガイドを進めてください。 以下を使用してこれを検証します：

//:path=/static-assets/pdf/content-code-examples/tutorials/azure/local-run.sh
mvn clean package
func start

//:path=/static-assets/pdf/content-code-examples/tutorials/azure/local-run.sh
mvn clean package
func start

プレースホルダがローカルHTTPリクエストに応答すると、プロジェクト構造が正しくなり、IronPDF統合の準備が整いました。 主なファイルはDockerfile（コンテナ定義）です。

IronPDF依存関係をMavenプロジェクトにどのように追加しますか？

IronPDF for JavaはMaven Centralを通じて配布されています。 2つのアーティファクトが必要です：Java APIを提供するコアironpdfライブラリと、Linux x86-64用にコンパイルされたネイティブChromiumエンジンをバンドルするironpdf-engine-linux-x64です。エンジンアーティファクトは、実行時にバイナリを実行する必要があるためにDockerデプロイが必須となる理由です。

<dependencies>ブロック内に追加します。 現在のリリースを使用するためLATEST_VERSIONをMaven Centralで入手可能なものに置き換えます：

//:path=/static-assets/pdf/content-code-examples/tutorials/azure/pom.xml
<dependencies>

    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>LATEST_VERSION</version>
    </dependency>

    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf-engine-linux-x64</artifactId>
        <version>LATEST_VERSION</version>
    </dependency>
</dependencies>

//:path=/static-assets/pdf/content-code-examples/tutorials/azure/pom.xml
<dependencies>

    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>LATEST_VERSION</version>
    </dependency>

    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf-engine-linux-x64</artifactId>
        <version>LATEST_VERSION</version>
    </dependency>
</dependencies>

両方のアーティファクトは同じバージョン番号を使用する必要があります。 ironpdf-engine-linux-x64の間でバージョンが一致しないと、関数が最初にPDFをレンダリングしようとした際にランタイム例外が発生します。

mvn dependency:resolveを実行し、Dockerイメージの構築に時間をかける前に確認します。

RenderPdf関数をどのように書きますか？

Content-Disposition: attachmentヘッダ付きで結果のPDFをバイナリー応答として返します。 このヘッダーは、ブラウザ（またはHTTPクライアント）にPDFをインラインで表示するのではなくダウンロードするよう指示します。

完全な関数コードは、上記のクイックスタートに表示されています。 それをsrc/main/java/com/example/Function.javaに配置し、Mavenアーキタイプによって生成されたプレースホルダーを置き換えるか拡張します。

//:path=/static-assets/pdf/content-code-examples/tutorials/azure/RenderPdf-annotated.java
import com.microsoft.azure.functions.*;
import com.ironsoftware.ironpdf.PdfDocument;
import java.util.Optional;

public class Function {

    @FunctionName("RenderPdf")
    public HttpResponseMessage renderPdf(
            @HttpTrigger(
                    name = "req",
                    methods = {HttpMethod.GET, HttpMethod.POST},
                    authLevel = AuthorizationLevel.ANONYMOUS)
            HttpRequestMessage<Optional<String>> request,
            final ExecutionContext context) {

        // Log each invocation for Azure Monitor / Application Insights
        context.getLogger().info("RenderPdf triggered.");

        final String url = request.getQueryParameters().get("url");

        // Return 400 if no URL was supplied
        if (url == null) {
            return request.createResponseBuilder(HttpStatus.BAD_REQUEST)
                    .body("Provide a 'url' query parameter.")
                    .build();
        }

        try {
            // renderUrlAsPdf launches Chromium, loads the page, and captures it as PDF
            PdfDocument pdf = PdfDocument.renderUrlAsPdf(url);

            // getBinaryData returns the raw PDF bytes ready for transmission
            byte[] pdfBytes = pdf.getBinaryData();

            return request.createResponseBuilder(HttpStatus.OK)
                    .body(pdfBytes)
                    .header("Content-Disposition", "attachment; filename=output.pdf")
                    .header("Content-Type", "application/pdf")
                    .build();

        } catch (Exception ex) {
            context.getLogger().severe("Rendering error: " + ex.getMessage());
            return request.createResponseBuilder(HttpStatus.INTERNAL_SERVER_ERROR)
                    .body("PDF rendering failed.")
                    .build();
        }
    }
}

//:path=/static-assets/pdf/content-code-examples/tutorials/azure/RenderPdf-annotated.java
import com.microsoft.azure.functions.*;
import com.ironsoftware.ironpdf.PdfDocument;
import java.util.Optional;

public class Function {

    @FunctionName("RenderPdf")
    public HttpResponseMessage renderPdf(
            @HttpTrigger(
                    name = "req",
                    methods = {HttpMethod.GET, HttpMethod.POST},
                    authLevel = AuthorizationLevel.ANONYMOUS)
            HttpRequestMessage<Optional<String>> request,
            final ExecutionContext context) {

        // Log each invocation for Azure Monitor / Application Insights
        context.getLogger().info("RenderPdf triggered.");

        final String url = request.getQueryParameters().get("url");

        // Return 400 if no URL was supplied
        if (url == null) {
            return request.createResponseBuilder(HttpStatus.BAD_REQUEST)
                    .body("Provide a 'url' query parameter.")
                    .build();
        }

        try {
            // renderUrlAsPdf launches Chromium, loads the page, and captures it as PDF
            PdfDocument pdf = PdfDocument.renderUrlAsPdf(url);

            // getBinaryData returns the raw PDF bytes ready for transmission
            byte[] pdfBytes = pdf.getBinaryData();

            return request.createResponseBuilder(HttpStatus.OK)
                    .body(pdfBytes)
                    .header("Content-Disposition", "attachment; filename=output.pdf")
                    .header("Content-Type", "application/pdf")
                    .build();

        } catch (Exception ex) {
            context.getLogger().severe("Rendering error: " + ex.getMessage());
            return request.createResponseBuilder(HttpStatus.INTERNAL_SERVER_ERROR)
                    .body("PDF rendering failed.")
                    .build();
        }
    }
}

PdfDocument.renderUrlAsPdf(url)は、コンテナ内でヘッドレスChromiumインスタンスを起動し、ターゲットURL（JavaScriptを含む）を完全に読み込み、レンダリングされた出力をPDFとしてキャプチャします。 これにより、ユーザーがブラウザで見るものと視覚的に同一の出力が生成され、最新のWebアプリケーション、ダッシュボード、およびレポートページをキャプチャするのに適しています。

IronPDF用のDockerfileをどのように設定しますか？

IronPDFのChromiumエンジンは、ベースAzure Functionsイメージに含まれていない一連の共有Linuxライブラリに依存しています。 ベースイメージmcr.microsoft.com/azure-functions/java:4-java17-buildはDebian 11上で構築されているため、パッケージをaptを使用してインストールしなければなりません。

次のRUNコマンドを、Azure Functions Mavenアーキタイプによって生成されたDockerfileに追加する必要があります。 COPYステップの前にそれらを配置します：

//:path=/static-assets/pdf/content-code-examples/tutorials/azure/Dockerfile
FROM mcr.microsoft.com/azure-functions/java:4-java17-build AS installer-env

# Install system dependencies required by IronPDF's Chromium renderer
RUN apt-get update && apt-get install -y \
    libgdiplus \
    libxkbcommon-x11-0 \
    libc6 \
    libc6-dev \
    libgtk2.0-0 \
    libnss3 \
    libatk-bridge2.0-0 \
    libx11-xcb1 \
    libxcb-dri3-0 \
    libdrm-common \
    libgbm1 \
    libasound2 \
    libxrender1 \
    libfontconfig1 \
    libxshmfence1 \
    && apt-get install -y xvfb libva-dev libgdiplus \
    && rm -rf /var/lib/apt/lists/*

# Copy the built function JAR
COPY --from=installer-env /home/site/wwwroot /home/site/wwwroot

ENV AzureWebJobsScriptRoot=/home/site/wwwroot \
    AzureFunctionsJobHost__Logging__Console__IsEnabled=true

libgdiplusパッケージは、グラフィックスレンダリングのためのGDI+互換性を提供します。 libatk-bridge2.0-0は、Chromiumのサンドボックス化およびアクセシビリティ階層によって必要とされます。 xvfbは仮想フレームバッファを提供し、一部のDebian設定でヘッドレスモードでもChromiumが必要とするものです。 RUNブロックの最後にあり、パッケージマネージャーキャッシュを削除し、最終イメージサイズを可能な限り小さく保ちます。

Dockerイメージをどのようにビルドしてプッシュしますか？

Mavenプロジェクトがビルドされ、Dockerfileが更新されたら、コンテナイメージを作成してDockerレジストリにアップロードできます。 Azure Functionsは、Function Appが作成または更新されると、このイメージを取得します。

ステップ1 — Mavenプロジェクトをビルドおよびパッケージ化する：

//:path=/static-assets/pdf/content-code-examples/tutorials/azure/build.sh
# Compile the Java code and package it as a JAR
mvn clean package

//:path=/static-assets/pdf/content-code-examples/tutorials/azure/build.sh
# Compile the Java code and package it as a JAR
mvn clean package

Mavenは、関数コードをコンパイルし、すべての依存関係（IronPDFアーティファクトを含む）を解決し、target/ディレクトリにデプロイ可能なJARを生成します。 進行する前にコンパイルエラーを修正してください。

ステップ2 — Dockerイメージをビルドする：

//:path=/static-assets/pdf/content-code-examples/tutorials/azure/docker-build.sh
# Replace <DOCKER_ID> with your Docker Hub username or ACR login server
docker build --tag <DOCKER_ID>/ironpdf-azure-functions:v1.0.0 .

//:path=/static-assets/pdf/content-code-examples/tutorials/azure/docker-build.sh
# Replace <DOCKER_ID> with your Docker Hub username or ACR login server
docker build --tag <DOCKER_ID>/ironpdf-azure-functions:v1.0.0 .

ビルドはDockerfileに記載されたLinuxパッケージをインストールし、JARをコピーして、最終イメージにすべてをレイヤー化します。 最初のビルドではパッケージのダウンロードとレイヤーキャッシュが確立されるため数分かかることがあります。 同じベースイメージを使用する後続のビルドはかなり高速です。

ステップ3 — Docker Hubにイメージをプッシュする：

//:path=/static-assets/pdf/content-code-examples/tutorials/azure/docker-push.sh
# Authenticate if not already logged in
docker login

# Push the image to the registry
docker push <DOCKER_ID>/ironpdf-azure-functions:v1.0.0

//:path=/static-assets/pdf/content-code-examples/tutorials/azure/docker-push.sh
# Authenticate if not already logged in
docker login

# Push the image to the registry
docker push <DOCKER_ID>/ironpdf-azure-functions:v1.0.0

関数をAzureにどのようにデプロイしますか？

イメージがレジストリにある場合、Azure Function Appを作成（または更新）してそれを参照することができます。 az functionapp createコマンドは、Function Appをプロビジョニングし、それをストレージアカウントにリンクし、コンテナイメージを一歩で設定します。

ステップ1 — Function Appを作成または更新する：

//:path=/static-assets/pdf/content-code-examples/tutorials/azure/az-deploy.sh
az functionapp create \
  --name <APP_NAME> \
  --storage-account <STORAGE_NAME> \
  --resource-group AzureFunctionsContainers-rg \
  --plan myPremiumPlan \
  --deployment-container-image-name <DOCKER_ID>/ironpdf-azure-functions:v1.0.0

//:path=/static-assets/pdf/content-code-examples/tutorials/azure/az-deploy.sh
az functionapp create \
  --name <APP_NAME> \
  --storage-account <STORAGE_NAME> \
  --resource-group AzureFunctionsContainers-rg \
  --plan myPremiumPlan \
  --deployment-container-image-name <DOCKER_ID>/ironpdf-azure-functions:v1.0.0

Function Appのグローバルに一意の名前を<STORAGE_NAME>に、前のステップで使用したDocker Hubユーザー名またはACRログインサーバーを<DOCKER_ID>に置き換えます。

--plan myPremiumPlanフラグは、プレミアムホスティングプランを選択します。 IronPDFのChromiumエンジンはレンダリング中にかなりのメモリを消費します； 消費プランの1.5 GBメモリ上限では十分ではないことが多いです。 プレミアムプランは少なくとも3.5 GBを提供し、コールドスタート遅延を排除するために予備のインスタンスをサポートします。

ステップ2 — デプロイメントを確認する：

//:path=/static-assets/pdf/content-code-examples/tutorials/azure/az-verify.sh
# Check that the function app is running and the container has been pulled
az functionapp show \
  --name <APP_NAME> \
  --resource-group AzureFunctionsContainers-rg \
  --query "state"

//:path=/static-assets/pdf/content-code-examples/tutorials/azure/az-verify.sh
# Check that the function app is running and the container has been pulled
az functionapp show \
  --name <APP_NAME> \
  --resource-group AzureFunctionsContainers-rg \
  --query "state"

コンテナが正常に起動したときに"Running"がコマンドとして返されます。 それが"Starting"またはエラーを返した場合、Azure ポータルの Function App の Log Stream でコンテナのプルまたは起動エラーを確認してください。

関数をどのようにトリガーしてテストしますか？

Function AppがRenderPdfエンドポイントはリクエストを受け入れる準備が整います。 エンドポイントのURLは、Function App名および@FunctionNameアノテーションで定義された関数名に基づいた予測可能なパターンに従います。

ブラウザまたはcurlを使用してテストする：

//:path=/static-assets/pdf/content-code-examples/tutorials/azure/test-request.sh
# Replace <APP_NAME> with the Function App name
curl -o output.pdf \
  "https://<APP_NAME>.azurewebsites.net/api/RenderPdf?url=https://www.example.com"

//:path=/static-assets/pdf/content-code-examples/tutorials/azure/test-request.sh
# Replace <APP_NAME> with the Function App name
curl -o output.pdf \
  "https://<APP_NAME>.azurewebsites.net/api/RenderPdf?url=https://www.example.com"

正常な応答は、output.pdfという名前のPDFファイルを現在のディレクトリに保存します。 curl の-oフラグは、バイナリ応答ボディをファイルに書き込み、端末には表示しません。

ブラウザでテストする場合は、以下のURLに移動します：

https://<APP_NAME>.azurewebsites.net/api/RenderPdf?url=https://www.example.com

ブラウザはPDFのダウンロードを促します。 それを開いてページが正しくレンダリングされたかどうかを確認します。

エラーのログを確認する：Azureポータルに移動し、Function Appを開き、監視の下のLog Streamを選択します。 context.getLogger() 呼び出しからのログエントリは、ほぼリアルタイムでここに表示されるため、レンダリングの失敗を診断するのが簡単です。

次のステップは何ですか?

このガイドでは、IronPDF for JavaをAzure Functions Dockerコンテナ内に展開し、URLをPDFとしてレンダリングするHTTPトリガー関数を作成し、必要なLinux依存関係でDockerfileを設定し、ライブエンドポイントをテストする方法を示しました。 同じパターンは、わずかな変更でより高度なユースケースに拡張できます。

関数を拡張する：

• URLではなくPdfDocument.renderHtmlAsPdf(htmlString)を使用してHTML文字列を直接レンダリングする
• 透かしを適用したり、複数のPDFをマージしたり、IronPDFのフルJava PDF API を使用してデジタル署名を追加することができます
• リクエストヘッダーまたはPOSTボディを読み取って、カスタムHTMLコンテンツやレンダリングオプションを渡す

本番準備を改善する：

• FUNCTIONに切り替え、関数キーを定期的に回転させる
• Azure Key Vaultを使用して、アプリケーション設定で参照されている機密情報を保存します
• レンダリングの遅延と失敗率のエンドツーエンドの可視性を確保するためにApplication Insightsを構成する
• Dockerイメージの更新webhookを設定して、Azureが新しいイメージバージョンのプッシュを自動で再展開

さらに多くのIronPDF for Javaガイドを探索する：

• IronPDF for Java: Linuxインストールガイド
• JavaでHTMLからPDFを生成
• IronPDF for Java: Docker展開ガイド
• IronPDFのフルJava APIリファレンス

無料のIronPDFトライアルを開始して、評価期間中に透かしなしでレンダリングおよび操作機能にアクセスします。 本番環境への展開の準備が整ったら、IronPDFライセンスオプションを表示し、プロジェクトの規模に合ったプランを見つけてください。