Uygulamayı On-Prem’de Yayınlayın

1. Kuika platformuna giriş yaptıktan sonra “Configuration Manager” modülüne gidin.

2. Connection Settings alanından “DB Connection String” ayarlarını yaparak uygulamanının sunucuya erişimini sağlayın. Ayarları yapmak için Configuration Manager içeriğimize göz atabilirsiniz. 
3. “Backend URL” içerisine backendinizi ayağa kaldırmak üzere ayarlamış olduğunuz URL’i ekleyin.
4. Ardından “SAVE” butonu ile ayarları kaydedin. 

1. Sağ üst kenardaki roket ikonuna ardından “Web” seçeneğini işaretleyerek “Publish” butonuna tıklayın.
2. Yayınlama işlemi tamamlandığında, hem frontend (UI) hem de backend mail paketleri oluşturulur ve belirttiğiniz e-posta adresine ZIP formatında iletilir.
3. Ulaşan mail paketlerini IIS için standart olan C:\inetpub\wwwroot\ dizini altında oluşturmuş olduğunuz frontend ve backend klasörlerine zip içerisinden çıkartarak kopyalayın.

• URL Rewrite ve .NET 6 Hosting Bundle kurulumunu gerçekleştirin. Bu adımlar, IIS üzerinde uygulamanızın düzgün çalışması için gereklidir. 

IIS üzerinde yeni bir uygulama oluşturun:

Frontend Kurulumu

1. Siteler > Web Sitesi Ekle yolunu takip edin.
2. Site adını belirtin, fiziksel yol olarak C:\inetpub\wwwroot\ altına yüklediğiniz frontend dosyalarını seçin.

Frontend kurulumu için Web UI klasörü seçilmelidir. 

3. SSL sertifikası kullanıyorsanız, bağlantı türünü HTTPS olarak seçin ve 443 portunu belirtin.
4.  Ana bilgisayar adı olarak uygulamanızın domain ismini girin.

“Sunucu adı gösterimi iste” seçeneği mutlaka işaretlenmelidir, çünkü bu sayede hangi portun hangi URL’e yönlendirileceği belirlenebilir.

5. HTTPS protokolü kullanılıyor ise, SSL Sertifikası alanından sunucunuza eklemiş olduğunuz SSL sertifikasını seçerek devam edin. 
6. Frontend’in çalıştığından emin olmak için IIS’in sağ panelinde bulunan “Web sitesine gözat” kısmındaki linke tıklayın. 

Böylece Frontend’in çalıştığını görebilirsiniz. 

Backend Kurulumu

1. Benzer adımlarla backend için de yeni bir site oluşturun ve farklı bir domain girin.
2. Site adını belirtin, fiziksel yol olarak C:\inetpub\wwwroot\ altına yüklediğiniz backend dosyalarını seçin.
3. SSL sertifikası kullanıyorsanız, bağlantı türünü HTTPS olarak seçin ve 443 portunu belirtin.
4.  Ana bilgisayar adı olarak backend için belirlediğiniz domain ismini girin.
5. Uygulama havuzları kısmından backend için oluşturulan uygulama havuzuna sağ tıklayarak Temel Ayarlar> Uygulama Havuzu Düzenle> Net CLR Sürümü > Yönetilen kod yok olarak ayarlayın. 
6. Backend’in çalıştığından emin olmak için IIS’in sağ panelinde bulunan “Web sitesine gözat” kısmındaki linke tıklayın. 
7. Linke “/swagger” ekleyerek backend’in çalışıp çalışmadığını kontrol edin.

Böylece Backend’in çalıştığını görebilirsiniz. 

1. URL Rewrite’da kural ismi çakışmaları: 

Bir Frontend altında ikinci bir Frontend çalıştırmak istendiğinde (Virtual Application) her bir Frontend’in web config ayarlarında URL Rewrite kuralı aynı isme sahip olduğunda hataya sebep olabilir. Bu durumda iç ya da dış uygulamanın URL Rewrite kural ismini değiştirerek hatayı giderebilirsiniz. 

