AzureSpringCloud@0 - Azure Spring Apps v0 görevi

Bu görev, uygulamaları Azure Spring Apps'e dağıtır ve bu dağıtımları yönetir.

Önemli

Bu görev, Azure Spring Apps Temel/Standart ve Kurumsal planlarında desteklenir. Daha fazla bilgi için Azure Spring Apps'e uygulama dağıtımlarını otomatikleştirme bölümüne bakın.

Sözdizimi

# Azure Spring Apps v0
# Deploy applications to Azure Spring Apps and manage deployments.
- task: AzureSpringCloud@0
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    Action: 'Deploy' # 'Deploy' | 'Set Production' | 'Delete Staging Deployment'. Required. Action. Default: Deploy.
    AzureSpringCloud: # string. Required. Azure Spring Apps Name. 
    AppName: # string. Required. App. 
    #DeploymentType: 'Artifacts' # 'Artifacts' | 'CustomContainer'. Optional. Use when Action = Deploy. Deployment Type. Default: Artifacts.
    #UseStagingDeployment: true # boolean. Optional. Use when Action = Deploy || Action = Set Production. Use Staging Deployment. Default: true.
    #CreateNewDeployment: false # boolean. Optional. Use when Action = Deploy && UseStagingDeployment = false. Create a new staging deployment if one does not exist. Default: false.
    #DeploymentName: # string. Optional. Use when UseStagingDeployment = false && Action != Delete Staging Deployment. Deployment. 
    #Package: '$(System.DefaultWorkingDirectory)/**/*.jar' # string. Optional. Use when Action = Deploy && DeploymentType = Artifacts. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.jar.
    #RegistryServer: 'docker.io' # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Registry Server. Default: docker.io.
    #RegistryUsername: # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Registry Username. 
    #RegistryPassword: # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Registry Password. 
    #ImageName: 'hello-world:v1' # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Image Name and Tag. Default: hello-world:v1.
    #ImageCommand: # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Image Command. 
    #ImageArgs: # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Image Arguments. 
    #ImageLanguageFramework: # 'springboot'. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Language Framework. 
  # Application and Configuration Settings
    #Builder: # string. Optional. Use when Action = Deploy && DeploymentType = Artifacts. Builder. 
    #EnvironmentVariables: # string. Optional. Use when Action = Deploy. Environment Variables. 
    #JvmOptions: # string. Optional. Use when Action = Deploy && DeploymentType = Artifacts. JVM Options. 
    #RuntimeVersion: 'Java_11' # 'Java_8' | 'Java_11' | 'Java_17' | 'Java_21' | 'NetCore_31'. Optional. Use when Action = Deploy && DeploymentType = Artifacts. Runtime Version. Default: Java_11.
    #DotNetCoreMainEntryPath: # string. Optional. Use when RuntimeVersion = NetCore_31. Main Entry Path. 
    #Version: # string. Optional. Use when Action = Deploy. Version.

Girişler

Azure aboneliği
Giriş diğer adı: ConnectedServiceName. string. Gerekli.

Dağıtım için Azure Resource Manager aboneliğini belirtir.

Action - Eylem
string. Gerekli. İzin verilen değerler: Deploy, Set Production (Üretim Dağıtımını Ayarla), Delete Staging Deployment. Varsayılan değer: Deploy.

Azure Spring Apps üzerinde gerçekleştirilecek eylem.

AzureSpringCloud - Azure Spring Apps Adı
string. Gerekli.

Dağıtılacak Azure Spring Apps örneğinin adı veya kaynak kimliği.

AppName - App
string. Gerekli.

Dağıtılacak Azure Spring Apps uygulamasının adı. Uygulama, görev yürütülmeden önce mevcut olmalıdır.

DeploymentType - Dağıtım Türü
string. Opsiyonel. Action = Deployolduğunda kullanın. İzin verilen değerler: Artifacts, CustomContainer (Özel Kapsayıcı). Varsayılan değer: Artifacts.

Kaynak kodu veya Java paketi ile dağıtmak için "Artifacts" öğesini seçin; Kapsayıcı görüntüsüyle dağıtmak için "Özel Kapsayıcı"yı seçin.

UseStagingDeployment - Hazırlama dağıtımını kullanma
boolean. Opsiyonel. Action = Deploy || Action = Set Productionolduğunda kullanın. Varsayılan değer: true.

Görev çalıştırıldığında, bu giriş otomatik stagingolarak olarak ayarlanan dağıtımı seçer.

olarak ayarlanırsa true, görevi, yürütme sırasında hazırlama dağıtımı olarak ayarlanan dağıtıma uygulayın. Atlanırsa, parametrenin DeploymentName ayarlanması gerekir.

