Cómo ejecutar IronPDF for Java en 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.

Importante: Configuración necesaria

  • La implementación de Zip no es compatible, ya que IronPDF requiere la ejecución de binarios en tiempo de ejecución.
  • Las imágenes Docker predeterminadas de Cloud Function no funcionan porque carecen de los paquetes requeridos para que Chrome funcione correctamente. Para más información, consulta los Paquetes del Sistema de Google Cloud.
  • Utiliza un Dockerfile personalizado e instala todos los paquetes requeridos. Obtenga más información al respecto en nuestra Guía de implantación de Linux.

  • Incluya la dependencia ironpdf-engine-linux-x64 en su proyecto (cambie el número de versión al más reciente):

    <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
  • Este complemento puede ser requerido:

    <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>
    <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>
    XML
  • Estas dependencias pueden ser requeridas:

    <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
  • Establezca timeout en 330 seconds debido al inicio lento.
  • Establezca memory size en al menos 2048 MB.
  • Establezca Ephemeral Storage Size en al menos 1024 MB.
  • En algunos entornos, es posible que necesites señalar un IronPdfEngineWorkingDirectory y establecer permisos de ejecución para él:

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

Preguntas Frecuentes

¿Cómo configuro una biblioteca de PDF for Java en Google Cloud?

Para configurar una biblioteca de PDF en Google Cloud, utilice un Dockerfile personalizado para instalar todos los paquetes necesarios como se detalla en la Guía de Implementación de Linux de IronPDF. Incluya la dependencia ironpdf-engine-linux-x64 y configure configuraciones específicas para un rendimiento óptimo.

¿Cuáles son las configuraciones específicas necesarias para ejecutar una biblioteca de PDF en Google Cloud?

Al ejecutar una biblioteca de PDF en Google Cloud, use un tiempo de espera de 330 segundos, un tamaño de memoria de al menos 2048 MB y un tamaño de almacenamiento efímero de al menos 1024 MB. Además, configure el IronPDFEngineWorkingDirectory y asegúrese de los permisos de ejecución para ese directorio.

¿Por qué no se admite la implementación Zip para una biblioteca de PDF en Google Cloud?

La implementación Zip no es compatible porque IronPDF requiere la ejecución de binarios en tiempo de ejecución, lo que no es factible con los métodos estándar de implementación Zip.

¿Qué dependencias adicionales son necesarias para implementar una biblioteca de PDF en Google Cloud?

Las dependencias adicionales que podrían ser necesarias incluyen perfmark-api, grpc-okhttp, y grpc-netty-shaded. Estas aseguran el funcionamiento adecuado de la biblioteca cuando se implementa.

¿Cómo puedo manejar los requisitos de paquetes para una biblioteca de PDF en las imágenes de Docker de Google Cloud?

Las imágenes Docker de la función Cloud predeterminadas carecen de los paquetes necesarios para Chrome. Use un Dockerfile personalizado para instalar todos los paquetes necesarios, siguiendo las instrucciones en la Guía de Implementación de Linux de IronPDF.

¿Hay un plugin de Maven específico requerido para implementar una biblioteca de PDF en entornos Docker?

El maven-shade-plugin puede ser necesario para entornos Docker. Debe configurarse para usar transformadores, especialmente cuando se trata de dependencias complejas.

¿Cómo configuro el directorio de trabajo para un motor PDF en un entorno Docker?

Puede configurar el directorio de trabajo para el motor PDF utilizando Setting.setIronPDFEngineWorkingDirectory(Paths.get("/tmp/")). Asegúrese de otorgar los permisos necesarios con un comando como RUN chmod 777 /tmp/ en su Dockerfile.

Curtis Chau
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más
¿Listo para empezar?
Versión: 2026.3 recién lanzado
Still Scrolling Icon

¿Aún desplazándote?

¿Quieres una prueba rápida?
ejecutar una muestra Mira cómo tu HTML se convierte en PDF.