Configuración de una aplicación de App Service

En este artículo se explica cómo configurar los ajustes comunes de aplicaciones web, back-end para dispositivos móviles o aplicación de API. Para Azure Functions, consulte Referencia de configuración de aplicación para Azure Functions.

Configuración de aplicaciones

En App Service, las configuraciones de aplicaciones son variables que se pasan como variables de entorno al código de la aplicación. En el caso de las aplicaciones Linux y de los contenedores personalizados, App Service pasa la configuración de la aplicación al contenedor mediante la marca --env para establecer la variable de entorno en el contenedor. En cualquier caso, se insertan en el entorno de la aplicación al iniciar la aplicación. Al agregar, quitar o editar la configuración de la aplicación, App Service desencadena un reinicio de la aplicación.

Para los desarrolladores de ASP.NET y ASP.NET Core, la configuración de las opciones de aplicación en App Service es como configurarlas en <appSettings> en Web.config o appsettings.json, pero los valores de App Service reemplazan a los de Web.config o appsettings.json. Puede mantener la configuración de desarrollo (por ejemplo, la contraseña de MySQL local) de Web.config o appsettings.json y los secretos de producción (por ejemplo, la contraseña de base de datos de Azure MySQL) de forma segura en App Service. El mismo código usa la configuración de desarrollo cuando se depura localmente, y utiliza los secretos de producción cuando se implementa en Azure.

Del mismo modo, otras pilas de lenguaje obtienen la configuración de la aplicación como variables de entorno en tiempo de ejecución. Para obtener pasos específicos de la pila de lenguaje, consulte:

• ASP.NET Core
• Node.js
• PHP
• Python
• Java
• Ruby
• Contenedores personalizados

La configuración de la aplicación siempre se cifra cuando se almacena (cifrado en reposo).

Nota

La configuración de la aplicación también se puede resolver desde Key Vault mediante las referencias de Key Vault.

Azure Portal

1. En Azure Portal, busque y seleccione App Services y luego elija la aplicación.

   

2. En el menú izquierdo de la aplicación, haga clic en Configuración>Configuración de la aplicación.

   

   De forma predeterminada, los valores de configuración de la aplicación están ocultos en el portal por motivos de seguridad. Para ver un valor oculto de la configuración de una aplicación, haga clic en el campo Valor. Para ver los valores ocultos de todas las configuraciones de aplicación, haga clic en el botón Mostrar valores.

3. Para agregar una nueva configuración de aplicación, haga clic en Nueva configuración de la aplicación. Para editar una configuración, haga clic en el Editar situado a la derecha.

4. En el cuadro de diálogo, puede fijar la configuración a la ranura actual.

   Los nombres de configuración de aplicaciones no pueden contener puntos (.). Si una configuración de aplicación contiene un punto, este se reemplaza por un carácter de subrayado en el contenedor.

   Nota

   En un servicio de aplicaciones de Linux predeterminado o en un contenedor de Linux personalizado, cualquier estructura de claves JSON anidada en el nombre de configuración de la aplicación, como ApplicationInsights:InstrumentationKey, debe configurarse en App Service como ApplicationInsights__InstrumentationKey para el nombre de clave. Es decir, los símbolos : deben reemplazarse por __ (doble subrayado).

5. Cuando termine, haga clic en Actualizar. No olvide hacer clic en Guardar en la página Configuración.

CLI de Azure

Agregue o edite una configuración de aplicación con az webapp config app settings set:

az webapp config appsettings set --name <app-name> --resource-group <group-name> --settings <setting-name>="<value>"

Reemplace <setting-name> con el nombre de la configuración y <value> con el valor que se le va a asignar.

Muestre todas las configuraciones y sus valores con az webapp config appsettings list:

az webapp config appsettings list --name <app-name> --resource-group <group-name>

Quite una o varias opciones de configuración con az webapp config app settings delete:

az webapp config appsettings delete --name <app-name> --resource-group <group-name> --setting-names {<setting-name1>,<setting-name2>,...}

Azure PowerShell

