App Service-alkalmazás konfigurálása

Ez a cikk bemutatja, hogyan konfigurálhatók a webalkalmazások, a mobil háttérrendszer vagy az API-alkalmazások általános beállításai. Az Azure Functions esetében lásd az Azure Functions alkalmazásbeállításokra vonatkozó hivatkozását.

Alkalmazásbeállítások konfigurálása

Feljegyzés

  • Az alkalmazásbeállítások nevei csak betűket, számokat (0-9), pontokat (".") és aláhúzásjeleket ("_") tartalmazhatnak.
  • Az alkalmazásbeállítás értékében szereplő speciális karaktereket szükség szerint meg kell szöknie a cél operációs rendszernek

Ha például beállít egy környezeti változót az App Service Linuxban az alkalmazásbeállítás sztringjének értékével "pa$$w0rd\" : "pa\$\$w0rd\\"

Az App Service-ben az alkalmazásbeállítások környezeti változóként átadott változók az alkalmazáskódnak. Linux-alkalmazások és egyéni tárolók esetén az App Service átadja az alkalmazásbeállításokat a tárolónak a --env jelölővel a tároló környezeti változójának beállításához. Mindkét esetben a rendszer az alkalmazás indításakor injektálja őket az alkalmazáskörnyezetbe. Alkalmazásbeállítások hozzáadásakor, eltávolításakor vagy szerkesztésekor az App Service elindítja az alkalmazás újraindítását.

ASP.NET és ASP.NET Alapvető fejlesztők számára az App Service-ben az alkalmazásbeállítások beállítása olyan, mint a <appSettings>Web.config vagy a appsettings.json, de az App Service értékei felülírják a Web.config vagy appsettings.json értékeit. A fejlesztési beállításokat (például a helyi MySQL-jelszót) a Web.configban, appsettings.json és éles titkos kódokat (például Azure MySQL-adatbázisjelszót) biztonságosan tárolhatja az App Service-ben. Ugyanez a kód a fejlesztési beállításokat használja a helyi hibakereséskor, és az éles titkos kódokat használja az Azure-ban való üzembe helyezéskor.

Más nyelvi veremek is lekérik az alkalmazásbeállításokat környezeti változókként futásidőben. A nyelvi veremre vonatkozó lépésekért lásd:

Az alkalmazásbeállítások mindig titkosítva lesznek tároláskor (inaktív állapotban titkosítva).

Feljegyzés

Az alkalmazásbeállítások a Key Vaultban is feloldhatók Key Vault-hivatkozások használatával.

  1. Az Azure Portalon keresse meg és válassza ki az App Servicest, majd válassza ki az alkalmazást.

    Search for App Services

  2. Az alkalmazás bal oldali menüjében válassza a Konfigurációs>alkalmazás beállításai lehetőséget.

    Application Settings

    Az alkalmazásbeállítások értékei alapértelmezés szerint biztonsági okokból rejtve vannak a portálon. Egy alkalmazásbeállítás rejtett értékének megtekintéséhez válassza ki annak Érték mezőjét. Az összes alkalmazásbeállítás rejtett értékeinek megtekintéséhez válassza az Értékek megjelenítése gombot.

  3. Új alkalmazásbeállítás hozzáadásához válassza az Új alkalmazásbeállítás lehetőséget. Egy beállítás szerkesztéséhez kattintson a jobb oldalon található Szerkesztés gombra.

  4. A párbeszédpanelen a beállítást az aktuális ponthoz ragaszthatja.

    Feljegyzés

    Egy alapértelmezett Linux-alkalmazásszolgáltatásban vagy egy egyéni Linux-tárolóban az alkalmazásbeállítás nevének beágyazott JSON-kulcsstruktúráját úgy ApplicationInsights:InstrumentationKey kell konfigurálni az App Service-ben, mint ApplicationInsights__InstrumentationKey a kulcsnév esetében. Más szóval bármelyiket : fel kell cserélni __ (dupla aláhúzás). Az alkalmazásbeállítás nevének bármely pontját lecseréljük egy _ (egyetlen aláhúzásjel) értékre.

  5. Ha végzett, válassza a Frissítés lehetőséget. Ne felejtse el kiválasztani a Mentés vissza lehetőséget a Konfiguráció lapon.

