Konfigurera en App Service-app

Kommentar

Från och med den 1 juni 2024 har alla nyligen skapade App Service-appar möjlighet att generera ett unikt standardvärdnamn med hjälp av namngivningskonventionen <app-name>-<random-hash>.<region>.azurewebsites.net. Befintliga appnamn förblir oförändrade.

Exempel: myapp-ds27dh7271aah175.westus-01.azurewebsites.net

Mer information finns i Unikt standardvärdnamn för App Service-resurs.

Den här artikeln beskriver hur du konfigurerar vanliga inställningar för webbappar, mobil serverdel eller API-app. Information om Azure Functions finns i Referens för appinställningar för Azure Functions.

Konfigurera appinställningar

Kommentar

• Namn på appinställningar kan bara innehålla bokstäver, siffror (0–9), punkter ("." och understreck ("_")
• Specialtecken i värdet för en appinställning måste undantagas efter behov av måloperativsystemet

Om du till exempel vill ange en miljövariabel i App Service Linux med värdet "pa$$w0rd\" ska strängen för appinställningen vara: "pa\$\$w0rd\\"

I App Service är appinställningar variabler som skickas som miljövariabler till programkoden. För Linux-appar och anpassade containrar skickar App Service appinställningar till containern --env med hjälp av flaggan för att ange miljövariabeln i containern. I båda fallen matas de in i din appmiljö vid appstart. När du lägger till, tar bort eller redigerar appinställningar utlöser App Service en omstart av appen.

För ASP.NET och ASP.NET Core-utvecklare är det som att ange appinställningar i App Service som att ange dem i <appSettings>Web.config eller appsettings.json, men värdena i App Service åsidosätter dem i Web.config eller appsettings.json. Du kan behålla utvecklingsinställningar (till exempel lokalt 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 dina utvecklingsinställningar 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
• Anpassade containrar

Appinställningar krypteras alltid när de lagras (krypterade i vila).

Kommentar

Appinställningar kan också matchas från Key Vault med hjälp av Key Vault-referenser.

Azure-portalen

1. I Azure-portalen söker du efter och väljer App Services och väljer sedan din app.

   

2. I appens vänstra meny väljer du Miljövariabler>Appinställningar.

   

   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 väljer du dess värdefält . Om du vill se dolda värden för alla appinställningar väljer du knappen Visa värden .

3. Om du vill lägga till en ny appinställning väljer du Lägg till. Om du vill redigera en inställning klickar du på inställningen.

4. I dialogrutan kan du hålla inställningen till det aktuella facket.

   Kommentar

   I en linux-standardapptjänst eller en anpassad Linux-container måste valfri kapslad JSON-nyckelstruktur i appinställningsnamnet ApplicationInsights:InstrumentationKey konfigureras i App Service som ApplicationInsights__InstrumentationKey för nyckelnamnet. Med andra ord bör alla : ersättas med __ (dubbelt understreck). Alla perioder i appinställningens namn ersätts med ett _ (enda understreck).

5. När du är klar väljer du Använd. Glöm inte att välja Använd igen på sidan Miljövariabler.

Azure CLI

Lägg till eller redigera en appinställning med az webapp config app settings set:

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

Ersätt <setting-name> med namnet på inställningen och <value> med värdet som ska tilldelas till den.

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

az webapp config appsettings list --name <app-name> --resource-group <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 <group-name> --setting-names {<setting-name1>,<setting-name2>,...}

Azure PowerShell

Ange en eller flera appinställningar med Set-AzWebApp:

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

Den här cmdleten ersätter hela uppsättningen med appinställningar med de som du anger. Om du vill lägga till eller redigera en appinställning i en befintlig uppsättning inkluderar du de befintliga appinställningarna i hashtable-indata med hjälp av cmdleten Get-AzWebApp . Till exempel:

# 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

Om du vill kontrollera om en appinställning är platsspecifik använder du Get-AzWebAppSlotConfigName:

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

Om du vill göra en eller flera appinställningar fackspecifika använder du Set-AzWebAppSlotConfigName:

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

Massredigera appinställningar

Azure-portalen

Välj knappen Avancerad redigering. Redigera inställningarna i textområdet. När du är klar väljer du OK. Glöm inte att välja Använd igen på sidan Miljövariabler.

Appinställningarna har följande JSON-formatering:

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

Azure CLI

Kör az webapp config app settings set with the name of the JSON file (Kör az webapp config app settings set with the name of the JSON file).

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

Dricks

Omsluter filnamnet med citattecken krävs endast i PowerShell.

Det filformat som behövs är en JSON-matris med inställningar där platsinställningsfältet är valfritt. Till exempel:

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

För enkelhetens skull kan du spara befintliga inställningar i en JSON-fil med az webapp config appsettings list. Följande exempel kan köras i 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

Det går inte att redigera appinställningar i grupp med hjälp av en JSON-fil med Azure PowerShell.

Konfigurera anslutningssträngar

För ASP.NET och ASP.NET Core-utvecklare är inställningen niska veze i App Service som att ange dem i <connectionStrings>Web.config, men de värden som du anger i App Service åsidosätter dem i Web.config. Du kan behålla utvecklingsinställningar (till exempel en databasfil) i Web.config och produktionshemligheter (till exempel SQL Database-autentiseringsuppgifter) på ett säkert sätt i App Service. Samma kod använder dina utvecklingsinställningar 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 niska veze kräver särskild formatering i variabelnycklarna för att få åtkomst till värdena.

Kommentar

Det finns ett fall där du kanske vill använda niska veze i stället för appinställningar för non-.NET språk: vissa Azure-databastyper säkerhetskopieras endast tillsammans med appen om du konfigurerar en niska veze för databasen i App Service-appen. Mer information finns i Skapa en anpassad säkerhetskopia. Om du inte behöver den här automatiserade säkerhetskopieringen använder du appinställningar.

Vid körning är niska veze tillgängliga som miljövariabler, prefix med följande anslutningstyper:

• SQLServer: SQLCONNSTR_
• MySQL: MYSQLCONNSTR_
• SQLAzure: SQLAZURECONNSTR_
• Sed: CUSTOMCONNSTR_
• PostgreSQL: POSTGRESQLCONNSTR_
• Notification Hub: NOTIFICATIONHUBCONNSTR_
• Service Bus: SERVICEBUSCONNSTR_
• Händelsehubb: EVENTHUBCONNSTR_
• Dokumentdatabas: DOCDBCONNSTR_
• Redis Cache: REDISCACHECONNSTR_

Kommentar

.NET-appar för PostgreSQL, Notification Hub, Service Bus, Event Hub, Document Db och Redis Cache bör ange niska veze till Anpassad som lösning för ett känt problem i .NET EnvironmentVariablesConfigurationProvider

Till exempel kan en MySQL-niska veze 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
• Anpassade containrar

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

Kommentar

Anslutningssträngar kan också matchas från Key Vault med hjälp av Key Vault-referenser.

Azure-portalen

1. I Azure-portalen söker du efter och väljer App Services och väljer sedan din app.

   

2. I appens vänstra meny väljer du Miljövariabler>Anslutningssträngar.

   

   Som standard döljs värden för niska veze i portalen för säkerhet. Om du vill se ett dolt värde för en niska veze väljer du fältet Värde. Om du vill se dolda värden för alla niska veze väljer du knappen Visa värde.

3. Om du vill lägga till en ny niska veze väljer du Lägg till. Om du vill redigera en niska veze väljer du niska veze.

4. I dialogrutan kan du hålla niska veze till det aktuella facket.

5. När du är klar väljer du Använd. Glöm inte att välja Använd igen på sidan Miljövariabler.

Azure CLI

Lägg till eller redigera en appinställning med 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>'

Ersätt <string-name> med namnet på niska veze och <value> med värdet som ska tilldelas till den. Möjliga värden <type> för (till exempel SQLAzure), finns i CLI-kommandodokumentationen.

Visa alla niska veze och deras värden med az webapp config connection-string list:

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

Ta bort en eller flera niska veze med 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

Ange en eller flera niska veze med 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

Varje niska veze innehåller ett namn (<string-name1>), ett värde (<connection-string1>) och typen, vilket är ett numeriskt värde som motsvarar ett av ConnectionStringType-uppräkningsfälten. För SQL Azure anger du type="2"till exempel .

Den här cmdleten ersätter hela uppsättningen med niska veze med de som du anger. Om du vill lägga till eller redigera en appinställning i en befintlig uppsättning inkluderar du de befintliga appinställningarna i din indata-hashtable med hjälp av cmdleten Get-AzWebApp . Till exempel:

# 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.ConnectionString; type=$item.Type.ToString()}
}

# 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

Om du vill kontrollera om en niska veze är platsspecifik använder du Get-AzWebAppSlotConfigName:

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

Om du vill göra en eller flera niska veze fackspecifika använder du Set-AzWebAppSlotConfigName:

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

Massredigera niska veze

Azure-portalen

Välj knappen Avancerad redigering. Redigera niska veze i textområdet. När du är klar väljer du Använd. Glöm inte att välja Använd igen på sidan Miljövariabler.

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
  },
  ...
]

