AzureSpringCloud@0 - Attività azure Spring Apps v0

Questa attività distribuisce le applicazioni in Azure Spring Apps e gestisce tali distribuzioni.

Importante

Questa attività è supportata nei piani Basic/Standard e Enterprise di Azure Spring Apps. Per altre informazioni, vedere Automatizzare le distribuzioni di applicazioni in Azure Spring Apps.

Sintassi

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

Input

azureSubscription - Sottoscrizione di Azure
Alias di input: ConnectedServiceName. string. Obbligatorio.

Specifica la sottoscrizione di Azure Resource Manager per la distribuzione.

Action - Azione
string. Obbligatorio. Valori consentiti: Deploy, Set Production (Set Production Deployment), Delete Staging Deployment. Valore predefinito: Deploy.

Azione da eseguire in Azure Spring Apps.

AzureSpringCloud - Nome app Azure Spring
string. Obbligatorio.

Nome o ID risorsa dell'istanza di Azure Spring Apps da distribuire.

AppName - App
string. Obbligatorio.

Nome dell'app Azure Spring Apps da distribuire. L'app deve esistere prima dell'esecuzione dell'attività.

DeploymentType - Tipo di distribuzione
string. facoltativo. Usare quando Action = Deploy. Valori consentiti: Artifacts, CustomContainer (contenitore personalizzato). Valore predefinito: Artifacts.

Per eseguire la distribuzione con il codice sorgente o il pacchetto Java, scegliere "Artefatti"; Per eseguire la distribuzione con l'immagine del contenitore, scegliere "Contenitore personalizzato".

UseStagingDeployment - Usare la distribuzione di staging
boolean. facoltativo. Usare quando Action = Deploy || Action = Set Production. Valore predefinito: true.

Al momento dell'esecuzione dell'attività, questo input seleziona automaticamente la distribuzione impostata come staging.

Se impostato su true, applicare l'attività alla distribuzione impostata come distribuzione di staging al momento dell'esecuzione. Se omesso, il DeploymentName parametro deve essere impostato.

CreateNewDeployment - Creare una nuova distribuzione di staging, se non ne esiste una.
boolean. facoltativo. Usare quando Action = Deploy && UseStagingDeployment = false. Valore predefinito: false.

Se impostato su truee la distribuzione specificata da DeploymentName non esiste in fase di esecuzione, verrà creata. Se omesso, il DeploymentName parametro deve essere impostato.

DeploymentName - Distribuzione
string. facoltativo. Usare quando UseStagingDeployment = false && Action != Delete Staging Deployment.

Distribuzione a cui verrà applicata questa attività. Se non si usano distribuzioni blu-verde, impostare questo campo su default. Il valore deve iniziare con una lettera e deve essere costituito solo da lettere minuscole e numeri.

Package - Pacchetto o cartella
string. facoltativo. Usare quando Action = Deploy && DeploymentType = Artifacts. Valore predefinito: $(System.DefaultWorkingDirectory)/**/*.jar.

Percorso del file del pacchetto o della cartella contenente il contenuto dell'app Azure Spring Apps (.jar file per Java, .zip per .NET Core).
Sono supportate le variabili (versione | di compilazione) e i caratteri jolly.
Ad esempio: $(System.DefaultWorkingDirectory)/**/*.jar

Builder - Muratore
string. facoltativo. Usare quando Action = Deploy && DeploymentType = Artifacts.

Selezionare un generatore del servizio™ di compilazione VMware Tanzu®, che può essere usato nel livello enterprise.
Per una descrizione dettagliata, vedere Usare il servizio di compilazione Tanzu.

RegistryServer - Server del Registro di sistema
string. facoltativo. Usare quando Action = Deploy && DeploymentType = CustomContainer. Valore predefinito: docker.io.

Registro dell'immagine del contenitore. Impostazione predefinita: docker.io.

RegistryUsername - Nome utente registro
string. facoltativo. Usare quando Action = Deploy && DeploymentType = CustomContainer.

Nome utente del registro contenitori.

RegistryPassword - Password del Registro di sistema
string. facoltativo. Usare quando Action = Deploy && DeploymentType = CustomContainer.

Password del registro contenitori.

ImageName - Nome immagine e tag
string. facoltativo. Usare quando Action = Deploy && DeploymentType = CustomContainer. Valore predefinito: hello-world:v1.