Alkalmazásbeállítások tömeges szerkesztése

Válassza a Speciális szerkesztés gombot. Szerkessze a szövegterület beállításait. Ha végzett, válassza a Frissítés lehetőséget. Ne felejtse el kiválasztani a Mentés vissza lehetőséget a Konfiguráció lapon.

Az alkalmazásbeállítások a következő JSON-formázással rendelkeznek:

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

Kapcsolati sztringek konfigurálása

Az Azure Portalon keresse meg és válassza ki az App Servicest, majd válassza ki az alkalmazást. Az alkalmazás bal oldali menüjében válassza a Konfigurációs>alkalmazás beállításai lehetőséget.

Application Settings

ASP.NET és ASP.NET Core-fejlesztők esetében az App Service-ben a kapcsolati sztring beállítása olyan, mintha a Web.configban <connectionStrings>állítanák be őket, de az App Service-ben beállított értékek felülírják a Web.configban beállított értékeket. A web.config és az éles titkos kulcsok (például AZ SQL Database hitelesítő adatai) fejlesztési beállításait (például egy adatbázisfájlt) biztonságosan tárolhatja az App Service-ben. Ugyanez a kód a fejlesztési beállításokat használja a helyi hibakereséskor, és az éles titkos kódokat használja az Azure-ban való üzembe helyezéskor.

Más nyelvi veremek esetén célszerű inkább az alkalmazásbeállításokat használni, mert a kapcsolati sztring speciális formázást igényelnek a változókulcsokban az értékek eléréséhez.

Feljegyzés

Előfordulhat, hogy non-.NET nyelvek alkalmazásbeállításai helyett kapcsolati sztring szeretne használni: egyes Azure-adatbázistípusokról csak akkor készít biztonsági másolatot az alkalmazással együtt, ha az App Service-alkalmazásban konfigurál egy kapcsolati sztring az adatbázishoz. További információ: Egyéni biztonsági mentés létrehozása. Ha nincs szüksége erre az automatikus biztonsági mentésre, használja az alkalmazásbeállításokat.

Futásidőben a kapcsolati sztring környezeti változókként érhetők el, az alábbi kapcsolattípusokkal előtaggal:

  • SQLServer: SQLCONNSTR_
  • Mysql: MYSQLCONNSTR_
  • SQLAzure: SQLAZURECONNSTR_
  • Egyéni: CUSTOMCONNSTR_
  • Postgresql: POSTGRESQLCONNSTR_

Feljegyzés

A PostgreSQL-et célzó .NET-alkalmazásoknak egyénire kell állítaniuk a kapcsolati sztring a .NET EnvironmentVariablesConfigurationProvider ismert problémáinak kerülő megoldásaként

Például egy Connectionstring1 nevű MySQL-kapcsolati sztring elérhető környezeti változókéntMYSQLCONNSTR_connectionString1. A nyelvi veremre vonatkozó lépésekért lásd:

Csatlakozás ion sztringek mindig titkosítva vannak tároláskor (inaktív állapotban titkosítva).

Feljegyzés

Csatlakozás ion sztringek a Key Vault key vault-hivatkozásokkal.

  1. Az Azure Portalon keresse meg és válassza ki az App Servicest, majd válassza ki az alkalmazást.

    Search for App Services

  2. Az alkalmazás bal oldali menüjében válassza a Konfigurációs>alkalmazás beállításai lehetőséget.

    Application Settings

    Alapértelmezés szerint a kapcsolati sztring értékei rejtettek a portálon a biztonság érdekében. Egy kapcsolati sztring rejtett értékének megtekintéséhez válassza ki annak Érték mezőjét. Az összes kapcsolati sztring rejtett értékeinek megtekintéséhez válassza az Érték megjelenítése gombot.

  3. Új kapcsolati sztring hozzáadásához válassza az Új kapcsolati sztring lehetőséget. A kapcsolati sztring szerkesztéséhez kattintson a jobb oldalon található Szerkesztés gombra.

  4. A párbeszédpanelen a kapcsolati sztring az aktuális ponthoz ragaszthatja.

  5. Ha végzett, válassza a Frissítés lehetőséget. Ne felejtse el kiválasztani a Mentés vissza lehetőséget a Konfiguráció lapon.