Establezca una o más configuraciones de aplicación con Set-AzWebApp:

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -AppSettings @{"<setting-name1>"="<value1>"; "<setting-name2>"="<value2>";...}

Este cmdlet reemplaza todo el conjunto de configuraciones de aplicación por las que usted especifique. Para agregar o editar una configuración de aplicación dentro de un conjunto existente, incluya la configuración de la aplicación existente en la tabla hash de entrada mediante el cmdlet Get-AzWebApp. Por ejemplo:

# Get app configuration
$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Copy app settings to a new Hashtable
$appSettings = @{}
ForEach ($item in $webapp.SiteConfig.AppSettings) {
$appSettings[$item.Name] = $item.Value
}

# Add or edit one or more app settings
$appSettings['<setting-name1>'] = '<value1>'
$appSettings['<setting-name2>'] = '<value2>'

# Save changes
Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -AppSettings $appSettings

Para comprobar si una configuración de aplicación es específica de la ranura, use Get-AzWebAppSlotConfigName:

Get-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> | select AppSettingNames

Para que una o varias configuraciones de aplicación sean específicas de la ranura, use Set-AzWebAppSlotConfigName:

Set-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> -AppSettingNames <setting-name1>,<setting-name2>,...

Edición de la configuración de la aplicación en bloque

Azure Portal

Haga clic en el botón Edición avanzada. Edite la configuración en el área de texto. Cuando termine, haga clic en Actualizar. No olvide hacer clic en Guardar en la página Configuración.

La configuración de la aplicación tiene el formato JSON siguiente:

[
  {
    "name": "<key-1>",
    "value": "<value-1>",
    "slotSetting": false
  },
  {
    "name": "<key-2>",
    "value": "<value-2>",
    "slotSetting": false
  },
  ...
]

CLI de Azure

Ejecute az webapp config app settings set con el nombre del archivo JSON.

az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings "@fileName.json"

Sugerencia

Poner el nombre de archivo entre comillas solo es necesario en PowerShell.

El formato de archivo necesario es una matriz JSON de valores donde el campo de configuración de ranura es opcional. Por ejemplo:

[
  {
    "name": "key1",
    "slotSetting": false,
    "value": "value1"
  },
  {
    "name": "key2",
    "value": "value2"
  }
]

Para mayor comodidad, puede guardar la configuración existente en un archivo JSON con az webapp config appsettings list. El ejemplo siguiente se puede ejecutar en Bash.

# Save the settings
az webapp config appsettings list --name <app-name> --resource-group <group-name> > settings.json

# Edit the JSON file
...

# Update the app with the JSON file
az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings @settings.json

Azure PowerShell

No es posible editar la configuración de la aplicación en bloque mediante un archivo JSON con Azure PowerShell.

Configurar cadenas de conexión

En Azure Portal, busque y seleccione App Services y luego elija la aplicación. En el menú izquierdo de la aplicación, haga clic en Configuración>Configuración de la aplicación.

Para los desarrolladores de ASP.NET y ASP.NET Core, la configuración de las cadenas de conexión en App Service es como configurarlas en <connectionStrings> en Web.config, pero los valores establecidos en App Service reemplazan a los de Web.config. Puede mantener la configuración de desarrollo (por ejemplo, un archivo de base de datos) en Web.config y los secretos de producción (por ejemplo, credenciales de SQL Database) seguros en App Service. El mismo código usa la configuración de desarrollo cuando se depura localmente, y utiliza los secretos de producción cuando se implementa en Azure.

En cambio, para otras pilas de lenguaje es mejor usar la configuración de la aplicación, dado que las cadenas de conexión requieren un formato especial en las claves de variable para acceder a los valores.

Nota

Hay un caso en el que puede que quiera usar cadenas de conexión en lugar de la configuración de la aplicación para los lenguajes que no son .NET: la copia de seguridad de determinados tipos de bases de datos de Azure se realiza junto con la aplicación solo si se configura una cadena de conexión para la base de datos en la aplicación de App Service. Para obtener más información, consulte Creación de una copia de seguridad personalizada. Si no necesita esta copia de seguridad automatizada, use la configuración de la aplicación.

