AzureAppServiceManage@0 - Azure App Service gérer la tâche v0

  • Article

Démarrer, arrêter, redémarrer, échanger un emplacement, supprimer un emplacement, installer des extensions de site ou activer la surveillance continue d’un Azure App Service.

Démarrez, arrêtez, redémarrez, échangez d’emplacements, installez des extensions de site ou activez la surveillance continue pour un Azure App Service.

Syntax

# Azure App Service manage v0
# Start, stop, restart, slot swap, slot delete, install site extensions or enable continuous monitoring for an Azure App Service.
- task: AzureAppServiceManage@0
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    #Action: 'Swap Slots' # 'Swap Slots' | 'Start Azure App Service' | 'Stop Azure App Service' | 'Restart Azure App Service' | 'Start Swap With Preview' | 'Complete Swap' | 'Cancel Swap' | 'Delete Slot' | 'Install Extensions' | 'Enable Continuous Monitoring' | 'Start all continuous webjobs' | 'Stop all continuous webjobs'. Action. Default: Swap Slots.
    WebAppName: # string. Required. App Service name. 
    #SpecifySlotOrASE: false # boolean. Alias: SpecifySlot. Optional. Use when Action != Swap Slots && Action != Delete Slot && Action != Start Swap With Preview && Action != Complete Swap && Action != Cancel Swap. Specify Slot or App Service Environment. Default: false.
    #ResourceGroupName: # string. Required when Action = Swap Slots || Action = Delete Slot || SpecifySlot = true || Action = Start Swap With Preview || Action = Complete Swap || Action = Cancel Swap. Resource group. 
    #SourceSlot: # string. Required when Action = Swap Slots || Action = Start Swap With Preview  || Action = Complete Swap. Source Slot. 
    #SwapWithProduction: true # boolean. Optional. Use when Action = Swap Slots || Action = Start Swap With Preview  || Action = Complete Swap. Swap with Production. Default: true.
    #TargetSlot: # string. Required when SwapWithProduction = false. Target Slot. 
    #PreserveVnet: false # boolean. Optional. Use when Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap. Preserve Vnet. Default: false.
    #Slot: 'production' # string. Required when Action = Delete Slot || Action = Cancel Swap || SpecifySlot = true. Slot. Default: production.
    #ExtensionsList: # string. Required when Action = Install Extensions. Install Extensions. 
    #OutputVariable: # string. Optional. Use when Action = Install Extensions. Output variable. 
    #AppInsightsResourceGroupName: # string. Required when Action == Enable Continuous Monitoring. Resource Group name for Application Insights. 
    #ApplicationInsightsResourceName: # string. Required when Action == Enable Continuous Monitoring. Application Insights resource name. 
  # Advanced Settings
    #ApplicationInsightsWebTestName: # string. Optional. Use when Action == Enable Continuous Monitoring. Application Insights web test name.

# Azure App Service manage v0
# Start, stop, restart, slot swap, install site extensions or enable continuous monitoring for an Azure App Service.
- task: AzureAppServiceManage@0
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    #Action: 'Swap Slots' # 'Swap Slots' | 'Start Azure App Service' | 'Stop Azure App Service' | 'Restart Azure App Service' | 'Install Extensions' | 'Enable Continuous Monitoring' | 'Start all continuous webjobs' | 'Stop all continuous webjobs'. Action. Default: Swap Slots.
    WebAppName: # string. Required. App Service name. 
    #SpecifySlotOrASE: false # boolean. Alias: SpecifySlot. Optional. Use when Action != Swap Slots. Specify Slot or App Service Environment. Default: false.
    #ResourceGroupName: # string. Required when Action = Swap Slots || SpecifySlot = true. Resource group. 
    #SourceSlot: # string. Required when Action = Swap Slots. Source Slot. 
    #SwapWithProduction: true # boolean. Optional. Use when Action = Swap Slots. Swap with Production. Default: true.
    #TargetSlot: # string. Required when Action = Swap Slots && SwapWithProduction = false. Target Slot. 
    #PreserveVnet: false # boolean. Optional. Use when Action = Swap Slots. Preserve Vnet. Default: false.
    #Slot: 'production' # string. Required when Action != Swap Slots && SpecifySlot = true. Slot. Default: production.
    #ExtensionsList: # string. Required when Action = Install Extensions. Install Extensions. 
    #OutputVariable: # string. Optional. Use when Action = Install Extensions. Output variable. 
    #AppInsightsResourceGroupName: # string. Required when Action == Enable Continuous Monitoring. Resource Group name for Application Insights. 
    #ApplicationInsightsResourceName: # string. Required when Action == Enable Continuous Monitoring. Application Insights resource name. 
  # Advanced Settings
    #ApplicationInsightsWebTestName: # string. Optional. Use when Action == Enable Continuous Monitoring. Application Insights web test name.

