Konfigurera en App Service-app i Azure Portal

Den här artikeln beskriver hur du konfigurerar vanliga inställningar för webbappar, mobila backend-appar eller API-appar med [hjälp av Azure Portal].

Konfigurera appinställningar

I App Service är appinställningar variabler som skickas som miljövariabler till programkoden. För Linux-appar och anpassade containrar App Service appinställningar till containern med hjälp av flaggan för --env att ange miljövariabeln i containern. I båda fallen matas de in i din appmiljö när appen startas. När du lägger till, tar bort eller redigerar appinställningar App Service utlöser en appstart. Appinställningsnamn får inte innehålla punkter ( . ). Om en appinställning innehåller en punkt ersätts perioden med ett understreck i containern.

I Azure Portaldu efter och väljer App Services och väljer sedan din app.

På appens vänstra meny väljer du Inställningar för > konfigurationsprogram.

För ASP.NET- och ASP.NET Core-utvecklare är inställning av appinställningar i App Service som att ange dem i iWeb.configeller appsettings.json , men värdena i App Service åsidosätter värdena iWeb.configeller <appSettings> appsettings.json. Du kan behålla utvecklingsinställningar (till exempel lokala MySQL-lösenord) i Web.config eller appsettings.json och produktionshemligheter (till exempel Azure MySQL-databaslösenord) på ett säkert sätt i App Service. Samma kod använder utvecklingsinställningarna när du felsöker lokalt och använder dina produktionshemligheter när de distribueras till Azure.

Andra språkstackar hämtar på samma sätt appinställningarna som miljövariabler vid körning. Specifika steg för språkstack finns i:

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

Appinställningarna krypteras alltid när de lagras (krypterad i vila).

Visa dolda värden

Som standard döljs värden för appinställningar i portalen av säkerhetsskäl. Om du vill se ett dolt värde för en appinställning klickar du på fältet Värde för den inställningen. Om du vill se värdena för alla appinställningar klickar du på knappen Visa värde.

Lägga till eller redigera

Om du vill lägga till en ny appinställning klickar du på Ny programinställning. I dialogrutan kan du hålla inställningen på det aktuella facket.

Om du vill redigera en inställning klickar du på knappen Redigera till höger.

När du är klar klickar du på Uppdatera. Glöm inte att klicka på Spara igen på sidan Konfiguration.

Massredigering

Om du vill lägga till eller redigera appinställningar i grupp klickar du på knappen Avancerad redigering. När du är klar klickar du på Uppdatera. Glöm inte att klicka på Spara igen på sidan Konfiguration.

Appinställningarna har följande JSON-formatering:

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

Automatisera appinställningar med Azure CLI

Du kan använda Azure CLI för att skapa och hantera inställningar från kommandoraden.

• Tilldela ett värde till en inställning med az webapp config app settings set:

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

  Ersätt <setting-name> med namnet på inställningen och med värdet som ska <value> tilldelas till den. Det här kommandot skapar inställningen om den inte redan finns.

• Visa alla inställningar och deras värden med az webapp config appsettings list:

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

• Ta bort en eller flera inställningar med az webapp config app settings delete:

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

  Ersätt <names> med en blankstegsavgränsad lista med inställningsnamn.

Konfigurera anslutningssträngar

I Azure Portaldu efter och väljer App Services och väljer sedan din app. På appens vänstra meny väljer du Inställningar för > konfigurationsprogram.

För ASP.NET och ASP.NET Core-utvecklare är inställning av anslutningssträngar i App Service som att ange dem i iWeb.config, men de värden som du anger i App Service åsidosätter dem <connectionStrings> iWeb.config. ** Du kan behålla utvecklingsinställningar (till exempel en databasfil) i Web.config och produktionshemligheter (till exempel autentiseringsuppgifter SQL Database) på ett säkert sätt App Service. Samma kod använder utvecklingsinställningarna när du felsöker lokalt och använder dina produktionshemligheter när de distribueras till Azure.

För andra språkstackar är det bättre att använda appinställningar i stället, eftersom anslutningssträngar kräver särskild formatering i variabelnycklarna för att komma åt värdena.