En tiempo de ejecución, las cadenas de conexión están disponibles como variables de entorno, con los siguientes tipos de conexión como prefijo:

• SQLServer: SQLCONNSTR_
• MySQL: MYSQLCONNSTR_
• SQLAzure: SQLAZURECONNSTR_
• Personalizado: CUSTOMCONNSTR_
• PostgreSQL: POSTGRESQLCONNSTR_

Por ejemplo, se puede obtener acceso a una cadena de conexión de MySQL denominada connectionstring1 como la variable de entorno MYSQLCONNSTR_connectionString1. Para obtener pasos específicos de la pila de lenguaje, consulte:

• ASP.NET Core
• Node.js
• PHP
• Python
• Java
• Ruby
• Contenedores personalizados

Las cadenas de conexión siempre se cifran cuando se almacenan (cifrado en reposo).

Nota

Las cadenas de conexión se pueden resolver desde Key Vault mediante las referencias de Key Vault.

Azure Portal

1. En Azure Portal, busque y seleccione App Services y luego elija la aplicación.

   

2. En el menú izquierdo de la aplicación, haga clic en Configuración>Configuración de la aplicación.

   

   De forma predeterminada, los valores de las cadenas de conexión están ocultos en el portal por motivos de seguridad. Para ver un valor oculto de una cadena de conexión, haga clic en el campo Valor. Para ver los valores ocultos de todas las cadenas de conexión, haga clic en el botón Mostrar valor.

3. Para agregar una nueva cadena de conexión, haga clic en Nueva cadena de conexión. Para editar una cadena de conexión, haga clic en el botón Editar situado a la derecha.

4. En el cuadro de diálogo, puede fijar la cadena de conexión a la ranura actual.

5. Cuando termine, haga clic en Actualizar. No olvide hacer clic en Guardar en la página Configuración.

CLI de Azure

Agregue o edite una configuración de aplicación con az webapp config connection-string set:

az webapp config connection-string set --name <app-name> --resource-group <group-name> --connection-string-type <type> --settings <string-name>='<value>'

Reemplace <string-name> con el nombre de la cadena de conexión y <value> con el valor que se le va a asignar. Para ver los valores posibles de <type> (por ejemplo, SQLAzure), consulte la documentación de comandos de la CLI.

Muestre todas las cadenas de conexión y sus valores con az webapp config connection-string list:

az webapp config connection-string list --name <app-name> --resource-group <group-name>

Quite una o varias cadenas de conexión con az webapp config connection-string delete:

az webapp config connection-string delete --name <app-name> --resource-group <group-name> --setting-names {<string-name1>,<string-name2>,...}

Azure PowerShell

Establezca una o más cadenas de conexión con Set-AzWebApp:

$PropertiesObject = @{
  "<string-name1>" = @{
    value="<connection-string1>";
    type="<type>"};
  "<string-name2>" = @{
    value="<connection-string2>";
    type="<type>"}
}

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -ConnectionStrings $PropertiesObject

Cada cadena de conexión contiene un nombre (<string-name1>), un valor (<connection-string1>) y el tipo, que es un valor numérico que corresponde a uno de los campos de enumeración ConnectionStringType. Por ejemplo, para SQL Azure, especifique type="2".

Este cmdlet reemplaza todo el conjunto de cadenas de conexión por las que usted especifique. Para agregar o editar una configuración de aplicación dentro de un conjunto existente, incluya la configuración de la aplicación existente en la tabla hash de entrada mediante el cmdlet Get-AzWebApp. Por ejemplo:

# Get app configuration
$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Copy connection strings to a new hashtable
$connStrings = @{}
ForEach ($item in $webapp.SiteConfig.ConnectionStrings) {
$connStrings[$item.Name] = @{value=$item.Value; type=item.Type}
}

# Add or edit one or more connection strings
$connStrings['<string-name1>'] = @{value='<connection-string1>', type='<type>'}
$connStrings['<string-name2>'] = @{value='<connection-string2>', type='<type>'}

