Konfigurace aplikace App Service

1. Na webu Azure Portal vyhledejte a vyberte App Services a pak vyberte svou aplikaci.

   

2. V nabídce vlevo aplikace vyberte Nastavení aplikace proměnných>prostředí.

   

   Ve výchozím nastavení jsou hodnoty nastavení aplikace na portálu z bezpečnostních důvodů skryté. Pokud chcete zobrazit skrytou hodnotu nastavení aplikace, vyberte její pole Hodnota . Pokud chcete zobrazit skryté hodnoty všech nastavení aplikace, vyberte tlačítko Zobrazit hodnoty .

3. Pokud chcete přidat nové nastavení aplikace, vyberte Přidat. Pokud chcete upravit nastavení, klikněte na nastavení.

4. V dialogovém okně můžete nastavení přilepit k aktuálnímu slotu.

   Poznámka:

   Ve výchozí službě Linux App Service nebo vlastním kontejneru Linuxu musí být každá vnořená struktura klíčů JSON v názvu nastavení aplikace, jako ApplicationInsights:InstrumentationKey by se pro název klíče nakonfigurovala ve službě App Service ApplicationInsights__InstrumentationKey . Jinými slovy, všechny : by měly být nahrazeny (dvojitým __ podtržítkem). Všechna období v názvu nastavení aplikace se nahradí znakem _ (jedno podtržítko).

5. Po dokončení vyberte Použít. Nezapomeňte vybrat Možnost Použít zpět na stránce Proměnné prostředí.

Přidání nebo úprava nastavení aplikace pomocí az webapp config app settings set:

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

Nahraďte <setting-name> názvem nastavení a <value> hodnotou, která se k němu přiřadí.

Zobrazení všech nastavení a jejich hodnot pomocí příkazu az webapp config appsettings list:

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

Odeberte jedno nebo více nastavení pomocí příkazu az webapp config app delete:

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

Nastavení jedné nebo více aplikací pomocí Set-AzWebApp:

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

Tato rutina nahradí celou sadu nastavení aplikace zadanými nastaveními. Pokud chcete přidat nebo upravit nastavení aplikace v rámci existující sady, zahrňte do vstupní hashtable existující nastavení aplikace pomocí rutiny Get-AzWebApp . Příklad:

# 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

Pokud chcete zkontrolovat, jestli je nastavení aplikace specifické pro slot, použijte rutinu Get-AzWebAppSlotConfigName:

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

Pokud chcete nastavit jedno nebo více nastavení aplikace pro konkrétní slot, použijte Set-AzWebAppSlotConfigName:

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

Vyberte tlačítko Upřesnit úpravy. Upravte nastavení v textové oblasti. Po dokončení vyberte OK. Nezapomeňte vybrat Možnost Použít zpět na stránce Proměnné prostředí.

Nastavení aplikace má následující formátování JSON:

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

Spusťte 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"

Potřebný formát souboru je pole JSON s nastavením, kde pole nastavení slotu je volitelné. Příklad:

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

Pro usnadnění můžete existující nastavení uložit do souboru JSON pomocí příkazu az webapp config appsettings list. Následující příklad lze spustit v 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

Nastavení aplikace není možné hromadně upravovat pomocí souboru JSON pomocí Azure PowerShellu.

1. Na webu Azure Portal vyhledejte a vyberte App Services a pak vyberte svou aplikaci.

   

2. V levé nabídce aplikace vyberte Připojovací řetězce proměnných> prostředí.

   

   Ve výchozím nastavení jsou hodnoty pro připojovací řetězec skryté na portálu pro zabezpečení. Pokud chcete zobrazit skrytou hodnotu připojovací řetězec, vyberte její pole Hodnota. Pokud chcete zobrazit skryté hodnoty všech připojovací řetězec, vyberte tlačítko Zobrazit hodnotu.

3. Pokud chcete přidat nový připojovací řetězec, vyberte Přidat. Pokud chcete upravit připojovací řetězec, vyberte připojovací řetězec.

4. V dialogovém okně můžete připojovací řetězec přichytit k aktuálnímu slotu.

5. Po dokončení vyberte Použít. Nezapomeňte vybrat Možnost Použít zpět na stránce Proměnné prostředí.

