Google Cloud'da Java'da IronPDF'yi Çalıştırma

Varsayılan Bulut İşlevi Görüntüleri Neden Çalışmaz?

Varsayılan Google Cloud Function çalışma zamanı görüntüleri, yalnızca yaygın dillerde yazılmış işlev kodunu çalıştırmak için gereken paketleri içerir. IronPDF'in Chromium tabanlı işleme motoru, varsayılan görüntülerde bulunmayan daha geniş bir Linux sistem kütüphaneleri setine (fontlar, grafik kütüphaneleri, sanal alan araçları) bağlıdır.

Google, her çalışma zamanı için kullanılabilir sistem paketlerinin tam bir listesini Google Cloud Functions sistem paketleri referansında yayınlar. Chromium'un bağımlılıkları standart 2. nesil çalışma zamanlarının hiçbirine dahil edilmemiştir. IronPDF motorunu varsayılan görüntüde yüklemeye çalışmak, başlangıçta yerel kütüphane yükleme hatasına neden olur.

Çözüm, fonksiyon ikili dosyası eklenmeden önce bu paketleri açıkça kuran özel bir Docker görüntüsü oluşturmaktır. Bu yaklaşım, Google Cloud Functions tarafından tam olarak desteklenir ve yerel ikili dosyalar gerektiren herhangi bir fonksiyon için önerilen aynı stratejidir. Dahil edilecek paketlerin tam listesi için IronPDF Linux dağıtım kılavuzuna başvurun.

Google Cloud için Özel Bir Dockerfile Nasıl Oluşturulur?

Özel bir Dockerfile, çalışma ortamı üzerinde tam kontrol sağlar. Resmi Google Cloud Functions Java tabanlı görüntüsünden başlayın, ardından Chromium'un gerektirdiği sistem kütüphanelerini yükleyin.

Aşağıdaki Dockerfile önerilen deseni gösterir. COPY ve CMD girişlerini, işlev projenizin özellikleriyle değiştirin:

//: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/ satırı gereklidir, çünkü IronPDF'nin başlatma sırasında motor ikili dosyasını yazması ve çalıştırması gerekir. Çalışma dizininde yürütme izni olmaksızın, motor başlatılamaz.

Google Cloud Dağıtımı İçin pom.xml Nasıl Yapılandırılır?

Standart ironpdf Maven artefaktı, birden çok platform için motor ikili dosyalarını bir araya getirir. Google Cloud Functions (Linux x86-64 üzerinde çalışır) için, dağıtım görüntüsünü ince tutmak ve her zaman doğru ikili dosyanın kullanılmasını sağlamak için platforma özgü motor öğesini ekleyin:

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

Her zaman en son IronPDF for Java sürümüne sürüm numarasını güncelleyin. ironpdf-engine-linux-x64 artefaktı, çekirdek ironpdf artefaktının sürümüyle tam olarak eşleşmelidir.

Maven Shade Eklentisi Nasıl Eklenir?

Google Cloud Functions'a uber-JAR (fat JAR) olarak dağıtım yaparken, maven-shade-plugin tüm geçişli bağımlılıklardan gelen hizmet yükleyici dosyalarının doğru şekilde birleştirilmesini sağlar. Olmadan, bazı gRPC hizmet kayıtları sessizce düşebilir ve motorun başlatılamaz hale gelmesine neden olabilir.

Aşağıdaki eklenti yapılandırmasını <build><plugins> bölümüne ekleyin:

//: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 kritik öneme sahip bir parçadır. Her bağımlılık JAR'ındaki META-INF/services/ girişlerini tek bir birleştirilmiş dosyada birleştirir. gRPC, Java'nın ServiceLoader mekanizmasını kullanır, bu nedenle birleştirilmiş hizmet dosyaları, çalışma zamanında aktarım seçiminin (HTTP/2 ve düz metin) çalışması için gereklidir.

İsteğe Bağlı gRPC Bağımlılıkları Nasıl Eklenir?

Bazı dağıtım yapılandırmalarında — özellikle belirli Google Cloud Functions framework sürümleri kullanılırken gölgelendirilmiş bir JAR ile kullanılırken — gRPC taşıma bağımlılıkları gereklidir. Fonksiyon bir gRPC taşıma veya kanal hatası ile başlatılamazsa bunları ekleyin:

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