# Save changes
Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -ConnectionStrings $connStrings

Para comprobar si una cadena de conexión es específica de la ranura, use Get-AzWebAppSlotConfigName:

Get-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> | select ConnectionStringNames

Para que una o varias cadenas de conexión sean específicas de la ranura, use Set-AzWebAppSlotConfigName:

Set-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> -ConnectionStringNames <string-name1>,<string-name2>,...

Modificar cadenas de conexión de forma masiva

Azure Portal

Haga clic en el botón Edición avanzada. Edite las cadenas de conexión en el área de texto. Cuando termine, haga clic en Actualizar. No olvide hacer clic en Guardar en la página Configuración.

Las cadenas de conexión tienen el formato JSON siguiente:

[
  {
    "name": "name-1",
    "value": "conn-string-1",
    "type": "SQLServer",
    "slotSetting": false
  },
  {
    "name": "name-2",
    "value": "conn-string-2",
    "type": "PostgreSQL",
    "slotSetting": false
  },
  ...
]

CLI de Azure

Ejecute az webapp config connection-string set con el nombre del archivo JSON.

az webapp config connection-string set --resource-group <group-name> --name <app-name> --settings "@fileName.json"

Sugerencia

Poner el nombre de archivo entre comillas solo es necesario en PowerShell.

El formato de archivo necesario es una matriz JSON de cadenas de conexión donde el campo de configuración de ranura es opcional. Por ejemplo:

[
  {
    "name": "name-1",
    "value": "conn-string-1",
    "type": "SQLServer",
    "slotSetting": false
  },
  {
    "name": "name-2",
    "value": "conn-string-2",
    "type": "PostgreSQL",
  },
  ...
]

Para mayor comodidad, puede guardar las cadenas de conexión existentes en un archivo JSON con az webapp config connection-string list. El ejemplo siguiente se puede ejecutar en Bash.

# Save the connection strings
az webapp config connection-string list --resource-group <group-name> --name <app-name> > settings.json

# Edit the JSON file
...

# Update the app with the JSON file
az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings @settings.json

Azure PowerShell

No es posible editar las cadenas de conexión en bloque mediante un archivo JSON con Azure PowerShell.

Configurar las opciones de pila de lenguaje

• ASP.NET Core
• Node.js
• PHP
• Python
• Java
• Ruby

Configurar las opciones generales

Azure Portal

En Azure Portal, busque y seleccione App Services y luego elija la aplicación. En el menú izquierdo de la aplicación, seleccione configuración>Configuración general.

En este caso, puede configurar algunas opciones comunes para la aplicación. Algunas configuraciones requieren escalar verticalmente hasta los planes de tarifa superiores.

• Configuración de pila: La pila de software para ejecutar la aplicación, incluidos el lenguaje y las versiones del SDK.

  En el caso de las aplicaciones de Linux, puede seleccionar la versión de Language Runtime y establecer un comando de startup opcional o un archivo de comandos de startup.

  

• Configuración de plataforma: Le permite configurar opciones para la plataforma de alojamiento, incluidas:

  • Estado de FTP: permita solo FTPS o deshabilite FTP por completo.

  • Valor de bits: 32 bits o 64 bits. Solo para aplicaciones Windows.

  • Protocolo Websocket: para ASP.NET SignalR o socket.io, por ejemplo.

  • Always On: mantiene la aplicación cargada, incluso cuando no hay tráfico. Cuando Always On no está activado (configuración predeterminada), la aplicación se descarga después de 20 minutos sin ninguna solicitud entrante. La aplicación descargada puede provocar una latencia alta para las nuevas solicitudes debido a su tiempo de preparación. Cuando Always On está activado, el equilibrador de carga front-end envía una solicitud GET a la raíz de la aplicación cada cinco minutos. El ping continuo impide que la aplicación se descargue.

    Always On es necesario en los WebJobs continuos o WebJobs que se desencadenan mediante una expresión CRON.

  • Versión de HTTP: Establézcala en 2.0 para habilitar la compatibilidad con el protocolo HTTPS/2.

  Nota

  Los exploradores más modernos admiten el protocolo HTTP/2 sobre TLS únicamente, mientras que el tráfico no cifrado sigue usando HTTP/1.1. Para asegurarse de que los exploradores del cliente se conectan a la aplicación con HTTP/2, proteja el nombre DNS personalizado. Para más información, consulte Protección de un nombre DNS personalizado con un enlace TLS/SSL en Azure App Service.

  • Afinidad ARR: en una implementación de varias instancias, asegúrese de que el cliente esté enrutado a la misma instancia de la vida de la sesión. Puede establecer esta opción en Desactivada para las aplicaciones sin estado.

