# Azure App Service Linux'te Soğuk Başlatmada Chrome Renderer Başarısız Oluyor
Bu sorun, Azure App Service Linux'te, Azure'un altta yatan Oryx/Ubuntu tabanlı görüntüyü güncellemesi ve IronPDF'nin Chrome render'ının bağımlı olduğu paylaşılan kütüphaneleri kaldırmasıyla meydana gelir. Sonraki soğuk başlatmada, IronPDF bu yerel Chrome bağımlılıklarını sıfırdan yeniden yüklemek zorundadır, bu işlem 5 dakikaya kadar sürebilir. Uygulama başlatma zaman aşımı çok kısa olduğunda, kurulum kesintiye uğrar ve render başaramaz.
Hata genellikle şu şekilde görünür:
```txt
libnss3.so: cannot open shared object file: No such file or directory
```
Azure, App Service Linux ortamlarının kullandığı taban görüntüsünü periyodik olarak günceller. Bu güncellemeler, Chrome'un ihtiyaç duyduğu `libnss3.so` gibi paylaşılan kütüphaneleri kaldırabilir. Bu olduğunda, IronPDF'nin `LinuxAndDockerDependenciesAutoConfig` mekanizması, başlatma sırasında gerekli paketleri yeniden yüklemeye çalışır. Eğer servis zaman aşımı, bu yüklemeyi tamamlamak için gereken süreden kısa ise, işlem Chrome hazır olmadan önce kesilir.
Bu sorun, aşağıdaki ortamda doğrulandı:
- **Etkilenen sürüm:** IronPDF 2026.4.1
- **Etkilenmeyen sürüm:** IronPDF 2026.5.2
- **Barındırma:** Azure App Service P0v3 planı, Norveç Doğu bölgesi
- **Çalışma zamanı:** .NET 10
## Çözüm
### Çözüm 1: Başlatma ayarlarını uygulayın ve başlatma zaman aşımını artırın
Uygulama başlatmada, herhangi bir PDF render çağrısından önce, aşağıdaki başlatma kodunu ekleyin:
```csharp
Logger.LoggingMode = Logger.LoggingModes.All;
Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
Installation.Initialize();
```
`LinuxAndDockerDependenciesAutoConfig` değerini `true` olarak ayarlamak, IronPDF'ye eksik Linux bağımlılıklarını otomatik olarak tespit edip yüklemesi gerektiğini söyler. `ChromeGpuMode` değerini `IronPdf.Engines.Chrome.ChromeGpuModes.Disabled` olarak ayarlamak, Azure App Service Linux ortamlarında bulunmayan GPU hızlandırmasını kapatır. Tam günlüklemeyi etkinleştirmek, bağımlılık yükleme adımında herhangi bir hatayı yakalamaya yardımcı olur.
Sonraki adım olarak, Azure App Service başlatma zaman aşımını en az 10 dakikaya artırın. Bu, Azure tabanlı görüntü güncellemesini takip eden soğuk başlatma sırasında IronPDF'nin bağımlılık yeniden yüklemesini tamamlamasına yetecek zamanı verir. App Service yapılandırmasında başlatma zamanı sınırlama ayarını nasıl ayarlayacağınıza dair talimatlar için [Azure dağıtım kılavuzunu](/get-started/azure/) inceleyin.
### Çözüm 2: IronPDF 2026.5.2'ye veya daha sonraki bir sürüme yükseltin
IronPDF 2026.5.2 veya daha sonraki bir sürüme yükseltilmesi bu sorunu çözer. Etkilenmeyen sürüm, Azure tabanlı görüntü güncellemelerinin paylaşılan kütüphaneleri kaldırdığı durumu, soğuk başlatma hatasına neden olmadan ele alır.
[[n:(Bu sorun IronPDF 2026.5.2'de çözüldü. Bu sürümde veya daha sonra iseniz, Çözüm 1'deki geçici çözümler artık gerekli değildir.)]]
Bu sorun, Azure App Service Linux'te, Azure'un altta yatan Oryx/Ubuntu tabanlı görüntüyü güncellemesi ve IronPDF'nin Chrome render'ının bağımlı olduğu paylaşılan kütüphaneleri kaldırmasıyla meydana gelir. Sonraki soğuk başlatmada, IronPDF bu yerel Chrome bağımlılıklarını sıfırdan yeniden yüklemek zorundadır, bu işlem 5 dakikaya kadar sürebilir. Uygulama başlatma zaman aşımı çok kısa olduğunda, kurulum kesintiye uğrar ve render başaramaz.
Hata genellikle şu şekilde görünür:
libnss3.so: cannot open shared object file: No such file or directory
libnss3.so: cannot open shared object file: No such file or directory
Text
Azure, App Service Linux ortamlarının kullandığı taban görüntüsünü periyodik olarak günceller. Bu güncellemeler, Chrome'un ihtiyaç duyduğu libnss3.so gibi paylaşılan kütüphaneleri kaldırabilir. Bu olduğunda, IronPDF'nin LinuxAndDockerDependenciesAutoConfig mekanizması, başlatma sırasında gerekli paketleri yeniden yüklemeye çalışır. Eğer servis zaman aşımı, bu yüklemeyi tamamlamak için gereken süreden kısa ise, işlem Chrome hazır olmadan önce kesilir.
Bu sorun, aşağıdaki ortamda doğrulandı:
Etkilenen sürüm: IronPDF 2026.4.1
Etkilenmeyen sürüm: IronPDF 2026.5.2
Barındırma: Azure App Service P0v3 planı, Norveç Doğu bölgesi
Çalışma zamanı: .NET 10
Çözüm
Çözüm 1: Başlatma ayarlarını uygulayın ve başlatma zaman aşımını artırın
Uygulama başlatmada, herhangi bir PDF render çağrısından önce, aşağıdaki başlatma kodunu ekleyin:
Option Strict On
Option Infer On
Logger.LoggingMode = Logger.LoggingModes.All
Installation.LinuxAndDockerDependenciesAutoConfig = True
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
Installation.Initialize()
LinuxAndDockerDependenciesAutoConfig değerini true olarak ayarlamak, IronPDF'ye eksik Linux bağımlılıklarını otomatik olarak tespit edip yüklemesi gerektiğini söyler. ChromeGpuMode değerini IronPdf.Engines.Chrome.ChromeGpuModes.Disabled olarak ayarlamak, Azure App Service Linux ortamlarında bulunmayan GPU hızlandırmasını kapatır. Tam günlüklemeyi etkinleştirmek, bağımlılık yükleme adımında herhangi bir hatayı yakalamaya yardımcı olur.
Sonraki adım olarak, Azure App Service başlatma zaman aşımını en az 10 dakikaya artırın. Bu, Azure tabanlı görüntü güncellemesini takip eden soğuk başlatma sırasında IronPDF'nin bağımlılık yeniden yüklemesini tamamlamasına yetecek zamanı verir. App Service yapılandırmasında başlatma zamanı sınırlama ayarını nasıl ayarlayacağınıza dair talimatlar için Azure dağıtım kılavuzunu inceleyin.
Çözüm 2: IronPDF 2026.5.2'ye veya daha sonraki bir sürüme yükseltin
IronPDF 2026.5.2 veya daha sonraki bir sürüme yükseltilmesi bu sorunu çözer. Etkilenmeyen sürüm, Azure tabanlı görüntü güncellemelerinin paylaşılan kütüphaneleri kaldırdığı durumu, soğuk başlatma hatasına neden olmadan ele alır.
Önemli: Bu sorun IronPDF 2026.5.2'de çözüldü. Bu sürümde veya daha sonra iseniz, Çözüm 1'deki geçici çözümler artık gerekli değildir.
Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.
