Partager via

AzureSpringCloud@0 - Tâche Azure Spring Apps v0

Cette tâche déploie des applications dans Azure Spring Apps et gère ces déploiements.

Important

Cette tâche est prise en charge sur les offres Azure Spring Apps Basic/Standard et Enterprise. Pour plus d’informations, consultez Automatiser les déploiements d’applications sur Azure Spring Apps.

Syntaxe

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

Données d'entrée

azureSubscription - abonnement Azure
Alias d’entrée : ConnectedServiceName. string. Obligatoire.

Spécifie l’abonnement Azure Resource Manager pour le déploiement.


Action - action
string. Obligatoire. Valeurs autorisées : Deploy, Set Production (Définir le déploiement de production), Delete Staging Deployment. Valeur par défaut : Deploy.

L’action à effectuer sur Azure Spring Apps.


AzureSpringCloud - Nom d’Azure Spring Apps
string. Obligatoire.

Nom ou ID de ressource de l’instance Azure Spring Apps à déployer.


AppName - Appli
string. Obligatoire.

Nom de l’application Azure Spring Apps à déployer. L’application doit exister avant l’exécution de la tâche.


DeploymentType - Type de déploiement
string. Optionnel. Utilisez quand Action = Deploy. Valeurs autorisées : Artifacts, CustomContainer (Conteneur personnalisé). Valeur par défaut : Artifacts.

Pour déployer avec du code source ou un package Java, choisissez « Artefacts » ; Pour déployer avec une image de conteneur, choisissez « Conteneur personnalisé ».


UseStagingDeployment - Utiliser le déploiement intermédiaire
boolean. Optionnel. Utilisez quand Action = Deploy || Action = Set Production. Valeur par défaut : true.

Au moment de l’exécution de la tâche, cette entrée sélectionne automatiquement le déploiement défini sur staging.

Si la valeur est , trueappliquez la tâche au déploiement défini comme déploiement intermédiaire au moment de l’exécution. S’il est omis, le DeploymentName paramètre doit être défini.


CreateNewDeployment - Créez un déploiement intermédiaire s’il n’en existe pas.
boolean. Optionnel. Utilisez quand Action = Deploy && UseStagingDeployment = false. Valeur par défaut : false.

Si la valeur est , trueet que le déploiement spécifié par DeploymentName n’existe pas au moment de l’exécution, il est créé. S’il est omis, le DeploymentName paramètre doit être défini.


DeploymentName - Déploiement
string. Optionnel. Utilisez quand UseStagingDeployment = false && Action != Delete Staging Deployment.

Déploiement auquel cette tâche s’appliquera. Si vous n’utilisez pas de déploiements bleu-vert, définissez ce champ sur default. La valeur doit commencer par une lettre et se composer uniquement de lettres minuscules et de chiffres.


Package - package ou dossier
string. Optionnel. Utilisez quand Action = Deploy && DeploymentType = Artifacts. Valeur par défaut : $(System.DefaultWorkingDirectory)/**/*.jar.

Chemin d’accès au package ou au dossier contenant le contenu de l’application Azure Spring Apps (.jar fichier pour Java, .zip pour .NET Core).
Les variables (Build | Release) et les caractères génériques sont pris en charge.
Par exemple, $(System.DefaultWorkingDirectory)/**/*.jar


Package - package ou dossier
string. Optionnel. Utilisez quand Action = Deploy. Valeur par défaut : $(System.DefaultWorkingDirectory)/**/*.jar.

Chemin d’accès au package ou au dossier contenant le contenu de l’application Azure Spring Apps (.jar fichier pour Java, .zip pour .NET Core).
Les variables (Build | Release) et les caractères génériques sont pris en charge.
Par exemple, $(System.DefaultWorkingDirectory)/**/*.jar


Builder - Constructeur
string. Optionnel. Utilisez quand Action = Deploy && DeploymentType = Artifacts.

Sélectionnez un constructeur de VMware Tanzu® Build Service™, qui peut être utilisé au niveau entreprise.
Pour une description détaillée, veuillez consulter Utiliser le service de compilation Tanzu.


RegistryServer - Serveur de registre
string. Optionnel. Utilisez quand Action = Deploy && DeploymentType = CustomContainer. Valeur par défaut : docker.io.

Registre de l’image conteneur. Par défaut : docker.io.


RegistryUsername - Nom d’utilisateur du registre
string. Optionnel. Utilisez quand Action = Deploy && DeploymentType = CustomContainer.

Nom d’utilisateur du registre de conteneurs.


RegistryPassword - mot de passe du Registre
string. Optionnel. Utilisez quand Action = Deploy && DeploymentType = CustomContainer.

Mot de passe du registre de conteneurs.


ImageName - Nom et balise de l’image
string. Optionnel. Utilisez quand Action = Deploy && DeploymentType = CustomContainer. Valeur par défaut : hello-world:v1.

Balise d’image conteneur.


ImageCommand - Commande Image
string. Optionnel. Utilisez quand Action = Deploy && DeploymentType = CustomContainer.

Commande de l’image conteneur.


ImageArgs - Arguments de l’image
string. Optionnel. Utilisez quand Action = Deploy && DeploymentType = CustomContainer.

