AzureSpringCloud@0 - Tarea de Azure Spring Apps v0

2025-06-24

Esta tarea implementa aplicaciones en Azure Spring Apps y administra esas implementaciones.

Importante

Esta tarea es compatible con los planes Básico/Estándar y Enterprise de Azure Spring Apps. Para más información, consulte Automatización de implementaciones de aplicaciones en Azure Spring Apps.

Sintaxis

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

Entradas

azureSubscription - de suscripción de Azure
Alias de entrada: ConnectedServiceName. string. Obligatorio.

Especifica la suscripción de Azure Resource Manager para la implementación.

Action - acción
string. Obligatorio. Valores permitidos: Deploy, Set Production (Establecer implementación de producción), Delete Staging Deployment. Valor predeterminado: Deploy.

La acción que se va a realizar en Azure Spring Apps.

AzureSpringCloud - Nombre de Azure Spring Apps
string. Obligatorio.

El nombre o el identificador de recurso de la instancia de Azure Spring Apps que se va a implementar.

AppName - Aplicación
string. Obligatorio.

Nombre de la aplicación de Azure Spring Apps que se va a implementar. La aplicación debe existir antes de la ejecución de la tarea.

DeploymentType - Tipo de implementación
string. Opcional. Use cuando Action = Deploy. Valores permitidos: Artifacts, CustomContainer (contenedor personalizado). Valor predeterminado: Artifacts.

Para implementar con código fuente o paquete Java, elija "Artefactos"; Para implementar con una imagen de contenedor, elija "Contenedor personalizado".

UseStagingDeployment - Uso de la implementación de ensayo
boolean. Opcional. Use cuando Action = Deploy || Action = Set Production. Valor predeterminado: true.

En el momento en que se ejecuta la tarea, esta entrada selecciona automáticamente la implementación que se establece como staging.

Si se establece en true, aplique la tarea a la implementación que se establece como implementación provisional en el momento de la ejecución. Si se omite, se debe establecer el DeploymentName parámetro.

CreateNewDeployment - Cree una nueva implementación de ensayo si no existe ninguna.
boolean. Opcional. Use cuando Action = Deploy && UseStagingDeployment = false. Valor predeterminado: false.

Si se establece en true, y la implementación especificada por DeploymentName no existe en tiempo de ejecución, se creará. Si se omite, se debe establecer el DeploymentName parámetro.

DeploymentName - Despliegue
string. Opcional. Use cuando UseStagingDeployment = false && Action != Delete Staging Deployment.

La implementación a la que se aplicará esta tarea. Si no utiliza implementaciones azul-verde, establezca este campo en default. El valor debe comenzar con una letra y constar únicamente de letras minúsculas y números.

Package - Paquete o carpeta
string. Opcional. Use cuando Action = Deploy && DeploymentType = Artifacts. Valor predeterminado: $(System.DefaultWorkingDirectory)/**/*.jar.

Ruta de acceso del archivo al paquete o carpeta que contiene el contenido de la aplicación Azure Spring Apps (.jar archivo para Java, .zip para .NET Core).
Se admiten variables ( versión | de compilación) y caracteres comodín.
Por ejemplo: $(System.DefaultWorkingDirectory)/**/*.jar

Package - Paquete o carpeta
string. Opcional. Use cuando Action = Deploy. Valor predeterminado: $(System.DefaultWorkingDirectory)/**/*.jar.

Builder - Constructor
string. Opcional. Use cuando Action = Deploy && DeploymentType = Artifacts.

Seleccione un compilador de VMware Tanzu® Build Service™, esto se puede usar en el nivel empresarial.
Para obtener una descripción detallada, consulte Usar el servicio de construcción de Tanzu.

RegistryServer - Servidor de Registro
string. Opcional. Use cuando Action = Deploy && DeploymentType = CustomContainer. Valor predeterminado: docker.io.

Registro de la imagen de contenedor. Predeterminado: docker.io.

RegistryUsername - Nombre de usuario del registro
string. Opcional. Use cuando Action = Deploy && DeploymentType = CustomContainer.

El nombre de usuario del registro de contenedor.

de contraseña del Registro de RegistryPassword -
string. Opcional. Use cuando Action = Deploy && DeploymentType = CustomContainer.

Contraseña del registro de contenedor.

ImageName - Nombre y etiqueta de la imagen
string. Opcional. Use cuando Action = Deploy && DeploymentType = CustomContainer. Valor predeterminado: hello-world:v1.

Etiqueta de imagen de contenedor.

ImageCommand - Comando de imagen
string. Opcional. Use cuando Action = Deploy && DeploymentType = CustomContainer.

Comando de la imagen de contenedor.

ImageArgs - Argumentos de imagen
string. Opcional. Use cuando Action = Deploy && DeploymentType = CustomContainer.

Argumentos de la imagen de contenedor.

ImageLanguageFramework - Marco lingüístico
string. Opcional. Use cuando Action = Deploy && DeploymentType = CustomContainer. Valores permitidos: springboot.