Azure CLI

Kör az webapp config connection-string set med namnet på JSON-filen.

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

Dricks

Omsluter filnamnet med citattecken krävs endast i PowerShell.

Filformatet som behövs är en JSON-matris med niska veze där platsinställningsfältet är valfritt. Till exempel:

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

För enkelhetens skull kan du spara befintliga niska veze i en JSON-fil med az webapp config connection-string list. Följande exempel kan köras i 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 connection-string set --resource-group <group-name> --name <app-name> --settings @settings.json

Azure PowerShell

Det går inte att redigera niska veze i grupp med hjälp av en JSON-fil med Azure PowerShell.

Konfigurera inställningar för språkstacken

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

Konfigurera allmänna inställningar

Azure-portalen

I Azure-portalen söker du efter och väljer App Services och väljer sedan din app. I appens vänstra meny väljer du Konfiguration>Allmänna inställningar.

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 för att köra appen, inklusive språk- och SDK-versioner.

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

  

• Plattformsinställningar: Låter dig konfigurera inställningar för värdplattformen, inklusive:

  • Plattformsbitness: 32-bitars eller 64-bitars. Endast för Windows-appar.
  • FTP-tillstånd: Tillåt endast FTPS eller inaktivera FTP helt och hållet.
  • HTTP-version: Ange till 2.0 för att aktivera stöd för HTTPS/2-protokoll .

  Kommentar

  De flesta moderna webbläsare stöder endast HTTP/2-protokoll via 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.

  • Webbuttag: För ASP.NET SignalR eller socket.io, till exempel.

  • AlwaysOn: Håller appen inläst även om det inte finns någon trafik. När AlwaysOn inte är aktiverat (standard) tas appen bort efter 20 minuter utan inkommande begäranden. Den borttagna appen kan orsaka långa svarstider för nya begäranden på grund av uppvärmningstiden. När Always On är aktiverat skickar frontend-lastbalanseraren en GET-begäran till programroten var femte minut. Den kontinuerliga pingen förhindrar att appen tas bort.

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

  • ARR-tillhörighet: I en distribution med flera instanser kontrollerar du 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.

  • Endast HTTPS: När den är aktiverad omdirigeras all HTTP-trafik till HTTPS.

  • Lägsta TLS-version: Välj den lägsta TLS-krypteringsversion som krävs av din app.

