ASP.NET Core alkalmazás konfigurálása az Azure App Service szolgáltatáshoz

ASP.NET Core-alkalmazásokat lefordított bináris fájlokként kell üzembe helyezni a Azure-alkalmazás Szolgáltatásban. A Visual Studio közzétételi eszköze létrehozza a megoldást, majd közvetlenül telepíti a lefordított bináris fájlokat, míg az App Service üzembehelyezési motorja először üzembe helyezi a kódtárat, majd lefordítja a bináris fájlokat.

Ez az útmutató alapvető fogalmakat és utasításokat tartalmaz ASP.NET Core-fejlesztők számára. Ha még soha nem használta a Azure-alkalmazás Szolgáltatást, először kövesse a ASP.NET Core rövid útmutatóját, és ASP.NET Core-t az SQL Database-lel.

dotnet --info

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

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

.NET Core verzió beállítása

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

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"

Hozzáférés a környezeti változókhoz

Az App Service-szel az alkalmazás kódján kívül is megadhatja az alkalmazások beállításait. Ezután bármely osztályban elérheti őket a standard ASP.NET Core függőséginjektálási mintával:

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");
        }
    }
}

Ha az App Service-ben és appsettings.json azonos nevű alkalmazásbeállítást konfigurál, akkor az App Service-érték elsőbbséget élvez az appsettings.json értékkel szemben. A helyi appsettings.json érték lehetővé teszi az alkalmazás helyi hibakeresését, az App Service-érték azonban lehetővé teszi, hogy éles környezetben, éles környezetben futtassa az alkalmazást éles környezetben. A kapcsolati sztringek ugyanúgy működnek. Így a kódtáron kívül is megőrizheti az alkalmazás titkos kulcsait, és a kód módosítása nélkül elérheti a megfelelő értékeket.

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"

Több projektet érintő megoldások telepítése

Ha egy Visual Studio-megoldás több projektet is tartalmaz, a Visual Studio közzétételi folyamata már magában foglalja az üzembe helyezendő projekt kiválasztását. Amikor az App Service üzembehelyezési motoron ( például a Gittel vagy a ZIP üzembe helyezéssel engedélyezve van a buildautomatizálás) üzembe helyezésekor az App Service üzembehelyezési motorja kiválasztja az app Service-alkalmazásként talált első webhelyet vagy webalkalmazás-projektet. Az appbeállítás megadásával PROJECT megadhatja, hogy az App Service melyik projektet használja. Futtassa például a következő parancsot a Cloud Shellben:

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

Diagnosztikai naplók elérése

ASP.NET Core egy beépített naplózási szolgáltatót biztosít az App Service-hez. A projekt Program.cs adja hozzá a szolgáltatót az alkalmazáshoz a ConfigureLogging bővítménymetóduson keresztül, ahogyan az a következő példában látható:

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

Ezután konfigurálhatja és létrehozhat naplókat a szabványos .NET Core-mintával.

Az alkalmazáskódból létrehozott konzolnaplók App Service-ben történő eléréséhez kapcsolja be a diagnosztikai naplózást a következő parancs a Cloud Shellben történő futtatásával:

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

A --level lehetséges értékei: Error, Warning, Info és Verbose. Minden szint tartalmazza az azt megelőző szintet. Például: az Error csak a hibaüzeneteket tartalmazza, a Verbose pedig az összes üzenetet.

Ha a diagnosztikai naplózás be van kapcsolva, futtassa a következő parancsot a naplóstream megtekintéséhez:

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

Ha nem jelennek meg azonnal a konzolnaplófájlok, ellenőrizze ismét 30 másodperc múlva.

A Ctrl+C billentyűparanccsal bármikor leállíthatja a naplóstreamelést.

Az App Service-ben ASP.NET Core-alkalmazások hibaelhárításával kapcsolatos további információkért lásd: ASP.NET Core hibaelhárítása Azure-alkalmazás Szolgáltatáson és IIS-en

Részletes kivételek oldal letöltése

Ha a ASP.NET Core-alkalmazás kivételt hoz létre a Visual Studio hibakeresőjében, a böngésző egy részletes kivételoldalt jelenít meg, de az App Service-ben ezt a lapot egy általános HTTP 500-ra cseréli, vagy hiba történt a kérés feldolgozása során. Ha meg szeretné jeleníteni a részletes kivételoldalt az App Service-ben, adja hozzá az ASPNETCORE_ENVIRONMENT alkalmazásbeállítást az alkalmazáshoz az alábbi parancs futtatásával a Cloud Shellben.

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

HTTPS munkamenet észlelése

Az App Service-ben a TLS/SSL-leállítás a hálózati terheléselosztóknál történik, így minden HTTPS-kérés titkosítatlan HTTP-kérésként éri el az alkalmazást. Ha az alkalmazáslogikának tudnia kell, hogy a felhasználói kérések titkosítva vannak-e, konfigurálja a továbbított fejlécek köztes szoftverét a Startup.cs:

• Konfigurálja a köztes szoftvert a ForwardedHeadersOptions használatával a fejlécek és X-Forwarded-Proto a fejlécek továbbításához a X-Forwarded-For következőbenStartup.ConfigureServices: .
• Adjon hozzá privát IP-címtartományokat az ismert hálózatokhoz, hogy a köztes szoftver megbízható legyen az App Service terheléselosztóban.
• Meghívja a UseForwardedHeaders metódust, Startup.Configure mielőtt meghívna más köztes szoftvereket.

A kód mindhárom elem összevonása a következő példához hasonlóan néz ki:

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();
}

További információ: A ASP.NET Core konfigurálása proxykiszolgálókkal és terheléselosztókkal való együttműködéshez.

https://<app-name>.scm.azurewebsites.net/webssh/host

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

Következő lépések

Vagy tekintse meg a további erőforrásokat:

Környezeti változók és alkalmazásbeállítások referenciája