Konfigurace aplikace App Service v Azure Portal

Tento článek vysvětluje, jak nakonfigurovat společná nastavení pro webové aplikace, mobilní back-end nebo aplikaci API pomocí Azure Portal.

Konfigurace nastavení aplikace

V App Service jsou nastavení aplikace proměnné předány jako proměnné prostředí do kódu aplikace. U aplikací pro Linux a vlastních kontejnerů App Service předá nastavení aplikace kontejneru pomocí --env příznaku, který nastaví proměnnou prostředí v kontejneru. V obou případech se při spuštění aplikace vloží do prostředí aplikace. Když přidáte, odeberete nebo upravíte nastavení aplikace, App Service spustí restart aplikace. Názvy nastavení aplikace nesmí obsahovat tečky ( . ). Pokud nastavení aplikace obsahuje tečku, je období nahrazeno podtržítkem v kontejneru.

V Azure Portalvyhledejte a vyberte App Services a pak vyberte svou aplikaci.

V nabídce vlevo aplikace vyberte nastavení Konfigurace > aplikace.

v případě vývojářů ASP.NET a ASP.NET Core je nastavení aplikace v App Service třeba nastavit v souboru <appSettings> Web.config nebo appsettings. json, ale hodnoty v App Service přepisují ty v Web.config nebo appsettings. json. V App Service můžete ponechat nastavení pro vývoj (například místní heslo MySQL) v Web.config nebo appSettings. JSON a v produkčních tajných klíčích (například heslo databáze Azure MySQL). Stejný kód používá vaše vývojové nastavení při ladění místně a při nasazení do Azure používá vaše provozní tajemství.

Další jazykové zásobníky také získají nastavení aplikace jako proměnné prostředí za běhu. Postup pro konkrétní jazykový zásobník najdete v těchto tématech:

• ASP.NET Core
• Node.js
• PHP
• Python
• Java
• Ruby
• Vlastní kontejnery

Nastavení aplikace jsou při ukládání vždy zašifrovaná (zašifrovaná po klidové době).

Zobrazit skryté hodnoty

Ve výchozím nastavení jsou hodnoty nastavení aplikace na portálu pro zabezpečení skryté. Chcete-li zobrazit skrytou hodnotu nastavení aplikace, klikněte na pole hodnota daného nastavení. Pokud chcete zobrazit hodnoty všech nastavení aplikace, klikněte na tlačítko Zobrazit hodnotu .

Přidat nebo upravit

Chcete-li přidat nové nastavení aplikace, klikněte na tlačítko nové nastavení aplikace. V dialogovém okně můžete nastavení nastavit na aktuální slot.

Chcete-li upravit nastavení, klikněte na tlačítko Upravit na pravé straně.

Po dokončení klikněte na aktualizovat. Nezapomeňte kliknout na Uložit zpátky na stránce Konfigurace .

Hromadná úprava

Chcete-li přidat nebo upravit nastavení aplikace hromadně, klikněte na tlačítko Rozšířené úpravy . Po dokončení klikněte na aktualizovat. Nezapomeňte kliknout na Uložit zpátky na stránce Konfigurace .

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

Automatizace nastavení aplikací pomocí Azure CLI

Pomocí Azure CLI můžete vytvořit a spravovat nastavení z příkazového řádku.

• Přiřazení hodnoty k nastavení pomocí AZ WebApp config App set:

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

  Nahraďte <setting-name> názvem nastavení a hodnotou, která se <value> má přiřadit. Tento příkaz vytvoří nastavení, pokud ještě neexistuje.

• Zobrazit všechna nastavení a jejich hodnoty pomocí AZ WebApp config appSettings list:

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

• Odeberte jedno nebo víc nastavení pomocí AZ WebApp config App Settings Delete:

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

  Nahraďte <names> seznamem názvů nastavení oddělených mezerami.

Konfigurace připojovacích řetězců

V Azure Portalvyhledejte a vyberte App Services a pak vyberte svou aplikaci. V nabídce vlevo aplikace vyberte nastavení Konfigurace > aplikace.

pro vývojáře ASP.NET a ASP.NET Core je nastavení připojovacích řetězců v App Service jako nastavení v <connectionStrings> v Web.config, ale hodnoty, které jste nastavili App Service, přepíší Web.config. nastavení vývoje (například databázový soubor) můžete zachovat v Web.config a v produkčních tajných klíčích (například SQL Database pověření) v App Service. Stejný kód používá vaše vývojové nastavení při ladění místně a při nasazení do Azure používá vaše provozní tajemství.