• Felsökning: Aktivera fjärrfelsökning för ASP.NET, ASP.NET Core eller Node.js appar. Det här alternativet inaktiveras automatiskt efter 48 timmar.

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

Azure CLI

Du kan ange många av de vanliga konfigurerbara alternativen med az webapp config set. I följande exempel visas en delmängd av de konfigurerbara alternativen.

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

Om du vill visa de befintliga inställningarna använder du kommandot az webapp config show .

Azure PowerShell

Du kan ange många av de vanliga konfigurerbara alternativen med Set-AzWebApp. I följande exempel visas en delmängd av de konfigurerbara alternativen.

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

Om du vill visa de befintliga inställningarna använder du kommandot Get-AzWebApp .

Konfigurera standarddokument

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

Standarddokumentet är den webbsida som visas på rot-URL:en för en App Service-app. Den första matchande filen i listan används. Om appen använder moduler som dirigeras baserat på URL i stället för att hantera statiskt innehåll behöver du inte använda standarddokument.

Azure-portalen

1. I Azure-portalen söker du efter och väljer App Services och väljer sedan din app.

2. I appens vänstra meny väljer du Standarddokument för konfiguration>.

   

3. Om du vill lägga till ett standarddokument väljer du Nytt dokument. Om du vill ta bort ett standarddokument väljer du Ta bort till höger.

