Compartir a través de

AzureAppServiceSettings@1: tarea Configuración del Servicio de aplicaciones de Azure v1

Actualiza o agrega la configuración del servicio de aplicaciones en una aplicación web de Azure para Linux o Windows.

Sintaxis

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

Entradas

azureSubscription - de suscripción de Azure
Alias de entrada: ConnectedServiceName. string. Obligatorio.

Selecciona la suscripción de Azure Resource Manager.


appName - nombre de App Service
string. Obligatorio.

Escribe o selecciona el nombre de una instancia de Azure App Service existente.


del grupo de recursos de
string. Obligatorio.

Escribe o selecciona el grupo de recursos de Azure que contiene el Servicio de aplicaciones de Azure especificado anteriormente.


de ranura de
string. Valor predeterminado: production.

Introduce o selecciona una ranura existente. Si no selecciona una ranura, se realizan cambios en producción.


de configuración de la aplicación de
string.

Configuración de la aplicación en sintaxis JSON. Incluya los valores que contengan espacios entre comillas dobles. Para obtener más información, consulte Configuración de aplicaciones.

A continuación se muestra un ejemplo de la sintaxis JSON:

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

generalSettings - Ajustes generales
string.

Configuración general en la sintaxis JSON. Incluya los valores que contengan espacios entre comillas dobles. Para obtener una lista de las propiedades disponibles, consulte la documentación del objeto SiteConfig del Servicio de aplicaciones. Para obtener más información, consulte Configurar los ajustes generales.

A continuación se muestra un ejemplo de la sintaxis JSON:

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

connectionStrings - Cadenas de conexión
string.

Cadenas de conexión en sintaxis JSON. Incluya los valores que contengan espacios entre comillas dobles. Para más información, consulte Configuración de cadenas de conexión.

A continuación se muestra un ejemplo de la sintaxis JSON:

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

Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Observaciones

Use esta tarea para configurar los ajustes de la aplicación, las cadenas de conexión y otros valores generales de forma masiva mediante la sintaxis JSON en la aplicación web o en cualquiera de sus ranuras de implementación. La tarea funciona en agentes multiplataforma de Azure Pipelines que ejecutan Windows, Linux o Mac. La tarea funciona para aplicaciones web basadas en ASP.NET, ASP.NET Core, PHP, Java, Python, Go y Node.js.

Ejemplos

En el siguiente fragmento de código YAML de ejemplo se implementa una aplicación web en un servicio de Azure Web App que se ejecuta en 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)
    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
        }
      ]

Requisitos

Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Agente, DeploymentGroup
demandas Ninguno
Capacidades Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos Cualquiera
variables settable Cualquiera
Versión del agente 2.104.1 o superior
Categoría de tarea Desplegar