Vid körning är anslutningssträngar tillgängliga som miljövariabler, med prefixet följande anslutningstyper:

• Sqlserver: SQLCONNSTR_
• Mysql: MYSQLCONNSTR_
• SQLAzure: SQLAZURECONNSTR_
• Anpassade: CUSTOMCONNSTR_
• Postgresql: POSTGRESQLCONNSTR_

Till exempel kan en MySql-anslutningssträng med namnet connectionstring1 nås som miljövariabeln MYSQLCONNSTR_connectionString1 . Specifika steg för språkstack finns i:

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

Anslutningssträngar krypteras alltid när de lagras (krypterade i vila).

Visa dolda värden

Som standard döljs värden för anslutningssträngar i portalen av säkerhetsskäl. Om du vill se ett dolt värde för en anslutningssträng klickar du bara på fältet Värde för strängen. Om du vill se värdena för alla anslutningssträngar klickar du på knappen Visa värde.

Lägga till eller redigera

Om du vill lägga till en ny anslutningssträng klickar du på Ny anslutningssträng. I dialogrutan kan du hålla anslutningssträngen på det aktuella facket.

Om du vill redigera en inställning klickar du på knappen Redigera till höger.

När du är klar klickar du på Uppdatera. Glöm inte att klicka på Spara igen på sidan Konfiguration.

Massredigering

Om du vill lägga till eller redigera anslutningssträngar i grupp klickar du på knappen Avancerad redigering. När du är klar klickar du på Uppdatera. Glöm inte att klicka på Spara igen på sidan Konfiguration.

Anslutningssträngar har följande JSON-formatering:

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

Konfigurera allmänna inställningar

I Azure Portaldu efter och väljer App Services och väljer sedan din app. I appens vänstra meny väljer du Allmänna inställningar > för Konfiguration.

Här kan du konfigurera några vanliga inställningar för appen. Vissa inställningar kräver att du skalar upp till högre prisnivåer.

• Stackinställningar: Programvarustacken som ska köra appen, inklusive språk- och SDK-versioner.

  För Linux-appar och anpassade containerappar kan du välja språkkörningsversion och ange ett valfritt startkommando eller en startkommandofil.

  

• Plattformsinställningar: Gör att du kan konfigurera inställningar för värdplattformen, inklusive:

  • Bitness:32-bitars eller 64-bitars. (Standardvärdet är 32-bitars för App Service skapas i portalen.)

  • WebSocket-protokoll: [för ASP.NET SignalR] eller socket.io, till exempel.

  • Alltid på: Håller appen inläst även om det inte finns någon trafik. När Always On inte är aktiverat (standard) tas appen bort efter 20 minuter utan några inkommande begäranden. Den bortladdade appen kan orsaka lång svarstid för nya begäranden på grund av dess uppvärmningstid. När Always On är aktiverat skickar lastbalanseraren på frontend-sidan en GET-begäran till programroten var femte minut. Kontinuerlig ping förhindrar att appen tas bort.

    Always On krävs för kontinuerliga webbjobb eller för webbjobb som utlöses med hjälp av ett CRON-uttryck.

  • Hanterad pipelineversion: [IIS-pipelineläget]. Ställ in den på Klassisk om du har en äldre app som kräver en äldre version av IIS.

  • HTTP-version: Ange till 2.0 för att aktivera stöd för HTTPS/2-protokoll.

  Anteckning

  De flesta moderna webbläsare stöder endast HTTP/2-protokoll över TLS, medan icke-krypterad trafik fortsätter att använda HTTP/1.1. Skydda ditt anpassade DNS-namn för att säkerställa att klientwebbläsare ansluter till din app med HTTP/2. Mer information finns i Skydda ett anpassat DNS-namn med en TLS/SSL-bindning i Azure App Service.

  • ARR-tillhörighet: I en distribution med flera instanser ska du se till att klienten dirigeras till samma instans under sessionens livslängd. Du kan ställa in det här alternativet på Av för tillståndslösa program.

• Felsökning: Aktivera fjärrfelsökning för ASP.NET, ASP.NET Coreeller Node.js appar. Det här alternativet stängs av automatiskt efter 48 timmar.