CreateNewDeployment - Yoksa yeni bir hazırlama dağıtımı oluşturun.
boolean. Opsiyonel. Action = Deploy && UseStagingDeployment = falseolduğunda kullanın. Varsayılan değer: false.

olarak ayarlanırsa trueve tarafından DeploymentName belirtilen dağıtım yürütme zamanında mevcut değilse, oluşturulur. Atlanırsa, parametrenin DeploymentName ayarlanması gerekir.

DeploymentName - Dağıtım
string. Opsiyonel. UseStagingDeployment = false && Action != Delete Staging Deploymentolduğunda kullanın.

Bu görevin uygulanacağı dağıtım . Mavi-yeşil dağıtımlar kullanılmıyorsa, bu alanı .default Değer bir harfle başlamalı ve yalnızca küçük harf ve rakamlardan oluşmalıdır.

Paket veya klasör
string. Opsiyonel. Action = Deploy && DeploymentType = Artifactsolduğunda kullanın. Varsayılan değer: $(System.DefaultWorkingDirectory)/**/*.jar.

Azure Spring Apps uygulama içeriğini içeren paketin veya klasörün dosya yolu (.jar Java dosyası, .zip .NET Core için).
Değişkenler ( Derleme | Sürümü) ve joker karakterler desteklenir.
Örneğin, $(System.DefaultWorkingDirectory)/**/*.jar

Builder - Oluşturucusu
string. Opsiyonel. Action = Deploy && DeploymentType = Artifactsolduğunda kullanın.

VMware Tanzu® Build Service'in™ bir oluşturucusunu seçin, bu kurumsal katmanda kullanılabilir.
Ayrıntılı açıklama için lütfen Tanzu Build Hizmetini Kullan seçeneğini kontrol edin.

RegistryServer - Kayıt Defteri Sunucusu
string. Opsiyonel. Action = Deploy && DeploymentType = CustomContainerolduğunda kullanın. Varsayılan değer: docker.io.

Kapsayıcı görüntüsünün kayıt defteri. Varsayılan: docker.io.

RegistryUsername - Kayıt Defteri Kullanıcı Adı
string. Opsiyonel. Action = Deploy && DeploymentType = CustomContainerolduğunda kullanın.

Kapsayıcı kayıt defterinin kullanıcı adı.

RegistryPassword - Kayıt Defteri Parolası
string. Opsiyonel. Action = Deploy && DeploymentType = CustomContainerolduğunda kullanın.

Kapsayıcı kayıt defterinin parolası.

ImageName - Görüntü Adı ve Etiketi
string. Opsiyonel. Action = Deploy && DeploymentType = CustomContainerolduğunda kullanın. Varsayılan değer: hello-world:v1.

Kapsayıcı görüntüsü etiketi.

ImageCommand - Görüntü Komutu
string. Opsiyonel. Action = Deploy && DeploymentType = CustomContainerolduğunda kullanın.

Kapsayıcı görüntüsünün komutu.

ImageArgs - Görüntü Argümanları
string. Opsiyonel. Action = Deploy && DeploymentType = CustomContainerolduğunda kullanın.

Kapsayıcı görüntüsünün bağımsız değişkenleri.

ImageLanguageFramework - Dil Çerçevesi
string. Opsiyonel. Action = Deploy && DeploymentType = CustomContainerolduğunda kullanın. İzin verilen değerler: springboot.

EnvironmentVariables - Ortam Değişkenleri
string. Opsiyonel. Action = Deployolduğunda kullanın.

Sözdizimi -key value kullanılarak girilecek ortam değişkenleri (örneğin: -CUSTOMER_NAME Contoso-WEBSITE_TIME_ZONE). Boşluk içeren değerler çift tırnak içine alınmalıdır (örneğin: "Eastern Standard Time").

JvmOptions - JVM Seçenekleri
string. Opsiyonel. Action = Deploy && DeploymentType = Artifactsolduğunda kullanın.

Uygulamanın JVM seçeneklerini düzenler. JVM seçeneklerini içeren bir dize, örneğin -Xms1024m -Xmx2048m.

RuntimeVersion - Çalışma Zamanı Sürümü
string. Opsiyonel. Action = Deploy && DeploymentType = Artifactsolduğunda kullanın. İzin verilen değerler: Java_8 (Java 8), (Java 11), Java_17Java_11 (Java 17), Java_21 (Java 21), NetCore_31 (.Net Core 3.1). Varsayılan değer: Java_11.

Uygulamanın çalışacağı çalışma zamanı sürümü.

DotNetCoreMainEntryPath - Ana Giriş Yolu
string. Opsiyonel. RuntimeVersion = NetCore_31olduğunda kullanın.