# Azure App Service Manage v0
# Start, Stop, Restart, Slot swap, Install site extensions or Enable Continuous Monitoring for an Azure App Service.
- task: AzureAppServiceManage@0
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    #Action: 'Swap Slots' # 'Swap Slots' | 'Start Azure App Service' | 'Stop Azure App Service' | 'Restart Azure App Service' | 'Install Extensions' | 'Enable Continuous Monitoring' | 'Start all continuous webjobs' | 'Stop all continuous webjobs'. Action. Default: Swap Slots.
    WebAppName: # string. Required. App Service name. 
    #SpecifySlotOrASE: false # boolean. Alias: SpecifySlot. Optional. Use when Action != Swap Slots. Specify Slot or App Service Environment. Default: false.
    #ResourceGroupName: # string. Required when Action = Swap Slots || SpecifySlot = true. Resource group. 
    #SourceSlot: # string. Required when Action = Swap Slots. Source Slot. 
    #SwapWithProduction: true # boolean. Optional. Use when Action = Swap Slots. Swap with Production. Default: true.
    #TargetSlot: # string. Required when Action = Swap Slots && SwapWithProduction = false. Target Slot. 
    #PreserveVnet: false # boolean. Optional. Use when Action = Swap Slots. Preserve Vnet. Default: false.
    #Slot: 'production' # string. Required when Action != Swap Slots && SpecifySlot = true. Slot. Default: production.
    #ExtensionsList: # string. Required when Action = Install Extensions. Install Extensions. 
    #OutputVariable: # string. Optional. Use when Action = Install Extensions. Output variable. 
    #AppInsightsResourceGroupName: # string. Required when Action == Enable Continuous Monitoring. Resource Group name for Application Insights. 
    #ApplicationInsightsResourceName: # string. Required when Action == Enable Continuous Monitoring. Application Insights resource name. 
  # Advanced Settings
    #ApplicationInsightsWebTestName: # string. Optional. Use when Action == Enable Continuous Monitoring. Application Insights web test name.

Entrées

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

Sélectionne l’abonnement Azure Resource Manager.


Action - Action
string. Valeurs autorisées : Swap Slots, Start Azure App Service (Démarrer App Service), Stop Azure App Service (Arrêter App Service), Restart Azure App Service (Redémarrer App Service), Start Swap With Preview, Complete Swap (Terminer l’échange avec la préversion), Cancel Swap (Annuler l’échange avec préversion), Delete Slot, Install Extensions, Enable Continuous Monitoring, Start all continuous webjobs, Stop all continuous webjobs. Valeur par défaut : Swap Slots.

facultatif. Définit l’action à effectuer sur le App Service. Vous pouvez démarrer, arrêter, redémarrer, échanger des emplacements, démarrer l’échange avec une préversion, terminer l’échange avec une préversion, annuler l’échange avec une préversion, installer des extensions de site ou activer la surveillance continue d’un Azure App Service.


Action - Action
string. Valeurs autorisées : Swap Slots, Start Azure App Service (Démarrer App Service), Stop Azure App Service (Arrêter App Service), Restart Azure App Service (Redémarrer App Service), Install Extensions, Enable Continuous Monitoring, Start all continuous webjobs, Stop all continuous webjobs. Valeur par défaut : Swap Slots.

facultatif. Définit l’action à effectuer sur le App Service. Vous pouvez démarrer, arrêter, redémarrer, échanger des emplacements, démarrer l’échange avec une préversion, terminer l’échange avec une préversion, annuler l’échange avec une préversion, installer des extensions de site ou activer la surveillance continue d’un Azure App Service.


WebAppName - App Service nom
string. Obligatoire.

Entre ou sélectionne le nom d’un Azure App Service existant.


SpecifySlotOrASE - Spécifier un emplacement ou un App Service Environment
Alias d’entrée : SpecifySlot. boolean. facultatif. Utilisez quand Action != Swap Slots && Action != Delete Slot && Action != Start Swap With Preview && Action != Complete Swap && Action != Cancel Swap. Valeur par défaut : false.


SpecifySlotOrASE - Spécifier un emplacement ou un App Service Environment
Alias d’entrée : SpecifySlot. boolean. facultatif. Utilisez quand Action != Swap Slots. Valeur par défaut : false.


ResourceGroupName - Groupe de ressources
string. Nécessaire lorsque Action = Swap Slots || Action = Delete Slot || SpecifySlot = true || Action = Start Swap With Preview || Action = Complete Swap || Action = Cancel Swap.

Entre ou sélectionne le groupe de ressources Azure qui contient les Azure App Service spécifiés ci-dessus.


ResourceGroupName - Groupe de ressources
string. Nécessaire lorsque Action = Swap Slots || SpecifySlot = true.

Entre ou sélectionne le groupe de ressources Azure qui contient les Azure App Service spécifiés ci-dessus.


SourceSlot - Emplacement source
string. Nécessaire lorsque Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap.

Utilisé comme emplacement source lorsque action == Swap Slots. L’action d’échange dirige le trafic de l’emplacement de destination vers l’emplacement source.


SourceSlot - Emplacement source
string. Nécessaire lorsque Action = Swap Slots.

Utilisé comme emplacement source lorsque action == Swap Slots. L’action d’échange dirige le trafic de l’emplacement de destination vers l’emplacement source.


SwapWithProduction - Échanger avec la production
boolean. facultatif. Utilisez quand Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap. Valeur par défaut : true.