• Depuración: habilite la depuración remota para las aplicaciones ASP.NET, ASP.NET Core o Node.js. Esta opción se desactiva automáticamente después de 48 horas.

• Certificados de cliente entrantes: requiera certificados de cliente en autenticación mutua.

CLI de Azure

Puede establecer muchas de las opciones configurables comunes mediante az webapp config set. En el ejemplo siguiente se muestra un subconjunto de las opciones configurables.

az webapp config set --resource-group <group-name> --name <app-name> --use-32bit-worker-process [true|false] --web-sockets-enabled [true|false] --always-on [true|false]--http20-enabled --auto-heal-enabled [true|false] --remote-debugging-enabled [true|false] --number-of-workers

Para mostrar la configuración existente, use el comando az webapp config show.

Azure PowerShell

Puede establecer muchas de las opciones configurables comunes mediante Set-AzWebApp. En el ejemplo siguiente se muestra un subconjunto de las opciones configurables.

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -Use32BitWorkerProcess [True|False] -WebSocketsEnabled [True|False] -AlwaysOn [True|False] -NumberOfWorkers

Para mostrar la configuración existente, use el comando Get-AzWebApp.

Configurar documentos predeterminados

Esta configuración solo es para las aplicaciones de Windows.

El documento predeterminado es la página web que se muestra en la dirección URL raíz de una aplicación App Service. Se usa el primer archivo coincidente en la lista. Si la aplicación usa módulos que se enrutan en función de la dirección URL en lugar de servir contenido estático, no hay necesidad de documentos predeterminados.

Azure Portal

1. En Azure Portal, busque y seleccione App Services y luego elija la aplicación.

2. En el menú izquierdo de la aplicación, seleccione Configuración>Documentos predeterminados.

   

3. Para agregar un documento predeterminado, haga clic en Nuevo documento. Para quitar un documento predeterminado, haga clic en Eliminar a su derecha.

CLI de Azure

Agregue un documento predeterminado mediante az resource update:

az resource update --resource-group <group-name> --resource-type "Microsoft.Web/sites/config" --name <app-name>/config/web --add properties.defaultDocuments <filename>

Azure PowerShell

Agregue un documento predeterminado modificando el objeto PowerShell de la aplicación de actualización:

$webapp = Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>
$webapp.SiteConfig.DefaultDocuments.Add("<filename>")
Set-AzWebApp $webapp

Asignación de una ruta de acceso URL a un directorio

De forma predeterminada, App Service inicia la aplicación desde el directorio raíz del código de la aplicación. Sin embargo, algunos marcos web no se inician en el directorio raíz. Por ejemplo, Laravel se inicia en el subdirectorio public. Por ejemplo, en http://contoso.com/public, se podría acceder a una aplicación de este tipo, pero normalmente, en su lugar, querrá redirigir http://contoso.com al directorio public. Si el archivo de startup de la aplicación está en una carpeta diferente, o si el repositorio tiene más de una aplicación, puede editar o agregar aplicaciones y directorios virtuales.

Azure Portal

1. En Azure Portal, busque y seleccione App Services y luego elija la aplicación.

2. En el menú izquierdo de la aplicación, seleccione Configuración>Asignaciones de ruta de acceso.