Kapcsolati sztring szerkesztése tömegesen

Válassza a Speciális szerkesztés gombot. Szerkessze a kapcsolati sztring a szövegterületen. Ha végzett, válassza a Frissítés lehetőséget. Ne felejtse el kiválasztani a Mentés vissza lehetőséget a Konfiguráció lapon.

Csatlakozás ion-sztringek a következő JSON-formázást biztosítják:

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

Nyelvi verem beállításainak konfigurálása

Általános beállítások konfigurálása

Az Azure Portalon keresse meg és válassza ki az App Servicest, majd válassza ki az alkalmazást. Az alkalmazás bal oldali menüjében válassza az Általános konfigurációs>beállítások lehetőséget.

General settings

Itt konfigurálhat néhány általános beállítást az alkalmazáshoz. Egyes beállításokhoz magasabb tarifacsomagokra kell skáláznia.

  • Verembeállítások: Az alkalmazás futtatásához használandó szoftververem, beleértve a nyelvet és az SDK-verziókat is.

    Linux-alkalmazások esetén kiválaszthatja a nyelvi futtatókörnyezet verzióját, és beállíthat egy választható indítási parancsot vagy egy indítási parancsfájlt.

    General settings for Linux containers

  • Platformbeállítások: Lehetővé teszi az üzemeltetési platform beállításainak konfigurálását, beleértve a következőket:

    • Platformbitesség: 32 bites vagy 64 bites. Csak Windows-alkalmazások esetén.
    • FTP-állapot: Csak FTPS engedélyezése vagy az FTP letiltása.
    • HTTP-verzió: Állítsa a 2.0-ra a HTTPS/2 protokoll támogatásának engedélyezéséhez.

    Feljegyzés

    A legtöbb modern böngésző csak tLS-en keresztül támogatja a HTTP/2 protokollt, míg a nem titkosított forgalom továbbra is HTTP/1.1-et használ. Annak érdekében, hogy az ügyfélböngészők HTTP/2-vel csatlakozzanak az alkalmazáshoz, gondoskodjon az egyéni DNS-név védelméről. További információ: Egyéni DNS-név védelme TLS-/SSL-kötéssel a Azure-alkalmazás Szolgáltatásban.

    • Webes szoftvercsatornák: Például ASP.NET SignalR vagy socket.io esetén.

    • Always On: Akkor is betölti az alkalmazást, ha nincs forgalom. Ha az Always On nincs bekapcsolva (alapértelmezett), az alkalmazás 20 perc után, bejövő kérések nélkül lesz eltávolítva. A kiürített alkalmazás nagy késést okozhat az új kérések esetében a bemelegítési idő miatt. Ha az Always On be van kapcsolva, az előtérbeli terheléselosztó öt percenként get kérést küld az alkalmazás gyökerének. A folyamatos pingelés megakadályozza az alkalmazás kiürítését.

      A folyamatos WebJobs-feladatokhoz vagy a CRON-kifejezéssel aktivált WebJobs-feladatokhoz az Always On szükséges.

    • ARR affinitás: Többpéldányos üzembe helyezés esetén győződjön meg arról, hogy az ügyfél ugyanarra a példányra van irányítva a munkamenet élettartama során. Ezt a beállítást kikapcsolhatja állapot nélküli alkalmazások esetén.

    • Csak HTTPS: Ha engedélyezve van, az összes HTTP-forgalom https-ra lesz átirányítva.

    • Minimális TLS-verzió: Válassza ki az alkalmazás által igényelt minimális TLS-titkosítási verziót.

  • Hibakeresés: Távoli hibakeresés engedélyezése ASP.NET, ASP.NET Core- vagy Node.js-alkalmazásokhoz. Ez a beállítás 48 óra elteltével automatikusan kikapcsol.

  • Bejövő ügyféltanúsítványok: ügyféltanúsítványok megkövetelése kölcsönös hitelesítésben.