Échange le trafic de l’emplacement source avec la production. Si vous ne sélectionnez pas cette option, vous devez fournir les noms des emplacements source et cible.


SwapWithProduction - Échanger avec la production
boolean. facultatif. Utilisez quand Action = Swap Slots. Valeur par défaut : true.

Échange le trafic de l’emplacement source avec la production. Si vous ne sélectionnez pas cette option, vous devez fournir les noms des emplacements source et cible.


TargetSlot - Emplacement cible
string. Nécessaire lorsque SwapWithProduction = false.

Utilisez comme emplacement de destination lorsque action == Swap Slots. L’action d’échange dirige le trafic de l’emplacement de destination vers l’emplacement source.


TargetSlot - Emplacement cible
string. Nécessaire lorsque Action = Swap Slots && SwapWithProduction = false.

Utilisez comme emplacement de destination lorsque action == Swap Slots. L’action d’échange dirige le trafic de l’emplacement de destination vers l’emplacement source.


PreserveVnet - Préserver le réseau virtuel
boolean. facultatif. Utilisez quand Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap. Valeur par défaut : false.

Conserve les paramètres de réseau virtuel.


PreserveVnet - Préserver le réseau virtuel
boolean. facultatif. Utilisez quand Action = Swap Slots. Valeur par défaut : false.

Conserve les paramètres de réseau virtuel.


Slot - Fente
string. Nécessaire lorsque Action = Delete Slot || Action = Cancel Swap || SpecifySlot = true. Valeur par défaut : production.


Slot - Fente
string. Nécessaire lorsque Action != Swap Slots && SpecifySlot = true. Valeur par défaut : production.


ExtensionsList - Installer les extensions
string. Nécessaire lorsque Action = Install Extensions.

Les extensions de site s’exécutent sur Microsoft Azure App Service. Vous pouvez installer un ensemble d’outils en tant qu’extension de site et mieux gérer votre Azure App Service. Redémarrez le App Service afin que les dernières modifications prennent effet.


OutputVariable - Variable de sortie
string. facultatif. Utilisez quand Action = Install Extensions.

Fournit le nom de la variable pour le chemin d’installation local de l’extension sélectionnée.

Ce champ est maintenant déprécié et sera supprimé. Utilisez la LocalPathsForInstalledExtensions variable de la section Variables de sortie dans les tâches suivantes.


AppInsightsResourceGroupName - Nom du groupe de ressources pour Application Insights
string. Nécessaire lorsque Action == Enable Continuous Monitoring.

Entre ou sélectionne le groupe de ressources dans lequel votre ressource Application Insights est disponible.


ApplicationInsightsResourceName - Nom de la ressource Application Insights
string. Nécessaire lorsque Action == Enable Continuous Monitoring.

Sélectionne la ressource Application Insights où les données de surveillance continue sont enregistrées.

Si votre ressource Application Insights n’est pas répertoriée ici et que vous souhaitez en créer une, sélectionnez +Nouveau. Une fois que vous avez créé la ressource dans le Portail Azure, revenez ici et sélectionnez Actualiser.


ApplicationInsightsWebTestName - Nom du test web Application Insights
string. facultatif. Utilisez quand Action == Enable Continuous Monitoring.

facultatif. Entre le nom de test web Application Insights que vous souhaitez créer ou mettre à jour.

Si vous ne fournissez pas de nom de test web, le nom de test par défaut est utilisé.


Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. 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 dans les étapes, les travaux et les étapes en aval.

LocalPathsForInstalledExtensions
Cette entrée est les chemins d’installation locaux pour les extensions que vous sélectionnez.

Si vous sélectionnez plusieurs extensions, la sortie est une liste de chemins d’accès locaux séparés par des virgules pour chacune des extensions que vous sélectionnez. La sortie répertorie les chemins dans l’ordre dans lequel ils apparaissent dans le champ Extensions d’installation.

Remarques

Cette tâche permet de démarrer, d’arrêter, de redémarrer, d’échanger des emplacements, d’échanger avec la préversion, d’installer des extensions de site ou d’activer la surveillance continue d’un Azure App Service.

Que se passe-t-il pendant un échange ?

Lorsque vous échangez deux emplacements (généralement d’un emplacement intermédiaire vers l’emplacement de production), assurez-vous que l’emplacement de production est toujours l’emplacement cible. De cette façon, l’opération d’échange n’affectera pas votre application de production.

De même, à n’importe quel point de l’opération d’échange (ou d’échange avec la préversion), tout le travail d’initialisation des applications échangées se produit sur l’emplacement source. L’emplacement cible reste en ligne pendant la préparation et l’initialisation de l’emplacement source, que l’échange ait réussi ou échoué.

Pour plus d’informations, consultez Configurer des environnements de préproduction dans Azure App Service.

Configuration requise

Condition requise Description
Types de pipelines YAML, build classique, version classique
S’exécute sur Agent, DeploymentGroup
Demandes None
Capabilities Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commande Quelconque
Variables paramétrables Quelconque
Version de l’agent 1.102.0 ou version ultérieure
Catégorie de la tâche Déployer