GoogleクラウドでIronPDF for Javaを実行する方法

Google Cloud FunctionsへのIronPDF for Javaの展開には、非デフォルト構成が必要です。IronPDFはHTMLをPDFにレンダリングするためにバンドルされたChromiumバイナリに依存するためです。 このガイドでは、Google Cloud Functions上のカスタムDockerコンテナ内でIronPDFを実行するために必要なすべての手順を解説します。これには、適切な依存関係（pom.xml）から、実行時の権限やリソース設定までが含まれます。

この問題は、既にGoogle Cloud FunctionsとDockerに慣れている場合には気にしなくても大丈夫です。 設定変更は簡単です。デフォルトの関数イメージをカスタムDockerfileに置き換え、Linuxエンジンの依存関係を追加し、リソース制限を調整し、作業ディレクトリを設定します。 各ステップは以下に説明されています。

Quickstart: Google CloudでIronPDF for Javaをデプロイする

最小限の動作環境には、カスタム Dockerfile（デフォルトの Cloud Function イメージには Chrome のシステム依存関係が含まれていないため）、ironpdf-engine-linux-x64 内の pom.xml アーティファクト、および /tmp/ を指す作業ディレクトリが必要です。 以下のコードは、関数エントリーポイントでエンジン作業ディレクトリを設定する方法を示しています。

//:path=/static-assets/pdf/content-code-examples/tutorials/google-cloud/configure-working-directory.java
import com.ironsoftware.ironpdf.設定s;
import java.nio.file.Paths;

// Point IronPDF at a writable directory in the Cloud Function runtime
設定s.setIronPdfEngineWorkingDirectory(Paths.get("/tmp/"));

//:path=/static-assets/pdf/content-code-examples/tutorials/google-cloud/configure-working-directory.java
import com.ironsoftware.ironpdf.設定s;
import java.nio.file.Paths;

// Point IronPDF at a writable directory in the Cloud Function runtime
設定s.setIronPdfEngineWorkingDirectory(Paths.get("/tmp/"));

作業ディレクトリを設定した後、IronPDFはCloud Functionの一時ファイルシステム内でエンジンバイナリを抽出して実行することができます。 /tmp/ ディレクトリは、ほとんどの Google Cloud Function ランタイムで利用可能な、書き込みおよび実行が可能な唯一のパスです。

目次

• なぜデフォルトのCloud Functionイメージは機能しないのですか？
• Google Cloud用のカスタムDockerfileをどうやって構築しますか？
• Google Cloudデプロイメント用にpom.xmlをどのように設定しますか？
• Maven Shade Pluginをどのように追加しますか？
• オプションのgRPC依存関係をどのように追加しますか？
• Google Cloud Functionsのリソース制限をどのように設定しますか？
• 作業ディレクトリとファイル権限をどのように設定しますか？
• 次のステップは何ですか？

なぜデフォルトのCloud Functionイメージは機能しないのですか？

デフォルトのGoogle Cloud Functionランタイムイメージは、設計上最小限で、一般的な言語で書かれた関数コードを実行するために必要なパッケージのみを含んでいます。 IronPDFのChromiumベースのレンダリングエンジンは、標準イメージには存在しないLinuxのより広範なシステムライブラリ（フォント、グラフィックライブラリ、サンドボックスツール）に依存しています。

Googleは、各ランタイムの利用可能なシステムパッケージの完全なリストをGoogle Cloud Functionsシステムパッケージリファレンスで公開しています。 Chromiumの依存関係は、標準の第2世代ランタイムのいずれにも含まれていません。 デフォルトイメージでIronPDFエンジンをロードしようとすると、スタートアップ時にネイティブライブラリのロードに失敗します。

解決策は、それらのパッケージを関数バイナリが追加される前に明示的にインストールするカスタムDockerイメージを構築することです。 このアプローチはGoogle Cloud Functionsで完全にサポートされており、ネイティブバイナリを必要とする関数には推奨される戦略と同じです。 含めるパッケージの完全なリストについては、IronPDF Linuxデプロイメントガイドを参照してください。