• Bilgisayarınızdaki IIS klasörüne gidin. 
• Frontend klasöründen “Web Config” dosyasını açın.
• Rule Name > React Router Routes ismini değiştirin. Böylece iki isim aynı olmadığında çalışır duruma gelecektir. 

2. Klasör yetkilendirme sorunu: 

Sunucu ilk kurulduğunda IIS sonradan kurulduysa “inetpub” klasöründeki erişimler eksik olabilir. 

• Bunu düzeltmek için Frontend ve Backend klasörlerine sağ tıklayın. 
• Özellikler > Güvenlik > IIS> Users alanından IIS Kullanıcısını ekleyip “Tam Denetim” izni verin. 

3. Backend 500.30 hatası:

• Connection String kaynaklı hatalar:some text
  • Bilgisayarınızdaki IIS backend klasörüne gidin.  
  • Appsetting.json dosyasından “Kuikaappdb ve Kuikacommondb” alanlarını kontrol edin ve eksik alanları düzeltin. 
• Sunucu iletişim problemleri:some text
  • Uygulama sunucunuzun Database sunucunuza erişim izinlerinin olduğundan emin olun.
• Yanlış .NET 6 paketi:some text
  • https://dotnet.microsoft.com/en-us/download/dotnet/6.0 adresinden ASP.NET Core Runtime - Windows - Hosting Bundle paketini indirin.
• Hatalı uygulama havuzu ayarı:

• IIS üzerinde Uygulama Havuzları alanını açın.
• Backendiniz için kullanılan Uygulama Havuzu’na sağ tıklayın ve Temel Ayarlar’ı açın.
• “.NET CLR Sürümü” değeri için “Yönetilen Kod Yok” seçeneğini seçin.

4. “Network Error” hatası:

• Uygulamanızı Publish alırken Configuration Manager - Backend URL alanına doğru URL’i girdiğinizden emin olun.
• Publish sonrası Backend URL değişikliği için:some text
  • Frontend’in hangi Backend URL’ye istek attığına bakmak için F12 tuşuna basın ve Developer Tool’u açın. 
  • Network alanına geçiş yapın. Başarısız isteklerdeki başlık alanından URL kısmını kontrol edin.  
  • Eğer frontend’in backend URL'ine doğru şekilde erişemediğini fark ederseniz, bilgisayarınızdaki frontend klasörüne gidin.
  • env-config.js dosyasındaki “ENV_TEST” kısmını BACKEND_URL: “https://istediğinizalanadı/v1/api” ve swagger URL dizinini girerek gerekli düzenlemeleri yapın.
  • IIS’e geri dönün. Frontend’in uygulama havuzunu yeniden başlatın. 

Doğru URL’e yine gitmiyorsa Cache Temizliği yaparak tarayıcı üzerinde yapılan güncellemelerin yansıdığından emin olun.

Bu eğitim içeriğinde, Kuika platformu üzerinde IIS (Internet Information Services) kullanarak uygulamanızın ilk yükleme süresini iyileştirmek için uygulama havuzu ayarlarınızı nasıl yapacağınızı öğreneceksiniz. 

1. IIS Manager’ı açın.
2. Sol taraftaki menüden sunucu adınızı genişletin ve “Application Pools” seçeneğine tıklayın. 
3. Kuika uygulamanızın çalıştığı Application Pool’u listeden bulun. Üzerine sağ tıklayın ve “Advanced Settings” seçimini yapın.
4. Açılan pencerede “General” başlığı altındaki “Start Mode” ayarına gidin. Buradaki değeri “On Demand” yerine “Always Running” olarak değiştirin. Always Running modunda, uygulama havuzu sürekli olarak aktif kalır, bu da uygulamanın daha hızlı yüklenmesini sağlar. 
5. Ayarları uyguladıktan sonra pencereyi kapatın ve değişikliklerin etkili olması için IIS hizmetini yeniden başlatın. 

Eğer bu adımları uyguladıktan sonra hala sorun yaşıyorsanız, Kuika destek ekibi ile iletişime geçin.