Zip köküne göre .NET yürütülebilir dosyasının yolu.

Version - Sürüm
string. Opsiyonel. Action = Deployolduğunda kullanın.

Dağıtım sürümü. Ayarlanmazsa, sürüm değişmeden kalır.

Görev denetim seçenekleri

Tüm görevlerin, görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz. Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Bu görev aşağıdakiçıkış değişkenlerini tanımlar. Bu değişkenleri aşağı akış adımlarında, işlerde ve aşamalarda kullanabilirsiniz.

testEndpoint
Yalnızca 'Dağıt' eyleminden sonra. Güncelleştirilmiş dağıtıma erişmek için özel URL içerir.

Açıklamalar

Uygulamaları Azure Spring Apps'e dağıtmak ve Azure Spring Cloud dağıtımlarını yönetmek için bu görevi kullanın.

Önemli

Bu görev, Azure Spring Apps Temel/Standart ve Kurumsal planlarında desteklenir. Daha fazla bilgi için Azure Spring Apps'e uygulama dağıtımlarını otomatikleştirme bölümüne bakın.

Örnekler

Aşağıdaki örneklerde yaygın kullanım senaryoları gösterilmektedir. Daha fazla bilgi için Azure Spring Apps'e uygulama dağıtımlarını otomatikleştirme bölümüne bakın.

Hazırlama dağıtımlarını silme

"Hazırlama Dağıtımını Sil" eylemi, üretim trafiğini almayan dağıtımı silmenize olanak tanır. Bu, söz konusu dağıtım tarafından kullanılan kaynakları serbest bırakır ve yeni bir hazırlama dağıtımı için yer açar:

variables:
  azureSubscription: Contoso

steps:
- task: AzureSpringCloud@0
  continueOnError: true # Don't fail the pipeline if a staging deployment doesn't already exist.
  inputs:
    continueOnError: true
    inputs:
    azureSubscription: $(azureSubscription)
    Action: 'Delete Staging Deployment'
    AppName: customer-api
    AzureSpringCloud: contoso-dev-az-spr-cld

Dağıtılıyor

Üretime

Aşağıdaki örnek, Azure Spring Apps'teki varsayılan üretim dağıtımına dağıtılır. Temel SKU kullanılırken olası tek dağıtım senaryosu budur:

Uyarı

Paket arama düzeni yalnızca bir paket döndürmelidir. Derleme görevi sources.jar ve javadoc.jar gibi birden çok JAR paketi oluşturuyorsa, arama desenini yalnızca uygulama ikili yapıtıyla eşleşecek şekilde geliştirmeniz gerekir.

variables:
  azureSubscription: Contoso

steps:
- task: AzureSpringCloud@0
    inputs:
    azureSubscription: $(azureSubscription)
    Action: 'Deploy'
    AzureSpringCloud: contoso-dev-az-spr-cld
    AppName: customer-api
    UseStagingDeployment: false
    DeploymentName: default
    Package: '$(System.DefaultWorkingDirectory)/**/*customer-api*.jar'

Mavi-yeşil

Aşağıdaki örnek, önceden var olan bir hazırlama dağıtımına dağıtılır. Bu dağıtım, üretim dağıtımı olarak ayarlanana kadar üretim trafiğini almaz.

variables:
  azureSubscription: Contoso

steps:
- task: AzureSpringCloud@0
    inputs:
    azureSubscription: $(azureSubscription)
    Action: 'Deploy'
    AzureSpringCloud: contoso-dev-az-spr-cld
    AppName: customer-api
    UseStagingDeployment: true
    Package: '$(System.DefaultWorkingDirectory)/**/*customer-api*.jar'

Alternatif bir yaklaşım da dahil olmak üzere mavi-yeşil dağıtımlar hakkında daha fazla bilgi için bkz: Mavi-yeşil dağıtım stratejileri.

Üretim dağıtımlarını ayarlama

Aşağıdaki örnek, geçerli hazırlama dağıtımını üretim olarak ayarlar ve hangi dağıtımın üretim trafiğini aldığını etkili bir şekilde değiştirir.

variables:
  azureSubscription: Contoso

steps:
- task: AzureSpringCloud@0
    inputs:
    azureSubscription: $(azureSubscription)
    Action: 'Set Production'
    AzureSpringCloud: contoso-dev-az-spr-cld
    AppName: customer-api
    UseStagingDeployment: true

Gereksinimler

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır	Agent, DeploymentGroup
Talep	Hiç kimse
Özellikleri	Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları	Herhangi biri
Ayarlanabilir değişkenleri	Herhangi biri
Aracı sürümü	2.104.1 veya üzeri
Görev kategorisi	Yerleştir