Alapértelmezett dokumentumok konfigurálása

Ez a beállítás csak Windows-alkalmazásokhoz használható.

Az alapértelmezett dokumentum az App Service-alkalmazás gyökér URL-címén megjelenő weblap. A rendszer a listában az első egyező fájlt használja. Ha az alkalmazás statikus tartalom kiszolgálása helyett URL-cím alapján irányított modulokat használ, nincs szükség alapértelmezett dokumentumokra.

  1. Az Azure Portalon keresse meg és válassza ki az App Servicest, majd válassza ki az alkalmazást.

  2. Az alkalmazás bal oldali menüjében válassza az Alapértelmezett konfigurációs dokumentumok lehetőséget>.

    Default documents

  3. Alapértelmezett dokumentum hozzáadásához válassza az Új dokumentum lehetőséget. Az alapértelmezett dokumentum eltávolításához kattintson a Jobb oldali Törlés gombra.

URL-cím leképezése könyvtárhoz

Az App Service alapértelmezés szerint az alkalmazáskód gyökérkönyvtárából indítja el az alkalmazást. Bizonyos webes keretrendszerek azonban nem a gyökérkönyvtárban kezdődnek. A Laravel például a public alkönyvtárban indul. Egy ilyen alkalmazás például elérhető http://contoso.com/publiclenne, de általában inkább a public címtárhoz szeretne irányítanihttp://contoso.com. Ha az alkalmazás indítási fájlja egy másik mappában található, vagy ha az adattár több alkalmazással is rendelkezik, szerkesztheti vagy hozzáadhatja a virtuális alkalmazásokat és könyvtárakat.

Fontos

A fizikai elérésiút-szolgáltatás virtuális könyvtára csak Windows-alkalmazásokban érhető el.

  1. Az Azure Portalon keresse meg és válassza ki az App Servicest, majd válassza ki az alkalmazást.

  2. Az alkalmazás bal oldali menüjében válassza a Konfigurációs>útvonal leképezései lehetőséget

  3. Válassza az Új virtuális alkalmazás vagy könyvtár lehetőséget.

    • Ha egy virtuális könyvtárat fizikai útvonalra szeretne képezni, hagyja bejelölve a Címtár jelölőnégyzetet. Adja meg a virtuális könyvtárat és a webhelygyökér (D:\home) megfelelő relatív (fizikai) elérési útját.
    • Ha webalkalmazásként szeretne megjelölni egy virtuális könyvtárat, törölje a jelet a Címtár jelölőnégyzetből.

    Directory check box

  4. Kattintson az OK gombra.

Kezelőleképezések konfigurálása

Windows-alkalmazások esetén testre szabhatja az IIS kezelőleképezéseit, valamint a virtuális alkalmazásokat és könyvtárakat. A kezelőleképezések lehetővé teszik egyéni szkriptfeldolgozók hozzáadását adott fájlkiterjesztések kéréseinek kezeléséhez.

Egyéni kezelő hozzáadása:

  1. Az Azure Portalon keresse meg és válassza ki az App Servicest, majd válassza ki az alkalmazást.

  2. Az alkalmazás bal oldali menüjében válassza a Konfigurációs>útvonal leképezései lehetőséget.

    Path mappings

  3. Válassza az Új kezelő leképezése lehetőséget. Konfigurálja a kezelőt az alábbiak szerint:

    • Bővítmény. A kezelni kívánt fájlkiterjesztés, például *.php vagy handler.fcgi.
    • Szkriptfeldolgozó. A szkriptfeldolgozó abszolút elérési útja. A fájlkiterjesztésnek megfelelő fájlokra vonatkozó kérelmeket a szkriptfeldolgozó dolgozza fel. Használja az elérési utat D:\home\site\wwwroot az alkalmazás gyökérkönyvtárára való hivatkozáshoz.
    • Argumentumok. A szkriptfeldolgozó nem kötelező parancssori argumentumai.
  4. Kattintson az OK gombra.

Egyéni tárolók konfigurálása

Következő lépések