Azure CLI

Lägg till ett standarddokument med 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

Lägg till ett standarddokument genom att ändra uppdateringsappens PowerShell-objekt:

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

Mappa en URL-sökväg till en katalog

Som standard startar App Service din app från rotkatalogen för din appkod. Men vissa webbramverk startar inte i rotkatalogen. Laravel startar till exempel i underkatalogen public. En sådan app skulle till exempel vara tillgänglig på http://contoso.com/public, men du vill vanligtvis dirigera http://contoso.com till public katalogen i stället. Om appens startfil finns i en annan mapp, eller om lagringsplatsen har fler än ett program, kan du redigera eller lägga till virtuella program och kataloger.

Viktigt!

Virtuell katalog till en fysisk sökvägsfunktion är endast tillgänglig i Windows-appar.

Azure-portalen

1. I Azure-portalen söker du efter och väljer App Services och väljer sedan din app.

2. I appens vänstra meny väljer du Mappningar för konfigurationssökväg>

3. Välj 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 .

   

4. Välj OK. Glöm inte att välja Spara på sidan Konfiguration .

Azure CLI

I följande exempel anges rotsökvägen / till underkatalogen public (som fungerar för Laravel) och lägger även till ett andra virtuellt program på /app2 sökvägen. Om du vill köra den skapar du en fil med json.txt namnet med följande innehåll.

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

Ändra <group-name> och <app-name> för dina resurser och kör följande kommando. Tänk på escape-tecken när du kör det här kommandot. Mer information om escape-tecken finns i Tips för att använda Azure CLI.

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

I följande exempel anges rotsökvägen / till underkatalogen public (som fungerar för Laravel) och lägger även till ett andra virtuellt program på /app2 sökvägen. Om du vill köra den ändrar du <group-name> och <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

Konfigurera hanterarmappningar

För Windows-appar kan du anpassa IIS-hanterarmappningar och virtuella program och kataloger. Med hanterarmappningar kan du lägga till anpassade skriptprocessorer för att hantera begäranden för specifika filnamnstillägg.

Så här lägger du till en anpassad hanterare:

1. I Azure-portalen söker du efter och väljer App Services och väljer sedan din app.

2. I appens vänstra meny väljer du Mappningar för konfigurationssökväg>.

   

3. Välj Ny hanterarmappning. Konfigurera hanteraren på följande sätt:

   • Tillägg. 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 filtillä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.

4. Välj OK. Glöm inte att välja Spara på sidan Konfiguration .

Konfigurera anpassade containrar

• Konfigurera en anpassad container för Azure App Service
• Lägga till anpassad lagring för din containerbaserade app

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 övervakning i Azure App Service
• Ändra applicationHost.config-inställningar med applicationHost.xdt