AzureSpringCloud@0 - Azure Spring Apps v0 görevi

Makale
07/02/2024

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 bkz. Azure Spring Apps'e uygulama dağıtımlarını otomatikleştirme.

Syntax

# 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.

# 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' | '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.

# 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. 
    #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. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.jar.
  # Application and Configuration Settings
    #EnvironmentVariables: # string. Optional. Use when Action = Deploy. Environment Variables. 
    #JvmOptions: # string. Optional. Use when Action = Deploy. JVM Options. 
    #RuntimeVersion: 'Java_11' # 'Java_8' | 'Java_11' | 'NetCore_31'. Optional. Use when Action = Deploy. 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

azureSubscription - Azure aboneliği
Giriş diğer adı: ConnectedServiceName. string. Gereklidir.

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

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

Azure Spring Apps'te gerçekleştirilecek eylem.

AzureSpringCloud - Azure Spring Apps Adı
string. Gereklidir.

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

AppName - App
string. Gereklidir.

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

DeploymentType - Dağıtım Türü
string. İsteğe bağlı. when Action = Deploykullanın. İzin verilen değerler: Artifacts, CustomContainer (Özel Kapsayıcı). Varsayılan değer: Artifacts.

Kaynak kodu veya Java paketiyle dağıtmak için "Yapıtlar" öğesini seçin; Kapsayıcı görüntüsüyle dağıtmak için "Özel Kapsayıcı" öğesini seçin.

UseStagingDeployment - Hazırlama Dağıtımı Kullanma
boolean. İsteğe bağlı. when Action = Deploy || Action = Set Productionkullanın. Varsayılan değer: true.

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

olarak trueayarlanırsa, görevi yürütme sırasında hazırlama dağıtımı olarak ayarlanan dağıtıma uygulayın. Atlanırsa parametresi DeploymentName ayarlanmalıdır.

CreateNewDeployment - Yoksa yeni bir hazırlama dağıtımı oluşturun.
boolean. İsteğe bağlı. when Action = Deploy && UseStagingDeployment = falsekullanın. Varsayılan değer: false.

olarak trueayarlanırsa ve tarafından DeploymentName belirtilen dağıtım yürütme zamanında mevcut değilse oluşturulur. Atlanırsa parametresi DeploymentName ayarlanmalıdır.

DeploymentName - Dağıtım
string. İsteğe bağlı. when UseStagingDeployment = false && Action != Delete Staging Deploymentkullanın.

Bu görevin uygulanacağı dağıtım . Mavi-yeşil dağıtımları kullanmıyorsanız, bu alanı olarak defaultayarlayın. Değer bir harfle başlamalı ve yalnızca küçük harf ve sayılardan oluşmalıdır.

Package - Paket veya klasör
string. İsteğe bağlı. when Action = Deploy && DeploymentType = Artifactskullanı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 için dosya, .zip .NET Core için).
Değişkenler ( Derleme | Sürümü) ve joker karakterler desteklenir.
Örneğin, $(System.DefaultWorkingDirectory)/**/*.jar

Package - Paket veya klasör
string. İsteğe bağlı. when Action = Deploykullanın. Varsayılan değer: $(System.DefaultWorkingDirectory)/**/*.jar.

Builder - Oluşturucusu
string. İsteğe bağlı. when Action = Deploy && DeploymentType = Artifactskullanın.

VMware Tanzu® Derleme Hizmeti™ oluşturucusunu seçin; bu, kurumsal katmanda kullanılabilir.
Ayrıntılı açıklama için lütfen Tanzu Derleme Hizmeti'ni kullanma konusuna bakın.

RegistryServer - Kayıt Defteri Sunucusu
string. İsteğe bağlı. when Action = Deploy && DeploymentType = CustomContainerkullanı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. İsteğe bağlı. when Action = Deploy && DeploymentType = CustomContainerkullanın.

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

RegistryPassword - Kayıt Defteri Parolası
string. İsteğe bağlı. when Action = Deploy && DeploymentType = CustomContainerkullanın.

Kapsayıcı kayıt defterinin parolası.

