Konfigurace aplikace App Service

Tento článek vysvětluje, jak nakonfigurovat běžná nastavení pro webové aplikace, mobilní back-end nebo aplikaci API. Informace o Azure Functions najdete v referenčních informacích o nastavení aplikace pro Azure Functions.

Konfigurace nastavení aplikace

V App Service jsou nastavení aplikace proměnné předané jako proměnné prostředí kódu aplikace. Pro linuxové aplikace a vlastní kontejnery App Service předá nastavení aplikace kontejneru pomocí --env příznaku pro nastavení proměnné prostředí v kontejneru. V obou případech se vloží do vašeho aplikačního prostředí při spuštění aplikace. Když přidáte, odeberete nebo upravíte nastavení aplikace, App Service aktivuje restartování aplikace.

U ASP.NET a ASP.NET Core vývojářů se nastavení aplikace v App Service podobá nastavení <appSettings> v souboruWeb.config nebo appsettings.json, ale hodnoty v App Service přepíší hodnoty v souboruWeb.config nebo appsettings.json. Nastavení vývoje (například místní heslo MySQL) můžete udržovat v Web.config nebo appsettings.json a produkčních tajných kódech (například heslo databáze Azure MySQL) bezpečně v App Service. Stejný kód používá nastavení vývoje při místním ladění a při nasazování do Azure používá vaše produkční tajné kódy.

Další jazykové zásobníky také získají nastavení aplikace jako proměnné prostředí za běhu. Konkrétní kroky pro sadu jazyků najdete v následujících tématech:

Nastavení aplikace se vždy šifrují při uložení (zašifrování neaktivních uložených uložených dat).

Poznámka

Nastavení aplikace je možné vyřešit také z Key Vault pomocí odkazů na Key Vault.

  1. V Azure Portal vyhledejte a vyberte App Services a pak vyberte aplikaci.

    Hledání služby App Services

  2. V levé nabídce aplikace vyberte Nastavení konfigurační>aplikace.

    Nastavení aplikace

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

  3. Pokud chcete přidat nové nastavení aplikace, klikněte na Nové nastavení aplikace. Pokud chcete upravit nastavení, klikněte na tlačítko Upravit na pravé straně.

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

    Názvy nastavení aplikací nemohou obsahovat tečky (.). Pokud nastavení aplikace obsahuje tečku, tečka se nahradí podtržítkem v kontejneru.

    Poznámka

    Ve výchozím linuxovém app service nebo vlastním kontejneru Linuxu musí být všechny vnořené struktury klíčů JSON v názvu nastavení aplikace, jako je ApplicationInsights:InstrumentationKey třeba nakonfigurovat v App Service jako ApplicationInsights__InstrumentationKey pro název klíče. Jinými slovy, všechny : by měly být nahrazeny (dvojitým __ podtržítkem).

  5. Po dokončení klepněte na tlačítko Aktualizovat. Nezapomeňte kliknout na Uložit zpět na stránce Konfigurace .

Hromadné úpravy nastavení aplikace

Klikněte na tlačítko Upřesnit úpravy . Upravte nastavení v textové oblasti. Po dokončení klepněte na tlačítko Aktualizovat. Nezapomeňte kliknout na Uložit zpět 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
  },
  ...
]

Konfigurace připojovacích řetězců

V Azure Portal vyhledejte a vyberte App Services a pak vyberte aplikaci. V levé nabídce aplikace vyberte Nastavení konfigurační>aplikace.

Nastavení aplikace

Pro vývojáře ASP.NET a ASP.NET Core jsou nastavení připojovacích řetězců v App Service jako nastavení v <connectionStrings>Web.config, ale hodnoty, které jste nastavili v App Service, přepíší hodnoty v Web.config. Nastavení vývoje (například soubor databáze) můžete udržovat v Web.config a produkčních tajných kódech (například přihlašovací údaje SQL Database) bezpečně v App Service. Stejný kód používá nastavení vývoje při místním ladění a při nasazování do Azure používá vaše produkční tajné kódy.

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

Poznámka

Existuje jeden případ, kdy můžete chtít místo nastavení aplikace použít připojovací řetězce pro non-.NET jazyky: Některé typy databází Azure se zálohují spolu s aplikací jenom v případě, že nakonfigurujete připojovací řetězec pro databázi ve vaší App Service aplikaci. Další informace najdete v tématu Vytvoření vlastní zálohy. Pokud tuto automatickou zálohu nepotřebujete, použijte nastavení aplikace.

Za běhu jsou připojovací řetězce k dispozici jako proměnné prostředí s předponou s následujícími typy připojení:

  • Sqlserver: SQLCONNSTR_
  • Mysql: MYSQLCONNSTR_
  • SQLAzure: SQLAZURECONNSTR_
  • Vlastní: CUSTOMCONNSTR_
  • Postgresql: POSTGRESQLCONNSTR_

Například připojovací řetězec MySQL s názvem connectionstring1 je přístupný jako proměnná MYSQLCONNSTR_connectionString1prostředí . Konkrétní kroky pro sadu jazyků najdete v následujících tématech:

Připojovací řetězce se vždy šifrují při uložení (zašifrované neaktivní).

Poznámka