Přidání nebo úprava nastavení aplikace pomocí příkazu 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>'

Nahraďte <string-name> názvem připojovací řetězec a <value> hodnotou, která se k ní přiřadí. Možné hodnoty (napříkladSQLAzure) najdete v dokumentaci k příkazům rozhraní příkazového <type> řádku.

Zobrazení všech připojovací řetězec a jejich hodnot pomocí příkazu az webapp config connection-string list:

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

Odeberte jeden nebo více připojovací řetězec pomocí příkazu 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>,...}

Nastavení jednoho nebo více připojovací řetězec pomocí 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

Každý připojovací řetězec obsahuje název (<string-name1>), hodnotu (<connection-string1>) a typ, což je číselná hodnota, která odpovídá jednomu z polí výčtu ConnectionStringType. Například pro SQL Azure zadejte type="2".

Tato rutina nahradí celou sadu připojovací řetězec zadanými sadami. Pokud chcete přidat nebo upravit nastavení aplikace v existující sadě, zahrňte do vstupní hashtable nastavení aplikace pomocí rutiny Get-AzWebApp . Příklad:

# 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

Pokud chcete zkontrolovat, jestli je připojovací řetězec specifický pro slot, použijte rutinu Get-AzWebAppSlotConfigName:

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

Pokud chcete nastavit jeden nebo více připojovací řetězec s pro konkrétní slot, použijte Set-AzWebAppSlotConfigName:

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

Vyberte tlačítko Upřesnit úpravy. Upravte připojovací řetězec v textové oblasti. Po dokončení vyberte Použít. Nezapomeňte vybrat Možnost Použít zpět na stránce Proměnné prostředí.

Připojovací řetězce mají následující formátování JSON:

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

Spusťte příkaz az webapp config connection-string set s názvem souboru JSON.

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

Potřebný formát souboru je pole JSON připojovací řetězec, kde pole nastavení slotu je volitelné. Příklad:

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

Pro usnadnění můžete existující připojovací řetězec uložit do souboru JSON pomocí příkazu az webapp config connection-string list. Následující příklad lze spustit v 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

Pomocí souboru JSON v Azure PowerShellu není možné hromadně upravovat připojovací řetězec.

Na webu Azure Portal vyhledejte a vyberte App Services a pak vyberte svou aplikaci. V nabídce vlevo aplikace vyberte Obecné nastavení konfigurace>.

Tady můžete pro aplikaci nakonfigurovat některá běžná nastavení. Některá nastavení vyžadují vertikální navýšení kapacity na vyšší cenové úrovně.

• Nastavení zásobníku: Softwarový zásobník pro spuštění aplikace, včetně jazyka a verzí sady SDK.

  V případě linuxových aplikací můžete vybrat verzi modulu runtime jazyka a nastavit volitelný spouštěcí příkaz nebo soubor spouštěcího příkazu.

  