Çoğu durumda, grpc-netty-shaded eklemek üretim için yeterlidir. grpc-okhttp aktarımı, görüntü boyutunu en aza indirmek öncelikli olduğunda kullanışlı olan daha hafif bir alternatiftir. Yalnızca eksik izleme açıklamalarıyla ilgili sınıf yolu uyarılarıyla karşılaşırsanız perfmark-api ekleyin.

Google Cloud Functions için Kaynak Sınırları Nasıl Ayarlanır?

IronPDF, ilk çağrısı sırasında Cloud Function kapsayıcısı içinde bir Chromium alt sürecini başlatır. Chromium'un başlatılması ve ilk işleme belleği yoğundur ve motorun başlatılması için işlevin yeterince uzun süre canlı kalması gerekir. Cloud Functions için varsayılan kaynak limitleri güvenilir çalışma için çok düşüktür.

İşlevi dağıtırken Google Cloud Console'da veya gcloud CLI aracılığıyla aşağıdaki sınırları yapılandırın:

Bu değerler başlangıç noktalarıdır. Yüksek hacimli veya karmaşık PDF oluşturma, daha yüksek bellek tahsisleri gerektirebilir. Google Cloud Console'daki Cloud Function bellek kullanım metriklerini izleyin ve bellek hataları gözlemlerseniz sınırları artırın.

Çalışma Dizini ve Dosya İzinleri Nasıl Yapılandırılır?

IronPDF motoru, başlangıçta ikili dosyasını bir çalışma dizinine çıkarır. Google Cloud Functions'da, yazılabilir ve çalıştırılabilir tek yol /tmp/'dir. Herhangi bir IronPDF API çağrısından önce çalışma dizinini açıkça ayarlayın ve Dockerfile'ın o yol üzerinde gerekli izinleri verdiğinden emin olun.

İşlev giriş noktanızın üstüne aşağıdaki yapılandırma çağrısını ekleyin, herhangi bir PDF işleminden önce:

//:path=/static-assets/pdf/content-code-examples/tutorials/google-cloud/configure-working-directory.java
import com.ironsoftware.ironpdf.Ayars;
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.
        Ayars.setIronPdfEngineWorkingDirectory(Paths.get("/tmp/"));
    }
}

//:path=/static-assets/pdf/content-code-examples/tutorials/google-cloud/configure-working-directory.java
import com.ironsoftware.ironpdf.Ayars;
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.
        Ayars.setIronPdfEngineWorkingDirectory(Paths.get("/tmp/"));
    }
}

Ardından, Dockerfile'ınıza karşılık gelen izin komutunu ekleyin:

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

static {} başlatıcı bloğunu kullanmak, işlevinizdeki herhangi bir sınıf IronPDF motorunu yüklemeye çalışmadan önce çalışma dizininin yapılandırılmasını garanti eder. Bunu bir örnek yönteminde veya istek işleyicisinde ayarlarsanız, yol yapılandırılmadan önce başka bir iş parçacığının motoru başlatma riski vardır.

Bir Sonraki Adımlar Nelerdir?

Bu kılavuz, IronPDF for Java'yı bir Google Cloud Function içinde özel bir Docker konteyneri kullanarak çalıştırma konfigürasyonunun tamamını kapsar. Önemli noktalar şunlardır: Chrome sistem bağımlılıklarını yükleyen özel bir Dockerfile kullanın, ironpdf-engine-linux-x64 Maven artefaktını dahil etmek, çalışma dizinini /tmp/ olarak yapılandırmak, zaman aşımını en az 330 saniyeye ve belleği en az 2.048 MB'ye ayarlamak ve hizmet yükleyici dosyalarını birleştirmek için maven-shade-plugin eklemek.

IronPDF for Java'nın neler yapabileceğini daha fazla keşfetmek için IronPDF for Java belgelerine bakın veya bu kılavuzlardan birini deneyin:

• IronPDF for Java on Linux — Linux dağıtımları için Chrome bağımlılıklarının tam listesini anlayın
• IronPDF for Java on AWS Lambda — AWS için benzer Docker tabanlı dağıtım kılavuzu
• Java'da HTML'den PDF'e dönüştürme — İşlev mantığınız için temel işleme iş akışı

Ücretsiz deneme lisansı alın ve IronPDF for Java'yı Google Cloud ortamınızda test edin. Üretim dağıtımları için bir lisans anahtarı gereklidir. Yayınlamaya hazır olduğunuzda bir lisans satın alın.