İlk Azure Service Fabric uygulamanızı oluşturma

Service Fabric, Linux üzerinde hem .NET Core hem de Java dillerinde hizmet oluşturmaya yönelik SDK’lar sağlar. Bu öğreticide, .NET Core 2.0 üzerinde C# kullanarak Linux için bir uygulama ve hizmet oluşturmayı öğreneceğiz.

Önkoşullar

Başlamadan önce Linux geliştirme ortamınızı ayarladığınızdan emin olun. macOS X kullanıyorsanız, Vagrant kullanarak sanal makinede bir Linux tek kutu ortamı ayarlayabilirsiniz.

Service Fabric CLI'yi de yüklemek istiyorsunuz

C# için oluşturucuları yükleme ve ayarlama

Service Fabric, Yeoman şablon oluşturucuları kullanarak terminalden Service Fabric uygulamaları oluşturmanıza yardımcı olan yapı iskelesi araçları sağlar. C# için Service Fabric Yeoman şablon oluşturucularını ayarlama amacıyla bu adımları izleyin:

1. Makinenize nodejs ve NPM yükleme

   curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bash 
   nvm install node 
   

2. NPM’den makinenize Yeoman şablon oluşturucuyu yükleme

   npm install -g yo
   

3. NPM'den Service Fabric Yeoman C# uygulama oluşturucuyu yükleme

   npm install -g generator-azuresfcsharp
   

Uygulamayı oluşturma

Service Fabric uygulaması bir veya birden çok hizmet içerebilir. Bu hizmetlerin her biri uygulamanın işlevselliğini aktarma konusunda belirli bir role sahiptir. Son adımda yüklediğiniz C# için Service Fabric Yeoman oluşturucu, ilk hizmetinizi oluşturmanızı ve daha sonra yeni hizmetler eklemenizi kolaylaştırır. Tek bir hizmetle uygulama oluşturmak için Yeoman’ı kullanalım.

1. Bir terminalde iskele oluşturmaya başlamak için aşağıdaki komutu yazın:yo azuresfcsharp

2. Uygulamanızı adlandırın.

3. Birinci hizmetinizin türünü seçin ve adlandırın. Bu öğreticinin amaçları doğrultusunda, Reliable Actor Hizmetini seçiyoruz.

   

Uygulama oluşturma

Service Fabric Yeoman şablonları, uygulamayı terminalden oluşturmak (uygulama klasörüne gittikten sonra) için kullanabileceğiniz bir yapı betiği içerir.

cd myapp
./build.sh

Uygulamayı dağıtma

Uygulama oluşturulduktan sonra uygulamayı yerel kümeye dağıtabilirsiniz.

1. Yerel Service Fabric kümesine bağlanın.

   sfctl cluster select --endpoint http://localhost:19080
   

2. Uygulama paketini kümenin görüntü deposuna kopyalamak, uygulama türünü kaydetmek ve uygulamanın bir örneğini oluşturmak için şablonda verilen yükleme betiğini çalıştırın.

   ./install.sh
   

Oluşturulan uygulamayı dağıtma işlemi, diğer tüm Service Fabric uygulamalarında olduğu gibidir. Ayrıntılı yönergeler için Service Fabric uygulamasını Service Fabric CLI ile yönetme ile ilgili belgelere bakın.

Bu komutların parametreleri, uygulama paketi içinde oluşturulmuş bildirimlerde bulunabilir.

Uygulama dağıtıldıktan sonra bir tarayıcı açın ve adresinde Service Fabric Explorer'a http://localhost:19080/Explorergidin. Ardından Uygulamalar düğümünü genişletin ve artık uygulama türünüz için bir giriş olduğunu ve bu türün ilk örneği için başka bir giriş olduğunu unutmayın.

Test istemcisini başlatma ve yük devre gerçekleştirme

Aktör projeleri tek başına hiçbir şey yapmaz. Bunlar başka bir hizmet veya istemcinin kendilerine iletiler göndermesini gerektirir. Actor şablonu, actor hizmetiyle etkileşim kurmak üzere kullanabileceğiniz basit bir test betiği içerir.

1. Actor hizmetinin çıktısını görmek için izleme yardımcı programını kullanarak betiği çalıştırın.

   MAC OS X olması durumunda, aşağıdaki ek komutları çalıştırarak myactorsvcTestClient klasörünü kapsayıcı içinde aynı konuma kopyalamanız gerekir.

   docker cp  [first-four-digits-of-container-ID]:/home
   docker exec -it [first-four-digits-of-container-ID] /bin/bash
   cd /home
   

   cd myactorsvcTestClient
   watch -n 1 ./testclient.sh
   

2. Service Fabric Explorer’da actor hizmetinin birincil çoğaltmasını barındıran düğümü bulun. Aşağıdaki ekran görüntüsünde düğüm 3’tür.

   

3. Önceki adımda bulduğunuz düğüme tıklayın, ardından Eylemler menüsünden Devre dışı bırak (yeniden başlat) öğesini seçin. Bu eylem, yerel kümenizdeki bir düğümü yeniden başlatır. Böylece başka bir düğümde çalışan ikincil bir çoğaltmaya yük devretmesi için zorlanır. Bu eylemi gerçekleştirirken, test istemcisinden gelen çıkışa dikkat edin ve sayacın yük devretmeye rağmen artmaya devam ettiğini unutmayın.

Mevcut bir uygulamaya daha fazla hizmet ekleme

yo kullanılarak oluşturulmuş bir uygulamaya başka bir hizmet eklemek için aşağıdaki adımları uygulayın:

1. Dizini mevcut uygulamanın kök dizinine değiştirin. Örneğin Yeoman tarafından oluşturulan uygulama MyApplication ise cd ~/YeomanSamples/MyApplication olacaktır.
2. yo azuresfcsharp:AddService komutunu çalıştırın

Sonraki adımlar

• Service Fabric CLI’sını kullanarak Service Fabric kümeleriyle etkileşim kurma
• Service Fabric destek seçenekleri hakkında bilgi edinin
• Service Fabric CLI ile çalışmaya başlama