Google Cloud用のカスタムDockerfileをどのように構築しますか？

カスタムDockerfileは、ランタイム環境を完全に制御します。 公式のGoogle Cloud Functions Javaベースイメージから開始し、Chromiumが必要とするシステムライブラリをインストールします。

以下のDockerfileは推奨パターンを示しています。 COPY および CMD のエントリを、ご自身の機能プロジェクトの詳細に置き換えてください：

//:path=Dockerfile
# Use the official Google Cloud Functions Java 17 base image
FROM gcr.io/google-appengine/java17:latest

# Install Chrome system dependencies required by IronPDF's rendering engine
RUN apt-get update && apt-get install -y \
    libglib2.0-0 \
    libnss3 \
    libatk1.0-0 \
    libatk-bridge2.0-0 \
    libcups2 \
    libdrm2 \
    libxkbcommon0 \
    libxcomposite1 \
    libxdamage1 \
    libxfixes3 \
    libxrandr2 \
    libgbm1 \
    libasound2 \
    libpango-1.0-0 \
    libpangocairo-1.0-0 \
    --no-install-recommends \
    && rm -rf /var/lib/apt/lists/*

# Grant execute permissions on /tmp so the IronPDF engine can extract there
RUN chmod 777 /tmp/

# Copy the compiled JAR and set the entry point
COPY target/your-function.jar /app/function.jar
CMD ["java", "-jar", "/app/function.jar"]

chmod 777 /tmp/ 行は、IronPDF が初期化時にエンジンバイナリを書き込んで実行する必要があるため、必須です。 作業ディレクトリに実行権限がない場合、エンジンは起動しません。

Google Cloudデプロイメント用にpom.xmlをどのように設定しますか？

標準の ironpdf Maven アーティファクトには、複数のプラットフォーム向けのエンジンバイナリがバンドルされています。 Linux x86-64で実行されるGoogle Cloud Functions用に、プラットフォーム固有のエンジンアーティファクトを追加して、デプロイメントイメージをスリムに保ち、常に正しいバイナリが利用可能であることを保証します。

//:path=pom.xml
<dependencies>

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

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

//:path=pom.xml
<dependencies>

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

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

常にバージョン番号を最新のIronPDF for Javaリリースに更新してください。 ironpdf-engine-linux-x64 アーティファクトは、コアとなる ironpdf アーティファクトのバージョンと完全に一致している必要があります。

Maven Shade Pluginをどのように追加しますか？

Google Cloud Functions に uber-JAR（fat JAR）としてデプロイする場合、maven-shade-plugin により、すべての推移的依存関係からのサービスローダーファイルが正しくマージされることが保証されます。 それがないと、一部のgRPCサービス登録が静かにドロップされ、エンジンの初期化が失敗する原因となります。

<build><plugins> セクションに、以下のプラグイン設定を追加してください：

//:path=pom.xml
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.2.4</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>

            <configuration>
                <transformers>
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
                </transformers>
            </configuration>
        </execution>
    </executions>
</plugin>

//:path=pom.xml
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.2.4</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>

            <configuration>
                <transformers>
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
                </transformers>
            </configuration>
        </execution>
    </executions>
</plugin>

ServicesResourceTransformer が重要な部分です。 これは、すべての依存関係JARに含まれるServiceLoaderメカニズムを使用するため、実行時にトランスポートの選択（HTTP/2対プレーンテキスト）が機能するには、マージされたサービスファイルが必要です。

オプションのgRPC依存関係をどのように追加しますか？

特定のGoogle Cloud Functionsフレームワークのバージョンを使用している場合に、明示的なgRPCトランスポート依存関係が必要となる場合があります。 関数がgRPCトランスポートまたはチャネルエラーで起動に失敗する場合、以下を追加してください。

//:path=pom.xml
<dependencies>

    <dependency>
        <groupId>io.perfmark</groupId>
        <artifactId>perfmark-api</artifactId>
        <version>0.26.0</version>
    </dependency>

    <dependency>
        <groupId>io.grpc</groupId>
        <artifactId>grpc-okhttp</artifactId>
        <version>1.50.2</version>
    </dependency>

    <dependency>
        <groupId>io.grpc</groupId>
        <artifactId>grpc-netty-shaded</artifactId>
        <version>1.50.2</version>
    </dependency>
</dependencies>

//:path=pom.xml
<dependencies>

    <dependency>
        <groupId>io.perfmark</groupId>
        <artifactId>perfmark-api</artifactId>
        <version>0.26.0</version>
    </dependency>

    <dependency>
        <groupId>io.grpc</groupId>
        <artifactId>grpc-okhttp</artifactId>
        <version>1.50.2</version>
    </dependency>

    <dependency>
        <groupId>io.grpc</groupId>
        <artifactId>grpc-netty-shaded</artifactId>
        <version>1.50.2</version>
    </dependency>
</dependencies>

ほとんどの場合、grpc-netty-shadedを含めるだけで本番環境での使用に十分です。 grpc-okhttp トランスポートは、画像サイズの最小化が優先される場合に役立つ、より軽量な代替手段です。 トレース注釈の欠落に関するクラスパス警告が発生した場合にのみ、perfmark-apiを追加してください。

Google Cloud Functionsのリソース制限をどのように設定しますか？

IronPDFは最初の呼び出しでCloud Functionコンテナ内でChromiumサブプロセスを起動します。 Chromiumの起動および初期レンダリングはメモリを大量に使用し、エンジンが初期化するまで関数が長い間生き残る必要があります。Cloud Functionsのデフォルトのリソース制限は、信頼性の高い運用に十分ではありません。

関数をデプロイする際、Google Cloud Console または gcloud CLI を使用して、以下の制限を設定してください：

これらの値は開始点です。 高ボリュームまたは複雑なPDF生成には、より高いメモリアロケーションが必要になる場合があります。 Google Cloud ConsoleでCloud Functionのメモリ使用量メトリクスを監視し、メモリ不足エラーが観察される場合は制限を増やしてください。

作業ディレクトリとファイル許可をどのように構成しますか？

IronPDFエンジンは、起動時にバイナリを作業ディレクトリに展開します。Google Cloud Functionsでは、書き込みおよび実行可能なパスは /tmp/ のみです。 任意のIronPDF APIを呼び出す前に作業ディレクトリを明示的に設定し、Dockerfileがそのパスに必要な権限を与えていることを確認してください。

PDF操作の前に、関数エントリーポイントの一番上にこの設定呼び出しを追加してください。

//:path=/static-assets/pdf/content-code-examples/tutorials/google-cloud/configure-working-directory.java
import com.ironsoftware.ironpdf.設定s;
import java.nio.file.Paths;

public class PdfFunction {
    static {
        // Must be called before any IronPDF operation.
        // /tmp/ is the only writable and executable directory in Cloud Functions.
        設定s.setIronPdfEngineWorkingDirectory(Paths.get("/tmp/"));
    }
}

//:path=/static-assets/pdf/content-code-examples/tutorials/google-cloud/configure-working-directory.java
import com.ironsoftware.ironpdf.設定s;
import java.nio.file.Paths;

public class PdfFunction {
    static {
        // Must be called before any IronPDF operation.
        // /tmp/ is the only writable and executable directory in Cloud Functions.
        設定s.setIronPdfEngineWorkingDirectory(Paths.get("/tmp/"));
    }
}

その後、対応する権限コマンドをDockerfileに追加してください。

//:path=Dockerfile
# Ensure the IronPDF engine can extract and run binaries from /tmp/
RUN chmod 777 /tmp/

static {} イニシャライザブロックを使用することで、関数内のどのクラスも IronPDF エンジンの読み込みを試みる前に、作業ディレクトリが確実に設定されます。インスタンスメソッドやリクエストハンドラ内でこれを設定した場合、パスが設定される前に別のスレッドによってエンジンが初期化されてしまうリスクがあります。