Azure Spring Apps'e uygulama dağıtımlarını otomatikleştirme
Not
Temel, Standart ve Kurumsal planları, 3 yıllık kullanımdan kaldırma süresiyle Mart 2025 ortasından itibaren kullanımdan kaldırılacaktır. Azure Container Apps'e geçiş yapmanızı öneririz. Daha fazla bilgi için bkz . Azure Spring Apps kullanımdan kaldırma duyurusu.
Standart tüketim ve ayrılmış plan, altı ay sonra tamamen kapatılarak 30 Eylül 2024'den itibaren kullanımdan kaldırılacaktır. Azure Container Apps'e geçiş yapmanızı öneririz. Daha fazla bilgi için bkz . Azure Spring Apps Standart tüketimini ve ayrılmış planı Azure Container Apps'e geçirme.
Bu makale şunlar için geçerlidir: ✔️ Temel/Standart ✔️ Kurumsal
Bu makalede, uygulamaları dağıtmak için Azure Pipelines için Azure Spring Apps görevinin nasıl kullanılacağı gösterilmektedir .
Sürekli tümleştirme ve sürekli teslim araçları, güncelleştirmeleri en az çaba ve riskle mevcut uygulamalara hızla dağıtmanıza olanak tanır. Azure DevOps, bu önemli işleri düzenlemenize ve denetlemenize yardımcı olur.
Aşağıdaki videoda Azure Pipelines dahil olmak üzere seçtiğiniz araçları kullanarak uçtan uca otomasyon açıklanmaktadır.
Azure Resource Manager hizmet bağlantısı oluşturma
İlk olarak, Azure DevOps projenize bir Azure Resource Manager hizmet bağlantısı oluşturun. Yönergeler için bkz . Microsoft Azure'a bağlanma. Azure Spring Apps hizmet örneğiniz için kullandığınız aboneliği seçtiğinizden emin olun.
Uygulama oluşturma ve dağıtma
Artık bir dizi görevi kullanarak projelerinizi derleyebilir ve dağıtabilirsiniz. Aşağıdaki Azure Pipelines şablonu değişkenleri, uygulamayı oluşturmaya yönelik bir .NET Core görevini ve uygulamayı dağıtmak için bir Azure Spring Apps görevini tanımlar.
variables:
workingDirectory: './steeltoe-sample'
planetMainEntry: 'Microsoft.Azure.SpringCloud.Sample.PlanetWeatherProvider.dll'
solarMainEntry: 'Microsoft.Azure.SpringCloud.Sample.SolarSystemWeather.dll'
planetAppName: 'planet-weather-provider'
solarAppName: 'solar-system-weather'
serviceName: '<your service name>'
steps:
# Restore, build, publish and package the zipped planet app
- task: DotNetCoreCLI@2
inputs:
command: 'publish'
publishWebProjects: false
arguments: '--configuration Release'
zipAfterPublish: false
modifyOutputPath: false
workingDirectory: $(workingDirectory)
# Deploy the planet app
- task: AzureSpringCloud@0
inputs:
azureSubscription: '<Service Connection Name>'
Action: 'Deploy'
AzureSpringCloud: $(serviceName)
AppName: 'testapp'
DeploymentType: 'Artifacts'
UseStagingDeployment: false
DeploymentName: 'default'
Package: $(workingDirectory)/src/$(planetAppName)/publish-deploy-planet.zip
RuntimeVersion: 'NetCore_31'
DotNetCoreMainEntryPath: $(planetMainEntry)
# Deploy the solar app
- task: AzureSpringCloud@0
inputs:
azureSubscription: '<Service Connection Name>'
Action: 'Deploy'
AzureSpringCloud: $(serviceName)
AppName: 'testapp'
DeploymentType: 'Artifacts'
UseStagingDeployment: false
DeploymentName: 'default'
Package: $(workingDirectory)/src/$(solarAppName)/publish-deploy-solar.zip
RuntimeVersion: 'NetCore_31'
DotNetCoreMainEntryPath: $(solarMainEntry)
Azure Spring Apps örneği ve Azure DevOps projesi ayarlama
İlk olarak, mevcut bir Azure Spring Apps örneğini Azure DevOps ile kullanmak üzere ayarlamak için aşağıdaki adımları kullanın.
- Azure Spring Apps örneğine gidin ve yeni bir uygulama oluşturun.
- Azure DevOps portalına gidin ve seçtiğiniz kuruluş altında yeni bir proje oluşturun. Azure DevOps kuruluşunuz yoksa ücretsiz bir kuruluş oluşturabilirsiniz.
- Depolar'ı seçin, ardından Spring Boot tanıtım kodunu depoya aktarın.
Azure Resource Manager hizmet bağlantısı oluşturma
Ardından, Azure DevOps projenize bir Azure Resource Manager hizmet bağlantısı oluşturun. Yönergeler için bkz . Microsoft Azure'a bağlanma. Azure Spring Apps hizmet örneğiniz için kullandığınız aboneliği seçtiğinizden emin olun.
Uygulama oluşturma ve dağıtma
Artık bir dizi görevi kullanarak projelerinizi derleyebilir ve dağıtabilirsiniz. Aşağıdaki bölümlerde Azure DevOps kullanarak uygulamanızı dağıtmak için çeşitli seçenekler gösterilmektedir.
İşlem hattı kullanarak dağıtma
İşlem hattı kullanarak dağıtmak için şu adımları izleyin:
İşlem hatları'nın ardından Maven şablonuyla yeni bir işlem hattı oluşturun.
alanı 'complete/pom.xml' olarak ayarlamak
mavenPomFileiçin azure-pipelines.yml dosyasını düzenleyin.Sağ taraftaki Yardımcıyı göster'i ve ardından Azure Spring Apps şablonunu seçin.
Azure Aboneliğiniz için oluşturduğunuz hizmet bağlantısını ve ardından Azure Spring Apps örneğinizi ve uygulama örneğinizi seçin.
Hazırlama Dağıtımı Kullan'ı devre dışı bırakın.
Paket veya klasörü tamamlamak/hedeflemek/spring-boot-complete-0.0.1-SNAPSHOT.jar olarak ayarlayın.
Bu görevi işlem hattınıza eklemek için Ekle'yi seçin.
İşlem hattı ayarlarınız aşağıdaki görüntüyle eşleşmelidir.
Ayrıca aşağıdaki işlem hattı şablonunu kullanarak projelerinizi derleyebilir ve dağıtabilirsiniz. Bu örnek ilk olarak uygulamayı derlemek için bir Maven görevi, ardından Azure Pipelines için Azure Spring Apps görevini kullanarak JAR dosyasını dağıtan ikinci bir görev tanımlar.
steps: - task: Maven@3 inputs: mavenPomFile: 'complete/pom.xml' - task: AzureSpringCloud@0 inputs: azureSubscription: '<your service connection name>' Action: 'Deploy' AzureSpringCloud: <your Azure Spring Apps service> AppName: <app-name> DeploymentType: 'Artifacts' UseStagingDeployment: false DeploymentName: 'default' Package: ./target/your-result-jar.jarKaydet ve çalıştır'ı seçin ve işin tamamlanmasını bekleyin.
Mavi-yeşil dağıtımlar
Önceki bölümde gösterilen dağıtım, dağıtımdan hemen sonra uygulama trafiğini alır. Bu, herhangi bir müşteri trafiği almadan önce uygulamayı üretim ortamında test etmenizi sağlar.
İşlem hattı dosyasını düzenleme
Uygulamayı daha önce gösterildiği gibi derlemek ve bir hazırlama dağıtımına dağıtmak için aşağıdaki şablonu kullanın. Bu örnekte hazırlama dağıtımının zaten mevcut olması gerekir. Alternatif bir yaklaşım için bkz . Mavi-yeşil dağıtım stratejileri.
steps:
- task: Maven@3
inputs:
mavenPomFile: 'pom.xml'
- task: AzureSpringCloud@0
inputs:
azureSubscription: '<your service connection name>'
Action: 'Deploy'
AzureSpringCloud: <your Azure Spring Apps service>
AppName: <app-name>
DeploymentType: 'Artifacts'
UseStagingDeployment: true
Package: ./target/your-result-jar.jar
- task: AzureSpringCloud@0
inputs:
azureSubscription: '<your service connection name>'
Action: 'Set Production'
AzureSpringCloud: <your Azure Spring Apps service>
AppName: <app-name>
UseStagingDeployment: true
Sürümler bölümünü kullanma
Aşağıdaki adımlarda, Sürümler bölümünden mavi-yeşil dağıtımın nasıl etkinleştirileceği gösterilmektedir .
İşlem hatları'yı seçin ve Maven derlemeniz ve yayımlama yapıtınız için yeni bir işlem hattı oluşturun.
- Kod konumunuz için Azure Repos Git'i seçin.
- Kodunuzun bulunduğu bir depo seçin.
- Maven şablonunu seçin ve alanını
complete/pom.xmlolarak ayarlamakmavenPomFileiçin dosyayı değiştirin. - Sağ taraftaki Yardımcıyı göster'i seçin ve Derleme yapıtlarını yayımla şablonunu seçin.
- Yayımlamak için Yolu tamamlandı/hedef/spring-boot-complete-0.0.1-SNAPSHOT.jar olarak ayarlayın.
- Kaydet ve çalıştır'ı seçin.
Yayınlar'ı ve ardından Yayın oluştur'u seçin.
Yeni bir işlem hattı ekleyin ve bir iş oluşturmak için İşi boşalt'ı seçin.
Aşamalar'ın altında 1. satır işi, 0 görevi seçin
- + göreve görev eklemek için öğesini seçin.
- Görevi işe eklemek için Azure Spring Apps şablonunu arayın ve Ekle'yi seçin.
- Görevi düzenlemek için Azure Spring Apps Dağıtımı: öğesini seçin.
- Bu görevi uygulamanızın bilgileriyle doldurun, ardından Hazırlama Dağıtımını Kullan'ı devre dışı bırakın.
- Yoksa Yeni hazırlama dağıtımı oluştur'u etkinleştirin, ardından Dağıtım'a bir ad girin.
- Bu görevi kaydetmek için Kaydet'i seçin.
- Tamam'ı seçin.
İşlem Hattı'nın ardından Yapıt ekle'yi seçin.
- Kaynak (derleme işlem hattı) altında daha önce oluşturulan işlem hattını seçin.
- Ekle'yi ve ardından Kaydet'i seçin.
Aşamalar'ın altında 1 iş, 1 görev'i seçin.
Aşama 1'de Azure Spring Apps Dağıtımı görevine gidin, ardından Paketle veya klasörün yanındaki üç noktayı seçin.
İletişim kutusunda spring-boot-complete-0.0.1-SNAPSHOT.jar'ı ve ardından Tamam'ı seçin.
+ İşe başka bir Azure Spring Apps görevi eklemek için öğesini seçin.
Eylemi Üretim Dağıtımını Ayarla olarak değiştirin.
Dağıtımı otomatik olarak başlatmak için Kaydet'i ve ardından Yayın oluştur'u seçin.
Uygulamanızın geçerli yayın durumunu doğrulamak için Yayını görüntüle'yi seçin. Bu görev tamamlandıktan sonra uygulamanızın durumunu doğrulamak için Azure portalını ziyaret edin.
Kaynaktan dağıtma
Ayrı bir derleme adımı olmadan doğrudan Azure'a dağıtmak için aşağıdaki işlem hattı şablonunu kullanın.
- task: AzureSpringCloud@0
inputs:
azureSubscription: '<your service connection name>'
Action: 'Deploy'
AzureSpringCloud: <your Azure Spring Apps service>
AppName: <app-name>
DeploymentType: 'Artifacts'
UseStagingDeployment: false
DeploymentName: 'default'
Package: $(Build.SourcesDirectory)
Özel görüntüden dağıtma
Mevcut bir kapsayıcı görüntüsünden doğrudan dağıtmak için aşağıdaki işlem hattı şablonunu kullanın.
- task: AzureSpringCloud@0
inputs:
azureSubscription: '<your service connection name>'
Action: 'Deploy'
AzureSpringCloud: '<your Azure Spring Apps service>'
AppName: '<app-name>'
DeploymentType: 'CustomContainer'
UseStagingDeployment: false
DeploymentName: 'default'
ContainerRegistry: 'docker.io' # or your Azure Container Registry, e.g: 'contoso.azurecr.io'
RegistryUsername: '$(username)'
RegistryPassword: '$(password)'
ContainerImage: '<your image tag>'
Oluşturucu dağıtma ve belirtme (yalnızca Kurumsal plan)
Azure Spring Apps Enterprise planını kullanıyorsanız, aşağıdaki örnekte gösterildiği gibi seçeneğini kullanarak dağıtım eylemleri için hangi oluşturucunun builder kullanılacağını da belirtebilirsiniz. Daha fazla bilgi için bkz . Tanzu Derleme Hizmeti'ni kullanma.
- task: AzureSpringCloud@0
inputs:
azureSubscription: '<your-service-connection-name>'
Action: 'Deploy'
AzureSpringCloud: '<your-Azure-Spring-Apps-service-instance-name>'
AppName: '<app-name>'
UseStagingDeployment: false
DeploymentName: 'default'
Package: './target/your-result-jar.jar'
Builder: '<your-Tanzu-Build-Service-Builder-resource>'