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

This article was translated from English: Does it need improvement?
Translated
View the article in English

Note: We have not fully tested support with Google Cloud, but if you want to try, we have some Required Settings.

重要です:必要な設定

  • Zip デプロイメントはサポートされていません。IronPDF は実行時にバイナリの実行を必要とするためです。
  • デフォルトのクラウド関数 Docker イメージは動作しません。これは、Chrome を正常に動作させるために必要なパッケージが欠けているためです。 詳細については、Google Cloud システム パッケージを参照してください。
  • カスタム Dockerfile を使用し、すべての必要なパッケージをインストールしてください。 この詳細については、Linux デプロイメント ガイドをご覧ください。

  • プロジェクトにironpdf-engine-linux-x64依存関係を含めてください(バージョン番号を最新版に変更してください):

    <dependency>
      <groupId>com.ironsoftware</groupId>
      <artifactId>ironpdf-engine-linux-x64</artifactId>
      <version>2022.xx.x</version>
    </dependency>
    <dependency>
      <groupId>com.ironsoftware</groupId>
      <artifactId>ironpdf-engine-linux-x64</artifactId>
      <version>2022.xx.x</version>
    </dependency>
    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>
              <!-- required for Docker -->
              <configuration>
                  <transformers>
                      <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
                  </transformers>
              </configuration>
          </execution>
      </executions>
    </plugin>
    <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>
              <!-- required for Docker -->
              <configuration>
                  <transformers>
                      <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
                  </transformers>
              </configuration>
          </execution>
      </executions>
    </plugin>
    XML
  • これらの依存関係が必要になる場合がある

    <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>
    <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>
    XML
  • 起動が遅いのでタイムアウト330秒に設定してください。
  • メモリサイズを少なくとも2048 MBに設定してください。
  • 一時ストレージサイズを少なくとも1024 MBに設定してください。
  • 一部の環境では、IronPdfEngineWorkingDirectory を指す必要があり、そのための実行権限を設定する必要があります:

    // Set the working directory for the IronPDF Engine
    Setting.setIronPdfEngineWorkingDirectory(Paths.get("/tmp/"));
    // Set the working directory for the IronPDF Engine
    Setting.setIronPdfEngineWorkingDirectory(Paths.get("/tmp/"));
    JAVA
    # Grant full read/write/execute permissions to the /tmp directory
    RUN chmod 777 /tmp/

よくある質問

Google CloudでJava用のPDFライブラリをどのようにセットアップしますか?

Google CloudでPDFライブラリをセットアップするには、IronPDF Linux展開ガイドに詳細が記載されたカスタムDockerfileを使用して、必要なすべてのパッケージをインストールします。ironpdf-engine-linux-x64依存関係を含め、最適なパフォーマンスのために特定の設定を構成します。

Google CloudでPDFライブラリを実行するために必要な特定の設定は何ですか?

Google CloudでPDFライブラリを実行する際は、タイムアウトを330秒、メモリサイズを少なくとも2048 MB、エフェメラルストレージサイズを少なくとも1024 MBに設定します。さらに、IronPdfEngineWorkingDirectoryを設定し、そのディレクトリの実行権限を確保します。

なぜGoogle CloudにPDFライブラリでZip Deploymentがサポートされていないのですか?

IronPDFは実行時にバイナリの実行を必要とするため、標準のZipデプロイメントメソッドでは不可能であり、Zipデプロイメントはサポートされていません。

Google CloudでPDFライブラリをデプロイするために必要な追加の依存関係は何ですか?

必要となる可能性がある追加の依存関係には、perfmark-apigrpc-okhttp、およびgrpc-netty-shadedが含まれます。これらは、ライブラリが展開される際に適切な機能を確保します。

Google Cloud DockerイメージでPDFライブラリのためのパッケージ要件をどのように扱いますか?

デフォルトのクラウド関数DockerイメージにはChromeに必要なパッケージが不足しています。IronPDF Linux Deployment Guideの指示に従って、すべての必要なパッケージをインストールするカスタムDockerfileを使用してください。

Docker環境でPDFライブラリをデプロイするために特定のMavenプラグインが必要ですか?

maven-shade-pluginはDocker環境で必要となる場合があります。特に複雑な依存関係を扱う際にはトランスフォーマーを使用するように構成する必要があります。

Docker環境でPDFエンジンの作業ディレクトリをどのように設定しますか?

PDFエンジンの作業ディレクトリは、Setting.setIronPdfEngineWorkingDirectory(Paths.get("/tmp/"))を使用して設定できます。そのために、Dockerfile内でRUN chmod 777 /tmp/のようなコマンドを使用して必要な権限を付与します。

カーティス・チャウ
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT(Internet of Things)への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はできましたか?
バージョン: 2025.12 リリース