• Nastavení platformy: Umožňuje konfigurovat nastavení hostitelské platformy, včetně:

  • Bitová verze platformy: 32bitová nebo 64bitová. Jenom pro aplikace pro Windows.
  • Stav FTP: Povolte jenom FTPS nebo úplně zakažte FTP.
  • Verze HTTP: Pokud chcete povolit podporu protokolu HTTPS/2, nastavte na hodnotu 2.0.

  Poznámka:

  Většina moderních prohlížečů podporuje protokol HTTP/2 pouze přes protokol TLS, zatímco nešifrovaný provoz nadále používá protokol HTTP/1.1. Pokud chcete zajistit, aby se klientské prohlížeče připojily k vaší aplikaci pomocí protokolu HTTP/2, zabezpečte vlastní název DNS. Další informace najdete v tématu Zabezpečení vlastního názvu DNS pomocí vazby TLS/SSL ve službě Aplikace Azure Service.

  • Webové sokety: Například pro ASP.NET SignalR nebo socket.io.

  • AlwaysOn: Aplikace se načte i v případě, že neexistuje žádný provoz. Pokud funkce AlwaysOn není zapnutá (výchozí), aplikace se uvolní po 20 minutách bez příchozích požadavků. Uvolněná aplikace může způsobit vysokou latenci nových požadavků kvůli době zahřátí. Když je zapnutá funkce AlwaysOn , front-endový nástroj pro vyrovnávání zatížení každých pět minut odešle do kořenového adresáře aplikace požadavek GET. Je důležité zajistit, aby tento požadavek obdržel odpověď 200 OK, aby se zajistilo, že se všechny operace opětovného vytvoření image provádějí správně. Průběžný příkaz ping zabrání uvolnění aplikace.

    Funkce AlwaysOn se vyžaduje pro průběžné webové úlohy nebo pro WebJobs, které se aktivují pomocí výrazu CRON.

  • Spřažení relací: V nasazení s více instancemi se ujistěte, že je klient směrován na stejnou instanci po dobu životnosti relace. Tuto možnost můžete nastavit na Vypnuto pro bezstavové aplikace.

  • Proxy spřažení relací: Proxy spřažení relací se dá zapnout, pokud je vaše aplikace za reverzním proxy serverem (například Aplikace Azure lication Gateway nebo Azure Front Door) a používáte výchozí název hostitele. Doména souboru cookie spřažení relace bude odpovídat předanému názvu hostitele z reverzního proxy serveru.

  • Pouze HTTPS: Při povolení se veškerý provoz HTTP přesměruje na HTTPS.

  • Minimální verze protokolu TLS: Vyberte minimální verzi šifrování TLS požadovanou vaší aplikací.

• Ladění: Povolte vzdálené ladění pro aplikace ASP.NET, ASP.NET Core nebo Node.js . Tato možnost se automaticky vypne po 48 hodinách.

• Příchozí klientské certifikáty: Vyžadují klientské certifikáty při vzájemném ověřování.

Pomocí příkazu az webapp config set můžete nastavit řadu běžných konfigurovatelných možností. Následující příklad ukazuje podmnožinu konfigurovatelných možností.

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

Pokud chcete zobrazit existující nastavení, použijte příkaz az webapp config show .

Pomocí set-AzWebApp můžete nastavit řadu běžných konfigurovatelných možností. Následující příklad ukazuje podmnožinu konfigurovatelných možností.

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

Pokud chcete zobrazit existující nastavení, použijte příkaz Get-AzWebApp .

1. Na webu Azure Portal vyhledejte a vyberte App Services a pak vyberte svou aplikaci.

2. V levé nabídce aplikace vyberte Výchozí dokumenty konfigurace>.

   

3. Pokud chcete přidat výchozí dokument, vyberte Nový dokument. Pokud chcete odebrat výchozí dokument, vyberte Odstranit napravo.

Přidejte výchozí dokument pomocí příkazu 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>

Přidejte výchozí dokument úpravou objektu PowerShellu pro aktualizaci aplikace:

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

1. Na webu Azure Portal vyhledejte a vyberte App Services a pak vyberte svou aplikaci.

2. V levé nabídce aplikace vyberte mapování cest konfigurace>.

3. Vyberte Nová virtuální aplikace nebo adresář.

   • Pokud chcete mapovat virtuální adresář na fyzickou cestu, nechte políčko Adresář zaškrtnuté. Zadejte virtuální adresář a odpovídající relativní (fyzickou) cestu ke kořenovému adresáři webu (D:\home).
   • Pokud chcete virtuální adresář označit jako webovou aplikaci, zrušte zaškrtnutí políčka Adresář .

   

4. Vyberte OK. Nezapomeňte vybrat Uložit na stránce Konfigurace .

Následující příklad nastaví kořenovou cestu / k public podadresáři (která funguje pro Laravel) a přidá do /app2 cesty také druhou virtuální aplikaci. Pokud ho chcete spustit, vytvořte soubor s názvem json.txt s následujícím obsahem.

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

Změňte <group-name> prostředky a <app-name> spusťte následující příkaz. Při spuštění tohoto příkazu mějte na paměti řídicí znaky. Další informace o řídicích znamech najdete v tématu Tipy pro úspěšné použití 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"

Následující příklad nastaví kořenovou cestu / k public podadresáři (která funguje pro Laravel) a přidá do /app2 cesty také druhou virtuální aplikaci. Pokud ho chcete spustit, změňte <group-name> a <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