3. Haga clic en Nueva aplicación o directorio virtual.

   • Para asignar un directorio virtual a una ruta de acceso física, deje activada la casilla Directorio. Especifique el directorio virtual y la ruta de acceso relativa (física) correspondiente a la raíz del sitio web (D:\home).
   • Para marcar un directorio virtual como aplicación web, desactive la casilla Directorio.

   

4. Haga clic en OK.

CLI de Azure

En el ejemplo siguiente se establece la ruta de acceso raíz / al subdirectorio public (que funciona para Laravel) y también se agrega una segunda aplicación virtual en la ruta de acceso /app2. Para ejecutarla, cree un archivo denominado json.txt con el siguiente contenido.

[
  {
    "physicalPath"':' "site\\wwwroot\\public",
    "preloadEnabled"':' false,
    "virtualDirectories"':' null,
    "virtualPath"':' "/"
  },
  {
    "physicalPath"':' "site\\wwwroot\\app2",
    "preloadEnabled"':' false,
    "virtualDirectories"':' null,
    "virtualPath"':' "/app2"
  }
]

Cambie <group-name> y <app-name> para los recursos y ejecute el siguiente comando. Tenga en cuenta los caracteres de escape al ejecutar este comando. Para más información sobre los caracteres de escape, consulte Sugerencias para usar correctamente la CLI de Azure.

az resource update --resource-group <group-name> --resource-type Microsoft.Web/sites/config --name <app-name>/config/web --set properties.virtualApplications="@json.txt"

Azure PowerShell

En el ejemplo siguiente se establece la ruta de acceso raíz / al subdirectorio public (que funciona para Laravel) y también se agrega una segunda aplicación virtual en la ruta de acceso /app2. Para ejecutarlo, cambie <group-name> y <app-name>.

$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Set default / path to public subdirectory
$webapp.SiteConfig.VirtualApplications[0].PhysicalPath= "site\wwwroot\public"

# Add a virtual application
$virtualApp = New-Object Microsoft.Azure.Management.WebSites.Models.VirtualApplication
$virtualApp.VirtualPath = "/app2"
$virtualApp.PhysicalPath = "site\wwwroot\app2"
$virtualApp.PreloadEnabled = $false
$webapp.SiteConfig.VirtualApplications.Add($virtualApp)

# Save settings
Set-AzWebApp $webapp

Configuración de asignaciones de controladores

Para aplicaciones de Windows, puede personalizar las asignaciones de controlador de IIS, así como las aplicaciones y directorios virtuales. Las asignaciones de controlador permiten agregar procesadores de script personalizados para controlar solicitudes de extensiones de archivo específicas.

Para agregar un controlador personalizado:

1. En Azure Portal, busque y seleccione App Services y luego elija la aplicación.

2. En el menú izquierdo de la aplicación, seleccione Configuración>Asignaciones de ruta de acceso.

   

3. Haga clic en Nueva asignación de controlador. Configure el controlador de la manera siguiente:

   • Extensión. La extensión de archivo que quiere controlar, por ejemplo, *.php o handler.fcgi.
   • Procesador de script. La ruta de acceso absoluta del procesador de script. El procesador de script procesa las solicitudes a archivos que coincidan con esta extensión de archivo. Utilice la ruta de acceso D:\home\site\wwwroot para hacer referencia al directorio raíz de la aplicación.
   • Argumentos. Argumentos opcionales de la línea de comandos para el procesador de script.

4. Haga clic en Aceptar.

Configurar contenedores personalizados

• Configuración de un contenedor de Linux personalizado para Azure App Service
• Adición de almacenamiento personalizado para la aplicación en contenedor

Pasos siguientes

• Referencia de variables de entorno y configuración de la aplicación
• Configuración de un nombre de dominio personalizado en Azure App Service
• Configuración de entornos de ensayo en Azure App Service
• Protección de un nombre DNS personalizado con un enlace TLS/SSL en Azure App Service
• Habilitar los registros de diagnóstico
• Escalado de una aplicación en Azure App Service
• Aspectos básicos de supervisión en Azure App Service
• Cambiar la configuración applicationHost.config por applicationHost.xdt