Windows geliştirici makinenizde WSL2 aracılığıyla Linux Service Fabric kümesi ayarlama

Bu belge, Bir Windows geliştirme makinesinde WSL2 aracılığıyla yerel bir Linux Service Fabric kümesinin nasıl ayarlandığını kapsar. Yerel Bir Linux kümesi ayarlamak, Linux kümeleri için hedeflenen ancak Bir Windows makinesinde geliştirilen uygulamaları hızlı bir şekilde test etmek için kullanışlıdır.

Önkoşullar

Linux tabanlı Service Fabric kümeleri doğrudan Windows üzerinde çalışmaz, ancak platformlar arası prototip oluşturmayı etkinleştirmek için Windows için WSL2 (Linux için Windows Alt Sistemi) aracılığıyla Linux dağıtımı içinde Service Fabric Kümesi dağıtmanın bir yolunu sağladık.

Başlamadan önce şunlar gereklidir:

  • WSL2 Windows'ta ayarlayın ve WSL 2'nin varsayılan sürüm olduğundan emin olun
  • WSL2'yi ayarlarken Microsoft Store'dan Ubuntu 18.04 Linux Dağıtımı ayarlama

İpucu

Windows makinenize WSL2 yüklemek için WSL belgelerindeki adımları izleyin. Yükledikten sonra lütfen Ubuntu-18.04'ün yüklendiğinden emin olun, bunu varsayılan dağıtımınız yapın ve çalışır durumda olmalıdır.

Linux Dağıtımı içinde Service Fabric SDK'sını ayarlama

Service Fabric Kurulumu, WSL2 Linux Dağıtımında standart Linux işletim sisteminde olduğu gibi yapılamaz. PID1 olarak systemd vm içinde çalışmadığından ve PID1 olarak sistemlendiğinden, SF SDK'nın başarıyla çalışması için bir önkoşuldur. Systemd'i PID1 olarak etkinleştirmek için, systemd-genie geçici çözüm olarak kullanılır. Systemd-genie hakkında daha fazla bilgi için systemd genie kurulumu Betik yükleme ve el ile yükleme adımları hem systemd-genie hem de service fabric sdk'sının yüklenmesini kapsar.

Betikle yükleme

Kolaylık olması için, sfctl CLI ile birlikte Service Fabric ortak SDK'sını yüklemek için bir betik sağlanır. Betiği çalıştırdığınızda yüklenen yazılıma ait tüm lisans şartlarını kabul ettiğiniz varsayılır. Alternatif olarak, ilişkilendirilmiş lisansları ve yüklenen bileşenleri gösteren sonraki bölümde El ile yükleme adımlarını çalıştırabilirsiniz.

Betik başarılı bir şekilde çalıştırıldıktan sonra Yerel kümeyi ayarlama bölümüne geçebilirsiniz.

sudo curl -s https://raw.githubusercontent.com/Azure/service-fabric-scripts-and-templates/master/scripts/SetupServiceFabric/SetupServiceFabric.sh | sudo bash

El ile yükleme

Service Fabric çalışma zamanı ve ortak SDK'yı el ile yüklemek için bu kılavuzdaki adımları izleyin.

  1. Bir terminal açın.

  2. WSL2 Linux Dağıtımında Oturum Açın

  3. Systemd-genie kurulumunda belirtildiği gibi systemd-genie'yi ayarlama (systemd-genie zaten ayarlanmışsa, sonraki adıma geçebilirsiniz)

  4. genie -s kullanarak genie ad alanına girin

  5. Genie ad alanının içinde SF SDK'sı, Linux yerel kümesi ayarlama bölümünde Betik Yükleme veya El ile Yükleme adımları altında belirtildiği gibi yüklenebilir

  6. /etc/sudoers içinde bir giriş <USERNAME\> ALL = (ALL) NOPASSWD:ALL yaparak geçerli kullanıcıya sudo ayrıcalıkları sağlama

Yerel küme oluşturma