Tag dell'immagine del contenitore.

ImageCommand - Comando Image
string. facoltativo. Usare quando Action = Deploy && DeploymentType = CustomContainer.

Comando dell'immagine del contenitore.

ImageArgs - Argomenti immagine
string. facoltativo. Usare quando Action = Deploy && DeploymentType = CustomContainer.

Argomenti dell'immagine del contenitore.

ImageLanguageFramework - Framework del linguaggio
string. facoltativo. Usare quando Action = Deploy && DeploymentType = CustomContainer. Valori consentiti: springboot.

EnvironmentVariables - Variabili di ambiente
string. facoltativo. Usare quando Action = Deploy.

Le variabili di ambiente da immettere usando la sintassi -key value ( ad esempio : -CUSTOMER_NAME Contoso-WEBSITE_TIME_ZONE). I valori contenenti spazi devono essere racchiusi tra virgolette doppie (ad esempio: "Eastern Standard Time").

JvmOptions - Opzioni JVM
string. facoltativo. Usare quando Action = Deploy && DeploymentType = Artifacts.

Modifica le opzioni JVM dell'app. Stringa contenente opzioni JVM, ad esempio -Xms1024m -Xmx2048m.

RuntimeVersion - Versione di runtime
string. facoltativo. Usare quando Action = Deploy && DeploymentType = Artifacts. Valori consentiti: Java_8 (Java 8), (Java 11), (Java 17 Java_21 ), Java_11Java_17 (Java 21), NetCore_31 (.NET Core 3.1). Valore predefinito: Java_11.

Versione di runtime in cui verrà eseguita l'app.

DotNetCoreMainEntryPath - Percorso di ingresso principale
string. facoltativo. Usare quando RuntimeVersion = NetCore_31.

Percorso dell'eseguibile .NET relativo alla radice zip.

Version - Versione
string. facoltativo. Usare quando Action = Deploy.

Versione della distribuzione. Se non è impostato, la versione viene lasciata invariata.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Questa attività definisce le variabili di output seguenti, che è possibile usare nei passaggi, nei processi e nelle fasi downstream.

testEndpoint
Dopo l'azione "Distribuisci" solo. Contiene l'URL privato per l'accesso alla distribuzione aggiornata.

Commenti

Usare questa attività per distribuire applicazioni in Azure Spring Apps e per gestire le distribuzioni di Azure Spring Cloud.

Importante

Questa attività è supportata nei piani Basic/Standard e Enterprise di Azure Spring Apps. Per altre informazioni, vedere Automatizzare le distribuzioni di applicazioni in Azure Spring Apps.

Esempio

Negli esempi seguenti vengono illustrati gli scenari di utilizzo comuni. Per altre informazioni, vedere Automatizzare le distribuzioni di applicazioni in Azure Spring Apps.

Eliminazione di una distribuzione di staging

L'azione "Elimina distribuzione di staging" consente di eliminare la distribuzione che non riceve il traffico di produzione. Questo consente di liberare le risorse usate da tale distribuzione e rende disponibile una nuova distribuzione di staging:

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

Distribuzione

Produzione

Nell'esempio seguente viene distribuita la distribuzione di produzione predefinita in Azure Spring Apps. Si tratta dell'unico scenario di distribuzione possibile quando si usa lo SKU Di base:

Nota

Il modello di ricerca del pacchetto deve restituire solo un pacchetto. Se l'attività di compilazione produce più pacchetti JAR, ad esempio sources.jar e javadoc.jar, è necessario perfezionare il modello di ricerca in modo che corrisponda solo all'artefatto binario dell'applicazione.

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'

Blu-verde

Nell'esempio seguente viene distribuita una distribuzione di staging preesistente. Questa distribuzione non riceverà il traffico di produzione finché non viene impostato come distribuzione di produzione.

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'

Per altre distribuzioni blu-verde, incluso un approccio alternativo, vedere Strategie di distribuzione blu-verde.

Impostazione della distribuzione di produzione

Nell'esempio seguente viene impostata la distribuzione di staging corrente come produzione, scambiando in modo efficace la distribuzione che riceve il traffico di produzione.

variables:
  azureSubscription: Contoso

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

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Esecuzione in	Agente, DeploymentGroup
Richieste	Nessuno
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	2.104.1 o versione successiva
Categoria attività	Distribuire