ImageName - Resim Adı ve Etiketi
string. İsteğe bağlı. when Action = Deploy && DeploymentType = CustomContainerkullanın. Varsayılan değer: hello-world:v1.

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

ImageCommand - Resim Komutu
string. İsteğe bağlı. when Action = Deploy && DeploymentType = CustomContainerkullanın.

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

ImageArgs - Görüntü Bağımsız Değişkenleri
string. İsteğe bağlı. when Action = Deploy && DeploymentType = CustomContainerkullanın.

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

ImageLanguageFramework - Dil Çerçevesi
string. İsteğe bağlı. when Action = Deploy && DeploymentType = CustomContainerkullanın. İzin verilen değerler: springboot.

EnvironmentVariables - Ortam Değişkenleri
string. İsteğe bağlı. when Action = Deploykullanın.

Söz dizimi -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. İsteğe bağlı. when Action = Deploy && DeploymentType = Artifactskullanın.

Uygulamanın JVM seçeneklerini düzenler. gibi -Xms1024m -Xmx2048mJVM seçeneklerini içeren bir dize.

JvmOptions - JVM Seçenekleri
string. İsteğe bağlı. when Action = Deploykullanın.

Uygulamanın JVM seçeneklerini düzenler. gibi -Xms1024m -Xmx2048mJVM seçeneklerini içeren bir dize.

RuntimeVersion - Çalışma Zamanı Sürümü
string. İsteğe bağlı. when Action = Deploy && DeploymentType = Artifactskullanın. İzin verilen değerler: Java_8 (Java 8), Java_11 (Java 11), Java_17 (Java 17), Java_21 (Java 21), NetCore_31 (.Net Core 3.1). Varsayılan değer: Java_11.

Uygulamanın üzerinde çalıştırılacağı çalışma zamanı sürümü.

RuntimeVersion - Çalışma Zamanı Sürümü
string. İsteğe bağlı. when Action = Deploy && DeploymentType = Artifactskullanın. İzin verilen değerler: Java_8 (Java 8), Java_11 (Java 11), NetCore_31 (.Net Core 3.1). Varsayılan değer: Java_11.

Uygulamanın üzerinde çalıştırılacağı çalışma zamanı sürümü.

RuntimeVersion - Çalışma Zamanı Sürümü
string. İsteğe bağlı. when Action = Deploykullanın. İzin verilen değerler: Java_8 (Java 8), Java_11 (Java 11), NetCore_31 (.Net Core 3.1). Varsayılan değer: Java_11.

Uygulamanın üzerinde çalıştırılacağı çalışma zamanı sürümü.

DotNetCoreMainEntryPath - Ana Giriş Yolu
string. İsteğe bağlı. when RuntimeVersion = NetCore_31kullanın.

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

Version - Sürüm
string. İsteğe bağlı. when Action = Deploykullanın.

Dağıtım sürümü. Ayarlanmamışsa, sürüm değiştirilmeden bırakılır.

Görev denetim seçenekleri

Tüm görevlerde 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ğı akış adımlarında, işlerde ve aşamalarda kullanabileceğiniz aşağıdaki çıkış değişkenlerini tanımlar.

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 bkz. Azure Spring Apps'e uygulama dağıtımlarını otomatikleştirme.

Örnekler

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

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ı boşaltır ve yeni bir hazırlama dağıtımına yer sağlar:

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ğıtma

Üretime

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

Not

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ştirmektedir.

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çbiri
Özellikler	Bu görev, işteki sonraki görevler için hiçbir talebi karşılamaz.
Komut kısıtlamaları	Herhangi biri
Ayarlanabilir değişkenler	Herhangi biri
Aracı sürümü	2.104.1 veya üzeri
Görev kategorisi	Dağıtma

Aracılığıyla paylaş

AzureSpringCloud@0 - Azure Spring Apps v0 görevi

Syntax

Girişler

Görev denetim seçenekleri

Çıkış değişkenleri

Açıklamalar

Örnekler

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

Dağıtma

Üretime

Mavi-yeşil

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

Gereksinimler

Geri Bildirim

Ek kaynaklar