How to Run IronPDF for Java in Google Cloud

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

Note : Nous n'avons pas entièrement testé la prise en charge de Google Cloud, mais si vous voulez essayer, nous avons quelques Paramètres requis.

Important : Paramètres requis

  • Le déploiement Zip n'est pas pris en charge, car IronPDF nécessite l'exécution des binaires au moment de l'exécution.
  • Les images Docker de Cloud Function par défaut ne fonctionnent pas car il leur manque les packages requis pour que Chrome s'exécute correctement. Pour plus d'informations, consultez les Google Cloud System Packages.
  • Veuillez utiliser un fichier Docker personnalisé et installer tous les paquets requis. Pour en savoir plus, consultez notre Guide de déploiement Linux.

  • Incluez la dépendance ironpdf-engine-linux-x64 à votre projet (modifiez le numéro de version pour qu'il soit le plus récent) :

    <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
  • Ce plugin peut être nécessaire :

    <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
  • Ces dépendances peuvent être nécessaires :

    <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
  • Définir timeout à 330 secondes en raison d'un démarrage lent.
  • Réglez la taille de la mémoire à au moins 2048 MB.
  • Définissez la taille de stockage éphémère à au moins 1024 MB.
  • Dans certains environnements, vous devrez peut-être indiquer un IronPdfEngineWorkingDirectory et définir des autorisations d'exécution pour celui-ci :

    // 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/

Questions Fréquemment Posées

Comment configurer une bibliothèque PDF pour Java sur Google Cloud ?

Pour configurer une bibliothèque PDF sur Google Cloud, utilisez un Dockerfile personnalisé pour installer tous les packages nécessaires comme détaillé dans le Guide de Déploiement Linux d'IronPDF. Incluez la dépendance ironpdf-engine-linux-x64 et configurez des réglages spécifiques pour des performances optimales.

Quels sont les réglages spécifiques nécessaires pour exécuter une bibliothèque PDF sur Google Cloud ?

Lors de l'exécution d'une bibliothèque PDF sur Google Cloud, utilisez un temps d'attente de 330 secondes, une taille de mémoire d'au moins 2048 Mo et une taille de stockage éphémère d'au moins 1024 Mo. De plus, définissez le IronPdfEngineWorkingDirectory et assurez-vous des autorisations d'exécution pour ce répertoire.

Pourquoi le déploiement Zip n'est-il pas pris en charge pour une bibliothèque PDF sur Google Cloud ?

Le déploiement Zip n'est pas pris en charge car IronPDF nécessite l'exécution de binaires à l'exécution, ce qui n'est pas faisable avec les méthodes de déploiement Zip standard.

Quelles dépendances supplémentaires sont nécessaires pour déployer une bibliothèque PDF sur Google Cloud ?

Les dépendances supplémentaires qui pourraient être nécessaires incluent perfmark-api, grpc-okhttp et grpc-netty-shaded. Celles-ci garantissent le bon fonctionnement de la bibliothèque lorsqu'elle est déployée.

Comment puis-je gérer les exigences de package pour une bibliothèque PDF dans des images Docker Google Cloud ?

Les images Docker par défaut de Google Cloud Functions manquent des packages nécessaires pour Chrome. Utilisez un Dockerfile personnalisé pour installer tous les packages requis, en suivant les instructions du Guide de Déploiement Linux d'IronPDF.

Existe-t-il un plugin Maven spécifique requis pour déployer une bibliothèque PDF dans des environnements Docker ?

Le maven-shade-plugin peut être requis pour les environnements Docker. Il doit être configuré pour utiliser des transformateurs, surtout lorsqu'il s'agit de dépendances complexes.

Comment puis-je définir le répertoire de travail pour un moteur PDF dans un environnement Docker ?

Vous pouvez définir le répertoire de travail pour le moteur PDF en utilisant Setting.setIronPdfEngineWorkingDirectory(Paths.get("/tmp/")). Assurez-vous de donner les permissions nécessaires avec une commande comme RUN chmod 777 /tmp/ dans votre Dockerfile.

Curtis Chau
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Lire la suite
Prêt à commencer?
Version : 2025.11 vient de sortir