Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 |