Připojovací řetězce lze také přeložit z Key Vault pomocí odkazů na Key Vault.

  1. V Azure Portal vyhledejte a vyberte App Services a pak vyberte aplikaci.

    Hledání služby App Services

  2. V levé nabídce aplikace vyberte Nastavení konfigurační>aplikace.

    Nastavení aplikace

    Ve výchozím nastavení jsou hodnoty připojovacích řetězců skryté na portálu pro zabezpečení. Pokud chcete zobrazit skrytou hodnotu připojovacího řetězce, klikněte na jeho pole Hodnota . Pokud chcete zobrazit skryté hodnoty všech připojovacích řetězců, klikněte na tlačítko Zobrazit hodnotu .

  3. Chcete-li přidat nový připojovací řetězec, klikněte na Nový připojovací řetězec. Chcete-li upravit připojovací řetězec, klikněte na tlačítko Upravit na pravé straně.

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

  5. Po dokončení klepněte na tlačítko Aktualizovat. Nezapomeňte kliknout na Uložit zpět na stránce Konfigurace .

Hromadné úpravy připojovacích řetězců

Klikněte na tlačítko Upřesnit úpravy . Upravte připojovací řetězce v textové oblasti. Po dokončení klepněte na tlačítko Aktualizovat. Nezapomeňte kliknout na Uložit zpět 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 nastavení zásobníku jazyků

Konfigurace obecných nastavení

V Azure Portal vyhledejte a vyberte App Services a pak vyberte aplikaci. V levé nabídce aplikace vyberteObecné nastaveníkonfigurace>.

Obecná nastavení

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

  • Nastavení zásobníku: Sada softwaru 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ý příkaz Po spuštění nebo spouštěcí příkazový soubor.

    Obecná nastavení pro kontejnery Linuxu

  • Nastavení platformy: Umožňuje nakonfigurovat nastavení pro hostující platformu, včetně následujících:

    • Stav FTP: Povolte jenom FTPS nebo úplně zakažte FTP.

    • Bitness: 32bitová nebo 64bitová. Jenom pro aplikace pro Windows.

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

    • AlwaysOn: Udržuje aplikaci načtenou 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 pro nové požadavky z důvodu doby zahřátí. Pokud je zapnutá funkce AlwaysOn , front-endový nástroj pro vyrovnávání zatížení každých pět minut odešle požadavek GET do kořenového adresáře aplikace. Průběžný příkaz ping zabraňuje uvolnění aplikace.

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

    • 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 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í ARR: V nasazení s více instancemi se ujistěte, že je klient směrován do stejné instance po dobu životnosti relace. Tuto možnost můžete nastavit na Vypnuto pro bezstavové aplikace.
  • 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í.

Konfigurace výchozích dokumentů

Toto nastavení platí jenom pro aplikace pro Windows.

Výchozí dokument je webová stránka, která se zobrazuje na kořenové adrese URL aplikace App Service. Použije se první odpovídající soubor v seznamu. Pokud aplikace používá moduly, které se směrují na základě adresy URL místo obsluhy statického obsahu, není nutné používat výchozí dokumenty.

  1. V Azure Portal vyhledejte a vyberte App Services a pak vyberte aplikaci.

  2. V levé nabídce aplikace vyberteVýchozí dokumentykonfigurace>.

    Výchozí dokumenty

  3. Pokud chcete přidat výchozí dokument, klikněte na Nový dokument. Chcete-li odebrat výchozí dokument, klikněte na tlačítko Odstranit vpravo.

Mapování cesty URL k adresáři

Ve výchozím nastavení App Service aplikaci spustíte z kořenového adresáře kódu aplikace. Některé webové architektury ale nezačínaly v kořenovém adresáři. Například Laravel začíná v podadresáři public. Taková aplikace by byla přístupná například na http://contoso.com/publicadrese , ale obvykle chcete nasměrovat http://contoso.com na public adresář. Pokud je spouštěcí soubor vaší aplikace v jiné složce nebo pokud má vaše úložiště více než jednu aplikaci, můžete upravit nebo přidat virtuální aplikace a adresáře.

  1. V Azure Portal vyhledejte a vyberte App Services a pak vyberte aplikaci.

  2. V levé nabídce aplikace vybertemapování cestkonfigurace>.

  3. Klikněte na Nová virtuální aplikace nebo adresář.

    • Pokud chcete virtuální adresář namapovat na fyzickou cestu, nechte 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ář .

    Zaškrtávací políčko Adresář

  4. Klikněte na OK.

Konfigurace mapování obslužných rutin

U aplikací 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 umožňují přidat vlastní procesory skriptů pro zpracování požadavků na konkrétní přípony souborů.

Přidání vlastní obslužné rutiny:

  1. V Azure Portal vyhledejte a vyberte App Services a pak vyberte aplikaci.

  2. V levé nabídce aplikace vybertemapování cestkonfigurace>.

    Mapování cest

  3. Klepněte na tlačítko 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 skriptů k vám. Požadavky na soubory, které odpovídají příponě souboru, se zpracovávají procesorem skriptů. Pomocí cesty D:\home\site\wwwroot se můžete podívat na kořenový adresář vaší aplikace.
    • Argumenty. Volitelné argumenty příkazového řádku pro procesor skriptu
  4. Klikněte na OK.

Konfigurace vlastních kontejnerů

Další kroky