Öğretici: Service Fabric kümesine CI/CD ile uygulama dağıtma
Bu öğretici, serinin dördüncü bölümüdür ve Azure Pipelines kullanarak bir Azure Service Fabric uygulaması için sürekli tümleştirme ve dağıtımın nasıl ayarlanacağı açıklanır. Mevcut bir Service Fabric uygulaması gereklidir; örnek olarak .NET uygulaması oluşturma bölümünde oluşturulan uygulama kullanılır.
Serinin üçüncü bölümünde şunları öğrenirsiniz:
- Projenize kaynak denetimi ekleme
- Azure Pipelines’da derleme işlem hattı oluşturma
- Azure Pipelines’da yayın işlem hattı oluşturma
- Uygulamayı otomatik olarak dağıtma ve yükseltme
Bu öğreticilerde şunların nasıl yapılacağını öğrenirsiniz:
- .NET Service Fabric uygulaması oluşturma
- Uygulamayı uzak kümeye dağıtma
- Bir ASP.NET Core ön uç hizmetine HTTPS uç noktası ekleme
- Azure Pipelines kullanarak CI/CD yapılandırma
- Uygulama için izleme ve tanılamayı ayarlama
Önkoşullar
Bu öğreticiye başlamadan önce:
- Azure aboneliğiniz yoksa ücretsiz bir hesap oluşturun
- Visual Studio 2019'u yükleyin ve Azure geliştirme ile ASP.NET ve web geliştirme iş yüklerini yükleyin.
- Service Fabric SDK'yı yükleyin
- Azure’da Windows Service Fabric kümesi oluşturun; örneğin, bu öğreticiyi izleyin
- Azure DevOps kuruluşu oluşturun. Kuruluş, Azure DevOps'ta proje oluşturmanıza ve Azure Pipelines'ı kullanmanıza olanak tanır.
Voting örnek uygulamasını indirme
Oylama örnek uygulamasını bu serinin birinci bölümünde oluşturmadıysanız indirebilirsiniz. Komut penceresinde, örnek uygulama deposunu yerel makinenize kopyalamak için aşağıdaki komutu çalıştırın.
git clone https://github.com/Azure-Samples/service-fabric-dotnet-quickstart
Yayımlama profili hazırlama
Artık bir uygulama oluşturup uygulamayı Azure'a dağıttığınız için sürekli tümleştirmeyi ayarlamaya hazırsınız. İlk olarak, azure pipelines içinde yürütülen dağıtım işlemi tarafından kullanılmak üzere uygulamanızda bir yayımlama profili hazırlayın. Yayımlama profili, daha önce oluşturduğunuz kümeyi hedeflemek için yapılandırılmalıdır. Visual Studio’yu başlatın ve mevcut Service Fabric uygulaması projesini açın. Çözüm Gezgini'nde uygulamaya sağ tıklayın ve Yayımla... öğesini seçin.
Sürekli tümleştirme iş akışınızda kullanmak üzere uygulama projenizin içinde bir hedef profil seçin (örneğin Bulut). Küme bağlantısı uç noktasını belirtin. Azure DevOps’daki her dağıtımda uygulamanızın yükseltilmesi için Uygulamayı Yükselt onay kutusunu işaretleyin. Ayarları yayımlama profiline kaydetmek için Kaydet köprüsüne tıklayın ve ardından İptal'i seçerek iletişim kutusunu kapatın.
Visual Studio çözümünüzü yeni bir Azure DevOps Git deposunda paylaşma
Derlemeler oluşturabilmek için uygulamanızın kaynak dosyalarını Azure DevOps’daki bir projede paylaşın.
Git -> Git menüsünden Git Deposu Oluştur'u seçerek Visual Studio 2022 IDE'den yeni bir GitHub deposu ve Azure DevOps deposu oluşturun
Açılan listeden hesabınızı seçin, deponuzun adını girin ve Oluştur ve Gönder düğmesini seçin.
Depoyu yayımlamak, Azure DevOps Services hesabınızda yerel depoyla aynı ada sahip yeni bir proje oluşturur.
Kuruluş adına> giderek<https://dev.azure.com/\ yeni oluşturulan depoyu görüntüleyin, fareyi projenizin adının üzerine getirin ve Depolar simgesini seçin.
Azure Pipelines ile Sürekli Teslimi Yapılandırma
Azure Pipelines derleme işlem hattı, sıralı olarak yürütülen bir dizi derleme adımından oluşan bir iş akışını açıklar. Service Fabric kümenize dağıtmak üzere Service Fabric uygulama paketini ve diğer yapıtları üreten bir derleme işlem hattı oluşturun. Azure Pipelines derleme işlem hatları hakkında daha fazla bilgi edinin.
Bir Azure Pipelines yayın işlem hattı, kümeye uygulama paketi dağıtan bir iş akışını açıklar. Derleme işlem hattı ve yayın işlem hattı ile birlikte kullanıldığında kaynak dosyalardan başlayıp kümenizde çalışan bir uygulamada biten iş akışının tamamını yürütür. Azure Pipelines yayın işlem hatları hakkında daha fazla bilgi edinin.
Derleme işlem hattı oluşturma
Bir web tarayıcısı açın ve şu konumda yeni projenize gidin: https://dev.azure.com/\<organizationname>/VotingSample
İşlem Hatları sekmesini ve ardından İşlem Hattı Oluştur'u seçin.
YAML olmadan işlem hattı oluşturmak için klasik düzenleyiciyi kullan’ı seçin.
El ile ve zamanlanmış derlemeler için Kaynak olarak Azure Repos Git, VotingSample Team projesi, VotingApplication Deposu ve ana Varsayılan dal'ı seçin. Daha sonra Devam seçeneğini belirleyin.
Şablon seçin bölümünde Azure Service Fabric uygulama şablonunu seçin ve Uygula'yı seçin.
Görevler'de Aracı havuzu olarak "Azure Pipelines" ve Aracı Belirtimi olarak windows-2022 girin.
Tetikleyiciler’in altında Sürekli tümleştirmeyi etkinleştir'i işaretleyerek sürekli tümleştirmeyi etkinleştirin. Dal filtreleri içinde Branch belirtimi varsayılan olarak ana değerdir. Derlemeyi el ile başlatmak için Kaydet ve kuyruğa al’ı seçin.
Derlemeler gönderme veya iade işlemleriyle de tetiklenir. Derleme ilerlemenizi denetlemek için Derlemeler sekmesine geçin. Derlemenin başarıyla yürütüldüğünü doğruladıktan sonra, uygulamanızı bir kümeye dağıtan bir yayın işlem hattı tanımlayın.
Yayın işlem hattı oluşturma
İşlem Hatları sekmesini, yayınlar'ı ve ardından + Yeni işlem hattı'nı seçin. Şablon seç alanında, listeden Azure Service Fabric Dağıtımı şablonunu ve sonra da Uygula'yı seçin.
Yeni bir küme bağlantısı eklemek için Görevler'i ve ardından +Yeni'yi seçin.
Yeni Service Fabric Bağlan ion görünümünde Sertifika Tabanlı veya Microsoft Entra kimlik bilgisi kimlik doğrulaması'nı seçin. tcp://mysftestcluster.southcentralus.cloudapp.azure.com:19000" (veya dağıtmakta olduğunuz kümenin uç noktasını) küme uç noktasını belirtin.
Sertifika tabanlı kimlik doğrulaması için, kümeyi oluşturmak için kullanılan sunucu sertifikasının Sunucu sertifikası parmak izini ekleyin. İstemci sertifikası alanında, istemci sertifika dosyasının base-64 kodlamasını ekleyin. Sertifikanın bu base-64 kodlamalı gösterimini nasıl alacağınızı öğrenmek için bu alanın yardım açılan kutusuna bakın. Ayrıca sertifika için Parola ekleyin. Ayrı bir istemci sertifikanız yoksa, küme veya sunucu sertifikasını kullanabilirsiniz.
Microsoft Entra kimlik bilgileri için, kümeyi oluşturmak için kullanılan sunucu sertifikasının Sunucu sertifikası parmak izini ve kümeye bağlanmak için kullanmak istediğiniz kimlik bilgilerini Kullanıcı Adı ve Parola alanlarına ekleyin.
Kaydet'i seçin.
Ardından, yayın işlem hattının derlemeden çıkışı bulabilmesi için işlem hattına bir derleme yapıtı ekleyin. İşlem Hattı ve Yapıtlar->+Ekle'yi seçin. Kaynak (Derleme tanımı) alanında, daha önce oluşturmuş olduğunuz derleme işlem hattını seçin. Derleme yapıtını kaydetmek için Ekle'yi seçin.
Derleme tamamlandığında otomatik olarak bir yayın oluşturulması için sürekli dağıtım tetikleyicisini etkinleştirin. Yapıttaki şimşek simgesini seçin, tetikleyiciyi etkinleştirin ve kaydet'i seçerek yayın işlem hattını kaydedin.
Sürümü el ile oluşturmak için Yayın Oluştur ->Oluştur'u seçin. Yayının ilerleme durumunu Yayınlar sekmesinden takip edebilirsiniz.
Dağıtımın başarılı olduğunu ve uygulamanın kümede çalıştığını doğrulayın. Bir web tarayıcısı açın ve https://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/ sayfasına gidin. Uygulama sürümünü not edin. Bu örnekte, şeklindedir 1.0.0.20170616.3.
Değişiklikleri işleme ve gönderme, yayını tetikleme
Azure DevOps'da yapılan bazı kod değişikliklerini denetleyerek sürekli tümleştirme işlem hattının çalıştığını doğrulayın.
Siz kodunuzu yazarken Visual Studio, Git Değişiklikleri penceresinin Değişiklikler bölümünde projenizdeki dosya değişikliklerini izler.
Değişiklikler görünümünde, güncelleştirmenizi açıklayan ve değişikliklerinizi işleyen bir ileti ekleyin.
Git Değişiklikleri penceresinde, Azure Pipelines'da kodu güncelleştirmek için Gönder düğmesini (yukarı ok) seçin.
Değişiklikleri Azure Pipelines'a göndermek, derlemeyi otomatik olarak tetikler. Derleme ilerlemenizi denetlemek için içindeki İşlem Hatları sekmesine https://dev.azure.com/organizationname/VotingSamplegeçin.
Derleme tamamlandığında, bir sürüm otomatik olarak oluşturulur ve kümedeki uygulamayı yükseltmeye başlar.
Dağıtımın başarılı olduğunu ve uygulamanın kümede çalıştığını doğrulayın. Bir web tarayıcısı açın ve https://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/ sayfasına gidin. Uygulama sürümünü not edin. Bu örnekte, şeklindedir 1.0.0.20170815.3.
Uygulamayı güncelleştirme
Uygulamada kod değişikliklerini yapın. Önceki adımları izleyerek değişiklikleri kaydedin ve işleyin.
Uygulamanın yükseltmesi başladığında, Service Fabric Explorer'da yükseltmenin ilerleme durumunu izleyebilirsiniz:
Uygulama yükseltmesi birkaç dakika sürebilir. Yükseltme tamamlandığında, uygulama bir sonraki sürümde çalışıyor olacaktır. Bu örnekte 1.0.0.20170815.4.
Sonraki adımlar
Bu öğreticide, şunların nasıl yapıldığını öğrendiniz:
- Projenize kaynak denetimi ekleme
- Derleme işlem hattı oluşturma
- Yayın işlem hattı oluşturma
- Uygulamayı otomatik olarak dağıtma ve yükseltme
Sonraki öğreticiye ilerleyin: