Windows geliştirici makinenizde Linux Service Fabric kümesi ayarlama

  • Makale

Bu belge, Bir Windows geliştirme makinesinde yerel 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 Windows üzerinde çalışmaz, ancak platformlar arası prototip oluşturmayı etkinleştirmek için Windows için Docker aracılığıyla dağıtılabilir bir Linux Service Fabric bir kutu küme docker kapsayıcısı sağladık.

Başlamadan önce şunlar gereklidir:

  • En az 4 GB RAM
  • Windows için Docker'ın en son sürümü
  • Docker Linux kapsayıcıları modunda çalışıyor olmalıdır

İpucu

Docker'ı Windows makinenize yüklemek için Docker belgelerindeki adımları izleyin. Yükledikten sonra yüklemenizi doğrulayın.

Yerel bir kapsayıcı oluşturma ve Service Fabric’i ayarlama

Yerel bir Docker kapsayıcısı ayarlamak ve üzerinde bir Service Fabric kümesi çalıştırmak için aşağıdaki adımları çalıştırın:

  1. Ana bilgisayarınızda Docker daemon yapılandırmasını aşağıdakiyle güncelleştirin ve Docker daemon programını yeniden başlatın:

    {
  "ipv6": true,
  "fixed-cidr-v6": "2001:db8:1::/64"
}

    Güncelleştirmenin önerilen yolu şuraya gitmektir:

    • Docker Simgesi > Ayarları > Docker Altyapısı
    • Yukarıda listelenen yeni alanları ekleyin
    • Uygula ve Yeniden Başlat - Değişikliklerin etkili olması için Docker daemon'ını yeniden başlatın.

  2. Kümeyi PowerShell aracılığıyla başlatın.
    Ubuntu 20.04 LTS:

    docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u20

    Ubuntu 18.04 LTS:

    docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u18

    İpucu

    Varsayılan olarak bu, görüntüyü Service Fabric’in en son sürümüyle çeker. Belirli düzeltmeler için Docker Hub'da Service Fabric Onebox sayfasına bakın.

  3. İsteğe bağlı: Genişletilmiş Service Fabric görüntünüzü oluşturun.

    Yeni bir dizinde, özelleştirilmiş görüntünüzü oluşturmak için adlı Dockerfile bir dosya oluşturun:

    Not

    Kapsayıcınıza ek programlar veya bağımlılıklar eklemek için yukarıdaki görüntüyü dockerfile ile uyarlayabilirsiniz. Örneğin, RUN apt-get install nodejs -y komutu eklendiğinde, konuk yürütülebilir dosyaları olarak nodejs uygulamaları için destek sağlanır.

    FROM mcr.microsoft.com/service-fabric/onebox:u18
RUN apt-get install nodejs -y
EXPOSE 19080 19000 80 443
WORKDIR /home/ClusterDeployer
CMD ["./ClusterDeployer.sh"]

    İpucu

    Varsayılan olarak bu, görüntüyü Service Fabric’in en son sürümüyle çeker. Belirli düzeltmeler için lütfen Docker Hub sayfasını ziyaret edin.

    'den Dockerfileyeniden kullanılabilir görüntünüzü oluşturmak için bir terminal açın ve cd ardından komutunu doğrudan tutan Dockerfile öğesine çalıştırın:

    docker build -t mysfcluster .

    Not

    Bu işlem biraz zaman alır, ancak yalnızca bir kez gereklidir.

    Artık service fabric'in yerel bir kopyasını istediğiniz zaman hızla başlatabilirsiniz:

    docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mysfcluster

    İpucu

    Kapsayıcı örneğiniz için bir ad belirterek, örneğinizin daha okunaklı bir biçimde işlenebilmesini sağlayın.

    Uygulamanız belirli bağlantı noktalarını dinliyorsa, bağlantı noktaları ek -p etiketleri kullanılarak belirtilmelidir. Örneğin, uygulamanız 8080 bağlantı noktasını dinliyorsa, şuradaki -p etiketini ekleyin:

    docker run -itd -p 19000:19000 -p 19080:19080 -p 8080:8080 --name sfonebox mcr.microsoft.com/service-fabric/onebox:u18

  4. Kümenin başlatılması kısa bir süre sürer, aşağıdaki komutu kullanarak günlükleri görüntüleyebilir veya http://localhost:19080 küme durumunu görüntülemek için panoya atlayabilirsiniz:

    docker logs sftestcluster

  5. 4. adımda gözlemlendiği gibi küme başarıyla dağıtıldıktan sonra, Service Fabric Explorer panosunu bulmak için Windows makinenizden adresine gidebilirsiniz http://localhost:19080 . Bu noktada, Windows geliştirici makinenizdeki araçları kullanarak bu kümeye bağlanabilir ve Linux Service Fabric kümeleri için hedeflenen uygulamaları dağıtabilirsiniz.

    Not

    Eclipse eklentisi Windows üzerinde şu anda desteklenmemektedir.

  6. İşiniz bittiğinde şu komutla kapsayıcıyı durdurun ve temizleyin:

    docker rm -f sftestcluster

Bilinen Sınırlamalar

Mac’e yönelik kapsayıcıdaki yerel küme çalıştırmaya ilişkin bilinen sınırlandırmalar aşağıda verilmiştir:

  • DNS hizmeti çalışmıyor ve şu anda kapsayıcı içinde desteklenmiyor. Sorun #132
  • Kapsayıcı tabanlı uygulamaların çalıştırılması için Linux ana bilgisayarında SF çalıştırılması gerekir. İç içe kapsayıcı uygulamaları şu anda desteklenmiyor.

Sonraki adımlar