AzureAppServiceSettings@1 - tâche Paramètres Azure App Service v1

Mises à jour ou ajoute des paramètres app service dans une application web Azure pour Linux ou Windows.

Syntaxe

# Azure App Service Settings v1
# Update/Add App settings an Azure Web App for Linux or Windows.
- task: AzureAppServiceSettings@1
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    appName: # string. Required. App Service name. 
    resourceGroupName: # string. Required. Resource group. 
    #slotName: 'production' # string. Slot. Default: production.
  # Application and Configuration Settings
    #appSettings: # string. App settings. 
    #generalSettings: # string. General settings. 
    #connectionStrings: # string. Connection Strings.

Entrées

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

Sélectionne l’abonnement Azure Resource Manager.

appName - App Service nom
string. Obligatoire.

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

resourceGroupName - Groupe de ressources
string. Obligatoire.

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

slotName - Fente
string. Valeur par défaut : production.

Entre ou sélectionne un emplacement existant. Si vous ne sélectionnez pas d’emplacement, des modifications sont apportées à la production.

appSettings - Paramètres de l’application
string.

Paramètres d’application dans la syntaxe JSON. Entourez les valeurs contenant des espaces entre guillemets doubles. Pour plus d’informations, consultez Configuration des paramètres de l’application.

Voici un exemple de syntaxe JSON :

[
   {
    "name": "key1",
    "value": "valueabcd",
    "slotSetting": false
   },
   {
    "name": "key2",
    "value": "valueefgh",
    "slotSetting": true
   }
]

generalSettings - Paramètres généraux
string.

Paramètres généraux dans la syntaxe JSON. Entourez les valeurs contenant des espaces entre guillemets doubles. Pour obtenir la liste des propriétés disponibles, consultez la documentation de l’objet SiteConfig App Service. Pour plus d’informations, consultez Configurer les paramètres généraux.

Voici un exemple de syntaxe JSON :

[
   {
    "alwaysOn": true,
    "webSocketsEnabled": false
   }
]

connectionStrings - Chaînes de connexion
string.

Chaînes de connexion dans la syntaxe JSON. Entourez les valeurs contenant des espaces entre guillemets doubles. Pour plus d’informations, consultez Configurer des chaînes de connexion.

Voici un exemple de syntaxe JSON :

[
   {
    "name": "key1",
    "value": "valueabcd",
    "type": "MySql",
    "slotSetting": false
   },
   {
    "name": "key2",
    "value": "valueefgh",
    "type": "Custom",
    "slotSetting": true
   }
]

Options de contrôle des tâches

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

Aucun.

Notes

Utilisez cette tâche pour configurer les paramètres d’application, les chaînes de connexion et d’autres paramètres généraux en bloc à l’aide de la syntaxe JSON sur votre application web ou l’un de ses emplacements de déploiement. La tâche fonctionne sur les agents Azure Pipelines multiplateformes exécutant Windows, Linux ou Mac. La tâche fonctionne pour les applications web ASP.NET, ASP.NET Core, PHP, Java, Python, Go et Node.js.

Exemples

L’exemple d’extrait de code YAML suivant déploie une application web sur un service Azure Web App s’exécutant sur Windows.

variables:
  azureSubscription: Contoso
  WebApp_Name: sampleWebApp
  # To ignore SSL error uncomment the below variable
  # VSTS_ARM_REST_IGNORE_SSL_ERRORS: true

steps:

- task: AzureWebApp@1
  displayName: Azure Web App Deploy
  inputs:
    azureSubscription: $(azureSubscription)
    appName: $(WebApp_Name)
    package: $(System.DefaultWorkingDirectory)/**/*.zip

- task: AzureAppServiceSettings@1
  displayName: Azure App Service Settings
  inputs:
    azureSubscription: $(azureSubscription)
    appName: $(WebApp_Name)
   # To deploy the settings on a slot, provide slot name as below. By default, the settings would be applied to the actual Web App (Production slot)
   # slotName: staging
    appSettings: |
      [
        {
          "name": "APPINSIGHTS_INSTRUMENTATIONKEY",
          "value": "$(Key)",
          "slotSetting": false
        },
        {
          "name": "MYSQL_DATABASE_NAME",
          "value": "$(DB_Name)", 
          "slotSetting": false
        }
      ]
    generalSettings: |
      [
        {
          "alwaysOn": true,
          "webSocketsEnabled": false
        }
      ]
    connectionStrings: |
      [
        {
          "name": "MysqlCredentials",
          "value": "$(MySQl_ConnectionString)",
          "type": "MySql",
          "slotSetting": false
        }
      ]

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 commandes	Quelconque
Variables settables	Quelconque
Version de l’agent	2.104.1 ou version ultérieure
Catégorie de la tâche	Déployer