AzureAppServiceSettings@1 - taak Azure App Service-instellingen v1

Updates of voegt app service-instellingen toe in een Azure-web-app voor Linux of Windows.

Syntax

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

Invoerwaarden

azureSubscription - Azure-abonnement
Invoeralias: ConnectedServiceName. string. Vereist.

Selecteert het Azure Resource Manager-abonnement.

appName - naam van App Service
string. Vereist.

Hiermee wordt de naam van een bestaande Azure App Service ingevoerd of geselecteerd.

resourceGroupName - Resourcegroep
string. Vereist.

Hiermee wordt de Azure-resourcegroep met de hierboven opgegeven Azure App Service ingevoerd of geselecteerd.

slotName - Sleuf
string. Standaardwaarde: production.

Hiermee wordt een bestaande site ingevoerd of geselecteerd. Als u geen site selecteert, worden er wijzigingen aangebracht in de productie.

appSettings - App-instellingen
string.

Toepassingsinstellingen in JSON-syntaxis. Waarden met spaties tussen dubbele aanhalingstekens insluiten. Zie App-instellingen configureren voor meer informatie.

Hier volgt een voorbeeld van de JSON-syntaxis:

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

generalSettings - Algemene instellingen
string.

Algemene instellingen in JSON-syntaxis. Waarden met spaties tussen dubbele aanhalingstekens insluiten. Zie de documentatie over het object App Service SiteConfig voor een lijst met beschikbare eigenschappen. Zie Algemene instellingen configureren voor meer informatie.

Hier volgt een voorbeeld van de JSON-syntaxis:

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

connectionStrings - Verbindingsreeksen
string.

Verbindingsreeksen in JSON-syntaxis. Waarden met spaties tussen dubbele aanhalingstekens insluiten. Zie Verbindingsreeksen configureren voor meer informatie.

Hier volgt een voorbeeld van de JSON-syntaxis:

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

Opties voor taakbeheer

Alle taken hebben naast de taakinvoer besturingsopties. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om app-instellingen, verbindingsreeksen en andere algemene instellingen bulksgewijs te configureren met behulp van JSON-syntaxis in uw web-app of een van de implementatiesites. De taak werkt op platformoverschrijdende Azure Pipelines-agents met Windows, Linux of Mac. De taak werkt voor webtoepassingen op basis van ASP.NET, ASP.NET Core, PHP, Java, Python, Go en Node.js.

Voorbeelden

In het volgende voorbeeld van een YAML-fragment wordt een webtoepassing geïmplementeerd in een Azure Web App-service die wordt uitgevoerd in 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
        }
      ]

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Geen
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	2.104.1 of hoger
Taakcategorie	Implementeren