Arguments de l’image conteneur.


ImageLanguageFramework - Cadre linguistique
string. Optionnel. Utilisez quand Action = Deploy && DeploymentType = CustomContainer. Valeurs autorisées : springboot.


variables d’environnement EnvironmentVariables -
string. Optionnel. Utilisez quand Action = Deploy.

Les variables d’environnement à saisir à l’aide de la syntaxe -key value (par exemple : -CUSTOMER_NAME Contoso-WEBSITE_TIME_ZONE). Les valeurs contenant des espaces doivent être placées entre guillemets doubles (par exemple : "Eastern Standard Time").


JvmOptions - JVM Options
string. Optionnel. Utilisez quand Action = Deploy && DeploymentType = Artifacts.

Modifie les options JVM de l’application. Chaîne contenant des options JVM, telles que -Xms1024m -Xmx2048m.


JvmOptions - JVM Options
string. Optionnel. Utilisez quand Action = Deploy.

Modifie les options JVM de l’application. Chaîne contenant des options JVM, telles que -Xms1024m -Xmx2048m.


RuntimeVersion - Version d’exécution
string. Optionnel. Utilisez quand Action = Deploy && DeploymentType = Artifacts. Valeurs autorisées : Java_8 (Java 8), Java_11 (Java 11), Java_17 (Java 17), Java_21 (Java 21), NetCore_31 (.Net Core 3.1). Valeur par défaut : Java_11.

Version d’exécution sur laquelle l’application s’exécutera.


RuntimeVersion - Version d’exécution
string. Optionnel. Utilisez quand Action = Deploy && DeploymentType = Artifacts. Valeurs autorisées : Java_8 (Java 8), Java_11 (Java 11), NetCore_31 (.Net Core 3.1). Valeur par défaut : Java_11.

Version d’exécution sur laquelle l’application s’exécutera.


RuntimeVersion - Version d’exécution
string. Optionnel. Utilisez quand Action = Deploy. Valeurs autorisées : Java_8 (Java 8), Java_11 (Java 11), NetCore_31 (.Net Core 3.1). Valeur par défaut : Java_11.

Version d’exécution sur laquelle l’application s’exécutera.


DotNetCoreMainEntryPath - Chemin d’entrée principal
string. Optionnel. Utilisez quand RuntimeVersion = NetCore_31.

Chemin d’accès à l’exécutable .NET par rapport à la racine zip.


Version - version
string. Optionnel. Utilisez quand Action = Deploy.

La version de déploiement. S’il n’est pas défini, la version reste inchangée.


Options de contrôle de tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâche. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Cette tâche définit les variables de sortie suivantes, que vous pouvez utiliser en aval, les travaux et les étapes.

testEndpoint
Après l’action « Déployer » uniquement. Contient l’URL privée permettant d’accéder au déploiement mis à jour.

Remarques

La procédure décrite ci-dessous permet de déployer des applications dans Azure Spring Apps et de gérer les déploiements dans le cloud Azure Spring.

Important

Cette tâche est prise en charge sur les offres Azure Spring Apps Basic/Standard et Enterprise. Pour plus d’informations, consultez Automatiser les déploiements d’applications sur Azure Spring Apps.

Exemples

Les exemples suivants illustrent des scénarios d’utilisation courante. Pour plus d’informations, consultez Automatiser les déploiements d’applications sur Azure Spring Apps.

Supprimer un déploiement de préproduction

L’action « Supprimer le déploiement intermédiaire » vous permet de supprimer le déploiement ne recevant pas de trafic de production. Cela libère les ressources utilisées par ce déploiement et fait de la place pour un nouveau déploiement intermédiaire :

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

Déploiement

En production

L’exemple suivant est déployé sur le déploiement de production par défaut dans Azure Spring Apps. Il s’agit du seul scénario de déploiement possible lors de l’utilisation de la référence SKU de base :

Remarque

Le modèle de recherche de package ne doit retourner qu’un seul package. Si la tâche de build produit plusieurs packages JAR tels que sources.jar et javadoc.jar, vous devez affiner le modèle de recherche afin qu’il corresponde uniquement à l’artefact binaire de l’application.

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'

Bleu-vert

L’exemple suivant effectue un déploiement dans un déploiement intermédiaire préexistant. Ce déploiement ne recevra pas de trafic de production tant qu’il n’aura pas été défini en tant que déploiement de production.

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'

Pour plus d’informations sur les déploiements bleu-vert, y compris une approche alternative, consultez Stratégies de déploiement bleu-vert.

Définition du déploiement de production

L’exemple suivant définit le déploiement de préproduction actuel en tant que déploiement de production, en permutant le déploiement qui reçoit le trafic de production.

variables:
  azureSubscription: Contoso

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

Spécifications

Besoin Descriptif
Types de pipelines YAML, Build Classique, Version Classique
Exécutions sur Agent, DeploymentGroup
demandes Aucun
Capacités Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande N'importe lequel
variables settables N'importe lequel
Version de l’agent 2.104.1 ou version ultérieure
Catégorie de tâche Déployer
  • Last updated on