EnvironmentVariables - variables de entorno
string. Opcional. Use cuando Action = Deploy.

Las variables de entorno que se van a introducir mediante la sintaxis -key value (por ejemplo: -CUSTOMER_NAME Contoso-WEBSITE_TIME_ZONE). Los valores que contienen espacios deben ir entre comillas dobles (por ejemplo: "Eastern Standard Time").

JvmOptions - Opciones de JVM
string. Opcional. Use cuando Action = Deploy && DeploymentType = Artifacts.

Edita las opciones de JVM de la aplicación. Una serie que contiene opciones de JVM, como -Xms1024m -Xmx2048m.

JvmOptions - Opciones de JVM
string. Opcional. Use cuando Action = Deploy.

Edita las opciones de JVM de la aplicación. Una serie que contiene opciones de JVM, como -Xms1024m -Xmx2048m.

RuntimeVersion - Versión en tiempo de ejecución
string. Opcional. Use cuando Action = Deploy && DeploymentType = Artifacts. Valores permitidos: Java_8 (Java 8), Java_11 (Java 11), Java_17 (Java 17), Java_21 (Java 21), NetCore_31 (.Net Core 3.1). Valor predeterminado: Java_11.

La versión del entorno de ejecución en la que se ejecutará la aplicación.

RuntimeVersion - Versión en tiempo de ejecución
string. Opcional. Use cuando Action = Deploy && DeploymentType = Artifacts. Valores permitidos: Java_8 (Java 8), Java_11 (Java 11), NetCore_31 (.Net Core 3.1). Valor predeterminado: Java_11.

La versión del entorno de ejecución en la que se ejecutará la aplicación.

RuntimeVersion - Versión en tiempo de ejecución
string. Opcional. Use cuando Action = Deploy. Valores permitidos: Java_8 (Java 8), Java_11 (Java 11), NetCore_31 (.Net Core 3.1). Valor predeterminado: Java_11.

La versión del entorno de ejecución en la que se ejecutará la aplicación.

DotNetCoreMainEntryPath - Ruta de entrada principal
string. Opcional. Use cuando RuntimeVersion = NetCore_31.

Ruta de acceso al archivo ejecutable de .NET en relación con la raíz zip.

Version - versión
string. Opcional. Use cuando Action = Deploy.

La versión de implementación. Si no se establece, la versión no se modifica.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.

Variables de salida

Esta tarea define las siguientes variables de salida , que puede consumir en pasos, trabajos y fases de bajada.

testEndpoint
Solo después de la acción 'Desplegar'. Contiene una dirección URL privada para acceder a la implementación actualizada.

Observaciones

Use esta tarea para implementar aplicaciones en Azure Spring Apps y para administrar implementaciones de Azure Spring Cloud.

Importante

Esta tarea es compatible con los planes Básico/Estándar y Enterprise de Azure Spring Apps. Para más información, consulte Automatización de implementaciones de aplicaciones en Azure Spring Apps.

Ejemplos

En los ejemplos siguientes, se muestran escenarios de uso habituales. Para más información, consulte Automatización de implementaciones de aplicaciones en Azure Spring Apps.

Eliminación de una implementación de almacenamiento provisional

La acción "Eliminar implementación de ensayo" le permite eliminar la implementación que no recibe tráfico de producción. Esto libera los recursos utilizados por esa implementación y deja espacio para una nueva implementación de ensayo:

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

Desplegando

En producción

En el ejemplo siguiente se implementa en la implementación de producción predeterminada de Azure Spring Apps. Este es el único escenario de implementación posible cuando se usa la SKU básica:

Nota:

El patrón de búsqueda de paquetes solo debe devolver exactamente un paquete. Si la tarea de compilación genera varios paquetes JAR como sources.jar y javadoc.jar, debe refinar el patrón de búsqueda para que solo coincida con el artefacto binario de la aplicación.

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'

Azul-verde

En el ejemplo siguiente se implementa en una implementación de ensayo preexistente. Esta implementación no recibirá tráfico de producción hasta que se establezca como una implementación de producción.

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'

Para obtener más información sobre las implementaciones azul-verde, incluido un enfoque alternativo, consulte Estrategias de implementación azul-verde.

Definición de la implementación de producción

El siguiente ejemplo establece la implementación de ensayo actual como producción, intercambiando efectivamente qué implementación recibe el tráfico de producción.

variables:
  azureSubscription: Contoso

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

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
demandas	Ninguno
Capacidades	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos	Cualquiera
variables settable	Cualquiera
Versión del agente	2.104.1 o superior
Categoría de tarea	Desplegar

Compartir a través de

AzureSpringCloud@0 - Tarea de Azure Spring Apps v0

Sintaxis

Entradas

Opciones de control de tareas

Variables de salida

Observaciones

Ejemplos

Eliminación de una implementación de almacenamiento provisional

Desplegando

En producción

Azul-verde

Definición de la implementación de producción

Requisitos

Comentarios

Recursos adicionales