Freigeben über

AzureAppServiceSettings@1 – Aufgabe "Azure App Service-Einstellungen v1"

Aktualisiert oder fügt App Service-Einstellungen in einer Azure-Web-App für Linux oder Windows hinzu.

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.

Eingänge

azureSubscription - Azure-Abonnement
Eingabealias: ConnectedServiceName. string. Erforderlich.

Wählt das Azure Resource Manager-Abonnement aus.


appName - App Service-Name
string. Erforderlich.

Gibt den Namen eines vorhandenen Azure App Service ein, oder wählt ihn aus.


resourceGroupName - Ressourcengruppe
string. Erforderlich.

Gibt die Azure-Ressourcengruppe ein, die den oben angegebenen Azure App Service enthält, oder wählt sie aus.


slotName - Schlitz
string. Standardwert: production.

Gibt einen vorhandenen Slot ein oder wählt ihn aus. Wenn Sie keinen Slot auswählen, werden Änderungen an der Produktion vorgenommen.


appSettings - App-Einstellungen
string.

Anwendungseinstellungen in JSON-Syntax. Schließen Sie Werte, die Leerzeichen enthalten, in doppelte Anführungszeichen ein. Weitere Informationen finden Sie unter Konfigurieren von App-Einstellungen.

Im Folgenden finden Sie ein Beispiel für die JSON-Syntax:

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

generalSettings - Allgemeine Einstellungen
string.

Allgemeine Einstellungen in der JSON-Syntax. Schließen Sie Werte, die Leerzeichen enthalten, in doppelte Anführungszeichen ein. Eine Liste der verfügbaren Eigenschaften finden Sie in der Dokumentation zum App Service-SiteConfig-Objekt. Weitere Informationen finden Sie unter Konfigurieren allgemeiner Einstellungen.

Im Folgenden finden Sie ein Beispiel für die JSON-Syntax:

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

connectionStrings - Verbindungszeichenfolgen
string.

Verbindungszeichenfolgen in JSON-Syntax. Schließen Sie Werte, die Leerzeichen enthalten, in doppelte Anführungszeichen ein. Weitere Informationen finden Sie unter Konfigurieren von Verbindungszeichenfolgen.

Im Folgenden finden Sie ein Beispiel für die JSON-Syntax:

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

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

Gehen Sie wie nachfolgend beschrieben vor, um App-Einstellungen, Verbindungszeichenfolgen und andere allgemeine Einstellungen mithilfe der JSON-Syntax in Ihrer Web-App oder einem ihrer Bereitstellungsslots zu konfigurieren. Die Aufgabe funktioniert auf plattformübergreifenden Azure Pipelines-Agents, die unter Windows, Linux oder Mac ausgeführt werden. Die Aufgabe funktioniert für ASP.NET-, ASP.NET Core-, PHP-, Java-, Python-, Go- und Node.js-basierte Webanwendungen.

Beispiele

Im folgenden YAML-Beispielausschnitt wird eine Webanwendung für einen Azure-Web-App-Dienst bereitgestellt, der unter Windows ausgeführt wird.


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)
    appType: 'webApp'
    appName: $(WebApp_Name)
    package: $(System.DefaultWorkingDirectory)/**/*.zip

- task: AzureAppServiceSettings@1
  displayName: Azure App Service Settings
  inputs:
    azureSubscription: $(azureSubscription)
    appName: $(WebApp_Name)
    resourceGroupName: 'contoso-rg'
   # 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
        }
      ]

Anforderungen

Anforderung BESCHREIBUNG
Pipelinetypen YAML, Classic Build, Classic Release
Läuft auf Agent, DeploymentGroup
Anforderungen Nichts
Funktionen Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen Beliebig
Settable-Variablen Beliebig
Agentversion 2.104.1 oder höher
Vorgangskategorie Einsetzen
  • Last updated on