Configurar una aplicación de ASP.NET Core para Azure App Service

Las aplicaciones de ASP.NET Core deben implementarse en Azure App Service como binarios compilados. La herramienta de publicación de Visual Studio compila la solución y, a continuación, implementa los archivos binarios compilados directamente. El motor de implementación de App Service implementa primero el repositorio de código y, a continuación, compila los archivos binarios.

Esta guía incluye conceptos clave e instrucciones para los desarrolladores de ASP.NET Core. Si es la primera vez que usa Azure App Service, siga primero el inicio rápido de ASP.NET Core y ASP.NET Core con SQL Database.

dotnet --info

az webapp config show --resource-group <resource-group-name> --name <app-name> --query linuxFxVersion

az webapp list-runtimes --os linux | grep DOTNET

Establecer la versión de .NET Core

az webapp config set --name <app-name> --resource-group <resource-group-name> --linux-fx-version "DOTNETCORE|8.0"

¿Qué ocurre con los tiempos de ejecución obsoletos en App Service?

Los tiempos de ejecución obsoletos están en desuso por parte de la organización de mantenimiento o han detectado que tienen vulnerabilidades significativas. En consecuencia, se eliminan de las páginas de creación y configuración en el portal. Cuando un tiempo de ejecución obsoleto está oculto en el portal, cualquier aplicación que siga usando ese tiempo de ejecución continúa ejecutándose.

Si quiere crear una aplicación con una versión en tiempo de ejecución obsoleta que ya no se muestra en el portal, use la CLI de Azure, la plantilla de ARM o Bicep. Estas alternativas de implementación permiten crear entornos de ejecución en desuso que se han quitado en el portal, pero aún se admiten.

Si un entorno de ejecución se quita completamente de la plataforma de App Service, el propietario de la suscripción de Azure recibe un aviso por correo electrónico antes de la eliminación.

az webapp config appsettings set --name <app-name> --resource-group <resource-group-name> --settings PRE_BUILD_COMMAND="echo foo, scripts/prebuild.sh"
az webapp config appsettings set --name <app-name> --resource-group <resource-group-name> --settings POST_BUILD_COMMAND="echo foo, scripts/postbuild.sh"

Acceso a variables de entorno

En App Service, puede establecer la configuración de la aplicación fuera del código de la aplicación. A continuación, puede acceder a ellos en cualquier clase mediante el patrón estándar de inserción de dependencias ASP.NET Core:

using Microsoft.Extensions.Configuration;

namespace SomeNamespace 
{
    public class SomeClass
    {
        private IConfiguration _configuration;
    
        public SomeClass(IConfiguration configuration)
        {
            _configuration = configuration;
        }
    
        public SomeMethod()
        {
            // retrieve nested App Service app setting
            var myHierarchicalConfig = _configuration["My:Hierarchical:Config:Data"];
            // retrieve App Service connection string
            var myConnString = _configuration.GetConnectionString("MyDbConnection");
        }
    }
}

Si configuras un ajuste de aplicación con el mismo nombre en "App Service" y en appsettings.json, por ejemplo, el valor de "App Service" tiene prioridad sobre el valor de appsettings.json. Con el valor local appsettings.json, puede depurar la aplicación localmente. No obstante, si usa el valor de App Service, puede ejecutar la aplicación en producción con la configuración de producción. Las cadenas de conexión funcionan de la misma manera. Con este método, puede mantener los secretos de aplicación fuera del repositorio de código y acceder a los valores adecuados sin cambiar el código.

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

az webapp config appsettings set --name <app-name> --resource-group <resource-group-name> --settings My:Hierarchical:Config:Data="some value"

Implementar soluciones de varios proyectos

Cuando una solución de Visual Studio incluye varios proyectos, el proceso de publicación de Visual Studio selecciona automáticamente el proyecto que se va a implementar. Al implementar en el motor de implementación de App Service, como con Git, o con la implementación ZIP con la automatización de compilación habilitada, el motor de implementación de App Service elige el primer sitio web o proyecto de aplicación web que encuentra como la aplicación de App Service. Para especificar el proyecto que App Service debe usar, especifique la configuración de la aplicación PROJECT. Por ejemplo, ejecute el siguiente comando en Cloud Shell:

az webapp config appsettings set --resource-group <resource-group-name> --name <app-name> --settings PROJECT="<project-name>/<project-name>.csproj"

Acceso a los registros de diagnóstico

ASP.NET Core ofrece un proveedor de registro integrado para App Service. En el archivo program.cs de tu proyecto, agrega el proveedor a tu aplicación a través del método de extensión ConfigureLogging, como se muestra en el ejemplo siguiente.

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureLogging(logging =>
        {
            logging.AddAzureWebAppDiagnostics();
        })
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>();
        });

Después, podrá configurar y generar registros con el patrón de .NET Core estándar.

Para acceder a los registros de consola generados dentro del código de su aplicación en App Service, active el registro de diagnóstico ejecute el siguiente comando en Cloud Shell:

az webapp log config --resource-group <resource-group-name> --name <app-name> --docker-container-logging filesystem --level Verbose

Los valores posibles para --level son Error, Warning, Info y Verbose. Cada nivel subsiguiente incluye el nivel anterior. Por ejemplo, Error solo incluye mensajes de error. Verbose incluye todos los mensajes.

Después de activar el registro de diagnóstico, ejecute el siguiente comando para ver la secuencia de registro:

az webapp log tail --resource-group <resource-group-name> --name <app-name>

Si los registros de consola no aparecen inmediatamente, vuelva a comprobar en 30 segundos.

Para detener el streaming de registros en cualquier momento, seleccione Ctrl+C.

Para más información sobre la solución de problemas de aplicaciones ASP.NET Core en App Service, consulte Solución de problemas de ASP.NET Core en Azure App Service e IIS.

Acceso a una página de excepciones detalladas

Cuando la aplicación ASP.NET Core genera una excepción en el depurador de Visual Studio, el explorador muestra una página de excepción detallada, pero en App Service esa página se reemplaza por un "HTTP 500" genérico o "Error al procesar la solicitud". Para mostrar la página de excepciones detallada en App Service, agregue la configuración de la ASPNETCORE_ENVIRONMENT aplicación a la aplicación mediante la ejecución del siguiente comando en Cloud Shell.

az webapp config appsettings set --name <app-name> --resource-group <resource-group-name> --settings ASPNETCORE_ENVIRONMENT="Development"

Detección de sesión de HTTPS

En App Service, la terminación de TLS/SSL se produce en los equilibradores de carga de red, por lo que todas las solicitudes HTTPS llegan a la aplicación como solicitudes HTTP sin cifrar. Si la lógica de la aplicación necesita saber si las solicitudes de usuario están cifradas, configure el middleware de encabezados reenviados en Startup.cs.

• Configure el middleware con ForwardedHeadersOptions para reenviar los encabezados X-Forwarded-For y X-Forwarded-Proto en Startup.ConfigureServices.
• Agregue intervalos de direcciones IP privadas a las redes conocidas, de modo que el middleware pueda confiar en el equilibrador de carga de App Service.
• Invoque el UseForwardedHeaders método en Startup.Configure antes de llamar a otro middleware.

Al ensamblar los tres elementos, el código tiene el siguiente aspecto:

public void ConfigureServices(IServiceCollection services)
{
    services.AddMvc();

    services.Configure<ForwardedHeadersOptions>(options =>
    {
        options.ForwardedHeaders =
            ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto;
        // These three subnets encapsulate the applicable Azure subnets. At the moment, it's not possible to narrow it down further.
        options.KnownNetworks.Add(new IPNetwork(IPAddress.Parse("::ffff:10.0.0.0"), 104));
        options.KnownNetworks.Add(new IPNetwork(IPAddress.Parse("::ffff:192.168.0.0"), 112));
        options.KnownNetworks.Add(new IPNetwork(IPAddress.Parse("::ffff:172.16.0.0"), 108));
    });
}

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    app.UseForwardedHeaders();

    ...

    app.UseMvc();
}

Para obtener más información, consulte Configuración de ASP.NET Core para trabajar con servidores proxy y equilibradores de carga.

2019-04-08T14:07:56.641002476Z "-" - - [08/Apr/2019:14:07:56 +0000] "GET /robots933456.txt HTTP/1.1" 404 415 "-" "-"

Contenido relacionado

• Tutorial: Aplicación de ASP.NET Core con SQL Database

• Variables de entorno y configuración de la aplicación