• Kuika platformuna giriş yapın.
• Configuration Manager modülünü açın.

• “Create a blank configuration” butonuna tıkladıktan sonra konfigürasyona isim verin. 
• Connection Settings alanında DB Connection String ayarlarını yaparak uygulamanın sunucuya erişimini sağlayın.

• Backend URL alanına backend URL’nizi ekleyin.
• SAVE butonuna tıklayarak ayarları kaydedin.

• Apps ekranından projeyi seçin.

• Preview butonunun yanındaki üç noktaya tıklayın ve seçeneğini seçin.
• Yayınlama tamamlandığında, frontend ve backend ZIP dosyaları belirtilen e-posta adresine gönderilir.
• ZIP dosyalarını IIS için standart dizin olan C:\inetpub\wwwroot\ klasörüne çıkarın.

IIS ve Gerekli Ortamların Hazırlanması

• İşletim Sistemi: Windows Server 2019
• Veritabanı: MS SQL Server 2019
• Web Sunucusu: IIS 10.0xx
• Donanım Gereksinimleri: 32 GB RAM, 16 VCPU, Xeon E5 2660 2.2 GHz
• SSL Sertifikaları: Her subdomain için sağlanmalıdır.
• Firewall: 80 ve 443 portlarına izin verin.
• Kurulumlar: URL Rewrite ve .Net8  Bundle kurulumlarını gerçekleştirin.

Uygulamayı IIS Üzerinde Oluşturma ve Yayınlama

Frontend Kurulumu: IIS > Siteler > Web Sitesi Ekle seçeneğine tıklayın.

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

• Site adı girin ve fiziksel yol olarak frontend dosyalarını seçin.
• SSL kullanıyorsanız HTTPS’yi seçin ve 443 portunu belirtin.
• Ana Bilgisayar Adı alanına domain ismini girin ve “Sunucu adı gösterimi iste” seçeneğini işaretleyin.
• Frontend’in çalıştığını kontrol etmek için IIS > Web sitesine gözat seçeneğini kullanın.

2. Backend Kurulumu:

• Benzer adımları izleyerek backend için yeni bir site oluşturun.
• SSL kullanıyorsanız HTTPS’yi seçin ve 443 portunu belirtin.

Uygulama Havuzu ayarlarında:

• Backend uygulama havuzuna sağ tıklayın, Temel Ayarlar > Yönetilen Kod Yok seçeneğini seçin.
• Backend’i test etmek için /swagger ekleyerek çalışıp çalışmadığını kontrol edin.

• URL Rewrite Kural İsim Çakışmaları:
  
  • Web Config dosyasını açın ve React Router Routes kural ismini değiştirin.
• Klasör Yetkilendirme:
  
  • Frontend ve Backend klasörlerine sağ tıklayıp, Güvenlik > IIS Users > Tam Denetim izni verin.
• Backend 500.30 Hatası:
  
  • Connection String: appsetting.json dosyasındaki Kuikaappdb ve Kuikacommondb alanlarını kontrol edin.
  • .NET 8 Paketi: https://dotnet.microsoft.com/en-us/download/dotnet/8.0 adresinden paketini kurun.
• 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.

• Network Error:
  
  • env-config.js dosyasını düzenleyerek BACKEND_URL alanına doğru URL’yi ekleyin.
  • IIS > Frontend uygulama havuzunu yeniden başlatın.
  • Publish sonrası Backend URL değişikliği için:
    
    • 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.

Uygulama Performansını Artırma: IIS Uygulama Havuzu Ayarları

• IIS Manager’ı açın.
• Application Pools sekmesinden uygulama havuzunu seçin.
• Sağ tıklayıp Advanced Settings > Start Mode değerini “Always Running” olarak ayarlayın.
• IIS hizmetini yeniden başlatın.

Bu adımları uyguladıktan sonra hala sorun yaşarsanız Kuika destek ekibiyle iletişime geçebilirsiniz.