Pro jiné jazykové zásobníky je vhodnější místo toho použít nastavení aplikace , protože připojovací řetězce vyžadují pro přístup k hodnotám speciální formátování v proměnných klíčů.

V době běhu jsou připojovací řetězce k dispozici jako proměnné prostředí s předponou následujících typů připojení:

• Hostitel SQLCONNSTR_
• MySQL MYSQLCONNSTR_
• SQLAzure: SQLAZURECONNSTR_
• Uživatelská CUSTOMCONNSTR_
• PostgreSQL POSTGRESQLCONNSTR_

Například připojovací řetězec MySql s názvem ConnectionString1 je k dispozici jako proměnná prostředí MYSQLCONNSTR_connectionString1 . Postup pro konkrétní jazykový zásobník najdete v těchto tématech:

• ASP.NET Core
• Node.js
• PHP
• Python
• Java
• Ruby
• Vlastní kontejnery

Připojovací řetězce jsou při uložení vždy zašifrované (zašifrované – při REST).

Zobrazit skryté hodnoty

Ve výchozím nastavení jsou hodnoty připojovacích řetězců na portálu skryty pro zabezpečení. Chcete-li zobrazit skrytou hodnotu připojovacího řetězce, stačí kliknout na pole hodnota daného řetězce. Chcete-li zobrazit hodnoty všech připojovacích řetězců, klikněte na tlačítko Zobrazit hodnotu .

Přidat nebo upravit

Chcete-li přidat nový připojovací řetězec, klikněte na nový připojovací řetězec. V dialogovém okně můžete připojovací řetězec nalepit na aktuální slot.

Chcete-li upravit nastavení, klikněte na tlačítko Upravit na pravé straně.

Po dokončení klikněte na aktualizovat. Nezapomeňte kliknout na Uložit zpátky na stránce Konfigurace .

Hromadná úprava

Chcete-li přidat nebo upravit připojovací řetězce hromadně, klikněte na tlačítko Rozšířené úpravy . Po dokončení klikněte na aktualizovat. Nezapomeňte kliknout na Uložit zpátky na stránce Konfigurace .

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

Konfigurace obecných nastavení

V Azure Portalvyhledejte a vyberte App Services a pak vyberte svou aplikaci. V nabídce vlevo v aplikaci vyberte Konfigurace > Obecné nastavení.

Tady můžete pro aplikaci nakonfigurovat některá běžná nastavení. Některá nastavení vyžadují, abyste škálovat na vyšší cenovou úroveň.

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

  Pro linuxové aplikace a vlastní kontejnerové aplikace můžete vybrat verzi modulu runtime jazyka a nastavit volitelný spouštěcí příkaz nebo spouštěcí příkazový soubor.

  

• Nastavení platformy: Umožňuje konfigurovat nastavení pro hostingovou platformu, včetně:

  • Bitnost: 32bitová nebo 64bitová. (Výchozí hodnota je 32bitová pro App Service vytvořená na portálu.)

  • Protokol WebSocket: [Například ASP.NET SignalR] nebo socket.io.

  • Always On: Aplikace se načítá i v případě, že není žádný provoz. Pokud není funkce Always On 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řejení. Když je funkce Always On zapnutá, 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. Průběžný příkaz ping brání uvolnění aplikace.

    Pro průběžné webové úlohy nebo webové úlohy aktivované pomocí výrazu CRON se vyžaduje Always On.

  • Verze spravovaného kanálu: Režim [kanálu služby IIS.] Pokud máte starší verzi aplikace, která vyžaduje starší verzi služby IIS, nastavte ji na Classic.

  • Verze HTTP: Pokud chcete povolit podporu pro protokol HTTPS/2, nastavte na 2.0.

  Poznámka

  Většina moderních prohlížečů podporuje pouze protokol HTTP/2 přes protokol TLS, zatímco šifrovat provoz dál používá HTTP/1.1. Pokud chcete zajistit, aby se klientské prohlížeče připojují 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 v Azure App Service.

  • Spřažení směrování směrování na aplikace : V nasazení s více instancemi zajistěte, aby byl klient po dobu životnosti relace směrován do stejné instance. U bezstavových aplikací můžete tuto možnost nastavit na Vypnuto.

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

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