WSL2 VM içindeki Service Fabric'in konak pencerelerinden yönetilmesi önerilir

  1. Windows konağına Service Fabric SDK'sını (sürüm 6.0 veya üzeri) yükleme

  2. Windows'da küme, SF SDK'sının bir parçası olarak sağlanan ServiceFabricLocalClusterManager aracı kullanılarak yönetilebilir

  3. Linux Yerel Kümesini yönetme seçeneği yalnızca bir. WSL2 VM çalışıyor, b. Systemd-genie, servicefabricruntime ve servicefabricsdkcommon paketleri VM ve c içine düzgün bir şekilde yüklenir. Systemd-genie çalışıyor durumda. Bu araçtan Linux Yerel Kümesi ayarlayabilir veya bu kümeye geçiş yapabilirsiniz.

  4. Linux kümesini ayarlamanın bir diğer yolu da SF SDK'sı kapsamında sağlanan küme kurulum betiklerini kullanarak dağıtmaktır.

  5. Bir web tarayıcısı açın ve Service Fabric Explorer'a http://localhost:19080gidin. Küme başlatıldığında, Service Fabric Explorer panosunu görürsünüz. Kümenin ayarlanması birkaç dakika sürebilir. Tarayıcınız URL'yi açamazsa veya Service Fabric Explorer kümeyi göstermezse, birkaç dakika bekleyin ve yeniden deneyin. Kümeyi SF SDK'da sağlanan ServiceFabricExplorer'da da görebilirsiniz.

  6. Küme çalışır duruma geldikten sonra PowerShell ve Visual Studio'da yerel kümeye bağlanabilirsiniz.

Özel ServiceFabric ve ServieFabricSdkCommon Debian Paketi ile el ile yükleme

Service Fabric'in özel veya indirilen debian paketlerinden el ile yüklenmesi için bu kılavuzun geri kalanını izleyin.

  1. Bir terminal açın.

  2. WSL2 Linux Dağıtımında Oturum Açın

  3. Dosya ayarlamayı kopyalama

sudo curl -s https://raw.githubusercontent.com/Azure/service-fabric-scripts-and-templates/master/scripts/SetupServiceFabric/SetupServiceFabric.sh > SetupServiceFabric.sh
  1. Dosyayı yürütülebilir hale getirme
sudo chmod +x SetupServiceFabric.sh
  1. Yerel debian paketleri yolu ile kurulum betiğini çalıştırın. Sağlanan yolların geçerli olduğundan emin olun. Aşağıda örnek verilmiştir:
sudo ./SetupServiceFabric.sh --servicefabricruntime=/mnt/c/Users/testuser/Downloads/servicefabric.deb --servicefabricsdk=/mnt/c/Users/testuser/Downloads/servicefabric_sdkcommon.deb

Bilinen Sınırlamalar

Linux Dağıtımı içinde çalışan yerel kümenin bilinen sınırlamaları şunlardır:

  • Şu anda Ubuntu-18.04 dağıtımı yalnızca desteklenmektedir.
  • Yerel Küme Yöneticisi ve Visual Studio ile sorunsuz bir deneyim elde etmek için, Kümeyi Windows ana bilgisayarında PowerShell betiklerinden veya LocalClusterManager'dan yönetmeniz önerilir.

Sık Sorulan Sorular

  1. SF Yerel Küme Kurulumu için hangi Linux dağıtımları desteklenir?
    Şu anda linux yerel kümesi için yalnızca Ubuntu-18.04 desteklenmektedir.

  2. Windows ve Linux SF Kümesi WSL2 kurulumuyla paralel olarak çalıştırılabilir mi?
    Hayır, bir kerede konakta veya konuk VM'de yalnızca bir yerel küme çalıştırılabilir.

  3. Bir düğüm linux yerel kümesi nasıl dağıtılır?
    Menü seçeneklerinden Yerel Küme Yöneticisi'nden bir düğüm veya beş düğüm linux yerel kümesi dağıtılabilir. Kurulum betiğinden dağıtım yapılırken varsayılan olarak beş düğüm kümesi dağıtılır ve bir düğüm kümesi için CreateOneNodeCluster geçirilmelidir.

  4. PowerShell ve Visual Studio'da Linux Yerel Kümesine nasıl bağlanabilirsiniz?
    Linux yerel kümesi çalışır durumdaysa connect-servicefabriccluster cmdlet'i otomatik olarak bu kümeye bağlanmalıdır. Benzer Visual Studio bu yerel kümeyi otomatik olarak algılar. Bu küme, PowerShell veya Visual Studio'da küme uç noktası sağlanarak da bağlanabilir.

  5. Linux yerel kümesi için SF Kümesi verileri nerede bulunur?
    Ubuntu-18.04 dağıtımı kullanılıyorsa, SF verileri Windows ana bilgisayarından \wsl$\Ubuntu-18.04\home\sfuser\sfdevcluster konumunda bulunur.

Sonraki adımlar