Comment exécuter IronPDF for Java dans Google Cloud

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.

Important : Paramètres requis

  • Le déploiement zip n'est pas pris en charge, car IronPDF nécessite l'exécution de binaires à l'exécution.
  • Les images Docker par défaut de Cloud Function ne fonctionnent pas car elles ne contiennent pas les packages nécessaires pour que Chrome fonctionne correctement. Pour plus d'informations, voir les Packages Systèmes Google Cloud.
  • Veuillez utiliser un Dockerfile personnalisé et installer tous les packages requis. Apprenez-en plus dans notre Guide de déploiement Linux.

  • Incluez la dépendance ironpdf-engine-linux-x64 à votre projet (changez le numéro de version par 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 requis :

    <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 requises :

    <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
  • Réglez le timeout sur 330 secondes en raison d'un démarrage lent.
  • Réglez la taille de la mémoire à au moins 2048 Mo.
  • Réglez la taille du stockage éphémère à au moins 1024 Mo.
  • Dans certains environnements, vous devrez peut-être pointer vers un IronPdfEngineWorkingDirectory et définir les permissions 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.12 vient de sortir