Konfigurace výchozích dokumentů

Toto nastavení je jenom pro Windows aplikace.

V Azure Portalvyhledejte a vyberte App Services a pak vyberte svou aplikaci. V levé nabídce aplikace vyberte Výchozí dokumenty > konfigurace.

Výchozí dokument je webová stránka, která se zobrazí na kořenové adrese URL webu. Použije se první odpovídající soubor v seznamu. Pokud chcete přidat nový výchozí dokument, klikněte na Nový dokument. Nezapomeňte kliknout na Uložit.

Pokud aplikace místo doručování statického obsahu používá moduly, které se směruje na základě adresy URL, nejsou výchozí dokumenty potřeba.

Konfigurace mapování cest

V Azure Portalvyhledejte a vyberte App Services a pak vyberte svou aplikaci. V levé nabídce aplikace vyberte Mapování cest > konfigurace.

Windows aplikace (bez kontejnerů)

Pro Windows můžete přizpůsobit mapování obslužných rutin služby IIS a virtuální aplikace a adresáře.

Mapování obslužných rutin vám umožňují přidat vlastní procesory skriptů pro zpracování požadavků na konkrétní přípony souborů. Pokud chcete přidat vlastní obslužnou rutinu, klikněte na Nové mapování obslužné rutiny. Obslužnou rutinu nakonfigurujte následujícím způsobem:

• Rozšíření. Přípona souboru, kterou chcete zpracovat, například * .php nebo handler.fcgi.
• Procesor skriptů. Absolutní cesta procesoru skriptu k vám. Požadavky na soubory, které odpovídají příponě souboru, zpracovává procesor skriptu. Cestu použijte k odkazování na kořenový adresář D:\home\site\wwwroot vaší aplikace.
• Argumenty. Volitelné argumenty příkazového řádku pro procesor skriptu.

Každá aplikace má výchozí kořenovou cestu ( ) mapovanou na , kde je váš kód ve výchozím nastavení / D:\home\site\wwwroot nasazený. Pokud se kořen aplikace nachází v jiné složce nebo pokud vaše úložiště obsahuje více než jednu aplikaci, můžete tady upravit nebo přidat virtuální aplikace a adresáře.

Na kartě Mapování cest klikněte na Nová virtuální aplikace nebo adresář.

• Pokud chcete namapovat virtuální adresář na fyzickou cestu, ponechte zaškrtnuté políčko Adresář. 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ář.

  

Kontejnerizované aplikace

Pro kontejnerizovanou aplikaci můžete přidat vlastní úložiště. Kontejnerizované aplikace zahrnují všechny linuxové aplikace a také vlastní kontejnery Windows a Linux spuštěné na App Service. Klikněte na Azure Storage Připojit a nakonfigurujte vlastní úložiště následujícím způsobem:

• Name: Zobrazovaný název.
• Možnosti konfigurace: Základní nebo Upřesnit.
• Storage účty: Účet úložiště s kontejnerem, který chcete.
• Storage typ: Objekty blob Azure nebo Azure Files.

  Poznámka

  Windows kontejnerové aplikace podporují pouze Azure Files.

• Storage kontejner: Pro základní konfiguraci je to kontejner, který chcete.
• Název sdílené složky: Pro pokročilou konfiguraci název sdílené složky.
• Přístupový klíč: Pro pokročilou konfiguraci přístupový klíč.
• Cesta pro připojení: Absolutní cesta v kontejneru pro připojení vlastního úložiště.

Další informace najdete v tématu Přístup Azure Storage jako sdílené síťové složky z kontejneru v App Service.

Konfigurace nastavení zásobníku jazyka

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

Konfigurace vlastních kontejnerů

Viz Konfigurace vlastního kontejneru Linuxu pro Azure App Service

Další kroky

• Referenční informace k proměnným prostředí a nastavením aplikace
• Konfigurace vlastního názvu domény v Azure App Service
• Nastavení přípravných prostředí ve službě Azure App Service
• Zabezpečení vlastního názvu DNS pomocí vazby TLS/SSL v Azure App Service
• Povolení diagnostických protokolů
• [Škálování aplikace v Azure App Service]
• Základy monitorování v Azure App Service
• Změna applicationHost.config pomocí souboru applicationHost.xdt