Kullanıcı Kılavuzu

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

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

On-Prem, yazılımın şirketin kendi fiziksel altyapısında barındırılmasını sağlar. Bu eğitim içeriğinde, Configuration Manager modülü ile On-Prem’de uygulamanızı yayına almanın adımlarını öğreneceksiniz.

Bu eğitim içeriği aşağıdaki başlıklardan oluşur: 

  • Configuration Manager Ayarlarını Yapılandırma
  • Uygulamayı Yayınlama
  • Sıkça Sorulan Sorular

Configuration Manager Ayarlarını Yapılandırma

  • Kuika platformuna giriş yapın.
  • Configuration Manager modülünü açın.
  • 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.

Uygulamayı Yayınlama

  • Apps ekranından projeyi seçin.
  • Preview butonunun yanındaki üç noktaya tıklayın.
  • Karşınıza çıkan seçeneklerden "Web" işaretleyin ve ardından "Publish" butonuna basın.
    İşlem tamamlandığında, hem frontend hem de backend dosyalarınız bir ZIP paketi olarak e-posta adresinize gönderilecek.
  • İlk adım, IIS üzerinden frontend ve backend için klasörler oluşturmak. Bunun için, sunucunuzdaki C:\inetpub\wwwroot dizinine gidin ve iki ayrı klasör oluşturun: biri frontend, diğeri backend için.
  • Sonrasında, size gönderilen ZIP dosyalarını bu klasörlere açın ve dosyaları yerleştirin.

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 .NET 8 kurulumlarını gerçekleştirin.

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

  1. 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.
  1. 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.

Sıkça Sorulan Sorular

  • 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ı:
  • 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.

İlişkili diğer içerikler

No items found.

Sözlük

No items found.

Alt Başlıklar