• Inkommande klientcertifikat: kräv klientcertifikat i ömsesidig autentisering.

Konfigurera standarddokument

Den här inställningen är endast för Windows appar.

I listan Azure Portaldu efter och väljer App Services och väljer sedan din app. I appens vänstra meny väljer du Konfigurationsstandarddokument. >

Standarddokumentet är den webbsida som visas på rot-URL:en för en webbplats. Den första matchande filen i listan används. Om du vill lägga till ett nytt standarddokument klickar du på Nytt dokument. Glöm inte att klicka på Spara.

Om appen använder moduler som dirigeras baserat på URL i stället för att visa statiskt innehåll, finns det inget behov av standarddokument.

Konfigurera sökvägsmappningar

I listan Azure Portaldu efter och väljer App Services och väljer sedan din app. I appens vänstra meny väljer du Mappningar av > konfigurationssökväg.

Windows appar (ejcontainererade)

För Windows-appar kan du anpassa IIS-hanterarmappningar samt virtuella program och kataloger.

Med hanterarmappningar kan du lägga till processorer för anpassade skript för att hantera begäranden för specifika filnamnstillägg. Om du vill lägga till en anpassad hanterare klickar du på Ny hanterarmappning. Konfigurera hanteraren på följande sätt:

• Tillägget. Filnamnstillägget som du vill hantera, till exempel * .php eller handler.fcgi.
• Skriptprocessor. Den absoluta sökvägen för skriptprocessorn till dig. Begäranden till filer som matchar filnamnstillägget bearbetas av skriptprocessorn. Använd sökvägen D:\home\site\wwwroot för att referera till appens rotkatalog.
• Argument . Valfria kommandoradsargument för skriptprocessorn.

Varje app har standardrotsökvägen ( / ) mappad D:\home\site\wwwroot till , där koden distribueras som standard. Om din approt finns i en annan mapp, eller om din lagringsplats har fler än ett program, kan du redigera eller lägga till virtuella program och kataloger här.

På fliken Sökvägsmappningar klickar du på Nytt virtuellt program eller katalog.

• Om du vill mappa en virtuell katalog till en fysisk sökväg lämnar du kryssrutan Katalog markerad. Ange den virtuella katalogen och motsvarande relativa (fysiska) sökväg till webbplatsroten ( D:\home ).

• Om du vill markera en virtuell katalog som ett webbprogram avmarkerar du kryssrutan Katalog.

  

Containeriserade appar

Du kan lägga till anpassad lagring för din containeriserade app. Containeriserade appar innehåller alla Linux-appar och även Windows anpassade Linux-containrar som körs på App Service. Klicka på Ny Azure Storage montera och konfigurera din anpassade lagring på följande sätt:

• Namn: Visningsnamnet.
• Konfigurationsalternativ: Grundläggande eller Avancerat.
• Storage: Lagringskontot med den container som du vill använda.
• Storage: Azure Blobs eller Azure Files.

  Anteckning

  Windows containerappar stöder endast Azure Files.

• Storage container: För grundläggande konfiguration, den container som du vill använda.
• Resursnamn: För avancerad konfiguration, filresursens namn.
• Åtkomstnyckel: För avancerad konfiguration, åtkomstnyckeln.
• Monteringssökväg: Den absoluta sökvägen i containern för att montera den anpassade lagringen.

Mer information finns i Access Azure Storage as a network share from a container in App Service.

Konfigurera inställningar för språkstack

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

Konfigurera anpassade containrar

Se Konfigurera en anpassad Linux-container för Azure App Service

Nästa steg

• Referens för miljövariabler och appinställningar
• Konfigurera ett anpassat domännamn i Azure App Service
• Konfigurera mellanlagringsmiljöer i Azure App Service
• Skydda ett anpassat DNS-namn med en TLS/SSL-bindning i Azure App Service
• Aktivera diagnostikloggar
• Skala en app i Azure App Service
• Grundläggande om övervakning i Azure App Service
• Ändra applicationHost.config med applicationHost.xdt