App Service-alkalmazás konfigurálása

Ez a cikk bemutatja, hogyan konfigurálhatók a webalkalmazások, a mobil háttérrendszerek 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

Az Azure App Service-ben az alkalmazásbeállítások környezeti változóként átadott változók az alkalmazáskódnak. Az alkalmazásbeállításokra a következő feltételek vonatkoznak:

• Az alkalmazásbeállítás 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 szabadulnia a cél operációs rendszernek.

Ha például egy környezeti változót szeretne beállítani a Linux App Service-ben az értékkel "pa$$w0rd\", az alkalmazásbeállítás sztringjének kell lennie "pa\$\$w0rd\\".

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.

Az ASP.NET és ASP.NET Core fejlesztők számára az alkalmazásbeállítások konfigurálása az App Service-ben olyan, mintha a <appSettings>, a Web.config, vagy a appsettings.json alkalmazásban történne. Az App Service-ben lévő értékek felülírják a Web.config vagy appsettings.json értékeket. A fejlesztési beállításokat, például a helyi MySQL-jelszót, tárolhatja a Web.config vagy a appsettings.json fájlban. Az App Service-ben biztonságosan tárolhatja a gyártási titkokat, például az Azure MySQL adatbázis jelszavát. Ugyanez a kód a fejlesztési beállításokat használja helyi hibakereséskor. A gyártási titkos információkat használja az Azure-ra történő üzembe helyezéskor.

Más nyelvi kötegek futás közben környezeti változókként kapják meg az alkalmazásbeállításokat. A különböző nyelvi készletekre vonatkozó lépésekért lásd a következőket:

• ASP.NET Core
• Jáva
• Node.js
• Piton
• PHP
• Egyedi tárolók

Az alkalmazásbeállítások mindig titkosítva vannak a tárolásukkor (inaktív állapotban titkosítva).

Megjegyzés:

Ha titkos kulcsokat tárol az alkalmazásbeállításokban, fontolja meg az Azure Key Vault-hivatkozások használatát. Ha a titkos kulcsok a háttérerőforrásokhoz való kapcsolódáshoz szükségesek, fontolja meg a biztonságosabb és titkos kulcsokat nem igénylő csatlakozási lehetőségeket. További információ: Biztonságos kapcsolat az Azure-szolgáltatásokhoz és -adatbázisokhoz Azure-alkalmazás Szolgáltatásból.

Azure Portal

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 Beállítások>környezet változói lehetőséget. Ezután válassza az Alkalmazásbeállítások lehetőséget.

   

   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 az Érték csoportban az Érték megjelenítése lehetőséget. Az összes alkalmazásbeállítás rejtett értékeinek megtekintéséhez válassza az Értékek megjelenítése lehetőséget.

   Megjegyzés:

   Ennek a szakasznak az Azure Portalon való megtekintéséhez olvasási/írási felhasználói engedélyek szükségesek. A megfelelő engedélyekkel rendelkező RBAC beépített szerepkörei a Tulajdonos, a Közreműködő és a Webhely-közreműködő. Az Olvasó szerepkör önmagában nem férne hozzá ehhez a laphoz.

3. Új alkalmazásbeállítás hozzáadásához válassza a Hozzáadás lehetőséget. Egy beállítás szerkesztéséhez válassza ki a beállítást.

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

   Megjegyzés:

   Egy alapértelmezett Linux-alkalmazásszolgáltatásban vagy egyéni Linux-tárolóban az alkalmazásbeállítás nevének beágyazott JSON-kulcsstruktúráját másképpen kell konfigurálni a kulcsnévhez. Cserélje le a kettőspontot (:) dupla aláhúzásjelre (__). Cserélje le bármelyik pontot (.) egyetlen aláhúzásjelre (_). Például ApplicationInsights:InstrumentationKey az App Service-ben úgy kell konfigurálni, hogy a kulcs neve legyen ApplicationInsights__InstrumentationKey.

5. Amikor végzett, válassza az Alkalmaz elemet. Ezután válassza az Alkalmaz lehetőséget a Környezeti változók lapon.

Azure CLI

Alkalmazásbeállítás hozzáadása vagy szerkesztése az az webapp konfigurációs alkalmazás beállításainak használatával:

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

Cserélje le <setting-name> a beállítás nevére. Cserélje le <value> a beállításhoz hozzárendelni kívánt értékre.

Az összes beállítást és azok értékeit az alábbi paranccsal jelenítse meg: az webapp config appsettings list:

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

Egy vagy több beállítás eltávolítása az az webapp konfigurációs alkalmazás beállításainak törlésével:

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

Azure PowerShell

Egy vagy több alkalmazásbeállítás beállítása a Set-AzWebApp használatával:

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

Ez a parancsmag az alkalmazásbeállítások teljes készletét lecseréli a megadottakra. Ha meglévő készleten belüli alkalmazásbeállítást szeretne hozzáadni vagy szerkeszteni, a Get-AzWebApp parancsmaggal adja meg a meglévő alkalmazásbeállításokat a bemeneti kivonatoló táblában. Példa:

# Get app configuration
$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Copy app settings to a new hash table
$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

Ha ellenőrizni szeretné, hogy egy alkalmazásbeállítás pontspecifikus-e, használja a Get-AzWebAppSlotConfigName parancsot:

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

Egy vagy több alkalmazásbeállítási pont megadásához használja a Set-AzWebAppSlotConfigName parancsot:

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

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

Azure Portal

1. Válassza a Speciális szerkesztés lehetőséget.
2. Szerkessze a szövegterület beállításait.
3. Ha elkészült, kattintson az OK gombra. Ezután válassza az Alkalmaz lehetőséget a Környezeti változók 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
  },
  ...
]

Azure CLI

Futtassa az az webapp config app settings set parancsot a JSON fájl nevével:

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

Jótanács

A fájlnév idézőjelekkel való körbefuttatása csak a PowerShellben szükséges.

A szükséges fájlformátum a beállítások JSON-tömbje, ahol a pontbeállítási mező nem kötelező. Példa:

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

Az egyszerűség kedvéért mentheti a meglévő beállításokat egy JSON-fájlba az webapp config appsettings lista segítségével.

# Save the settings
az webapp config appsettings list --resource-group <group-name> --name <app-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

Az alkalmazásbeállítások tömegesen nem szerkeszthetők JSON-fájllal az Azure PowerShell-lel.

Kapcsolati sztringek konfigurálása

Ez a szakasz a kapcsolati sztringek konfigurálását ismerteti.

Megjegyzés:

Fontolja meg a biztonságosabb és a kapcsolati titkos kulcsokat nem igénylő csatlakozási lehetőségeket. További információ: Biztonságos kapcsolat az Azure-szolgáltatásokhoz és -adatbázisokhoz Azure-alkalmazás Szolgáltatásból.

Az ASP.NET- és ASP.NET Core-fejlesztők számára a kapcsolati sztringek beállítása az App Service-ben olyan, mint amikor <connectionStrings>-be és Web.config-be állítják be őket. Az App Service-ben beállított értékek felülbírálják a Web.config értékeit. A fejlesztési beállításokat( például egy adatbázisfájlt) megtarthatja a fájlban Web.config. Az App Service-ben biztonságosan tárolhatja a produkciós titkokat, például az SQL adatbázis hitelesítő adatait. Ugyanez a kód a fejlesztési beállításokat használja helyi hibakereséskor. A gyártási titkos információkat használja az Azure-ra történő üzembe helyezéskor.

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

Előfordulhat, hogy kapcsolati sztringeket szeretne használni non-.NET nyelvek alkalmazásbeállításai helyett. 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 sztringet 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 karakterláncok környezeti változókként érhetők el, és az alábbi kapcsolattípusokkal vannak előtagolva:

• SQL Server: SQLCONNSTR_
• MySQL: MYSQLCONNSTR_
• Azure SQL: SQLAZURECONNSTR_
• Egyéni beállítás: CUSTOMCONNSTR_
• PostgreSQL: POSTGRESQLCONNSTR_
• Azure Notification Hubs: NOTIFICATIONHUBCONNSTR_
• Azure Service Bus: SERVICEBUSCONNSTR_
• Azure Event Hubs: EVENTHUBCONNSTR_
• Azure Cosmos DB: DOCDBCONNSTR_
• Redis gyorsítótár: REDISCACHECONNSTR_

Megjegyzés:

A PostgreSQL-t, a Notification Hubsot, a Service Bust, az Event Hubsot, az Azure Cosmos DB-t és a Redis Cache-et megcélzó .NET-alkalmazásoknak a kapcsolati sztringet Custom-ra kell állítaniuk kerülő megoldásként a .NET EnvironmentVariablesConfigurationProvider ismert problémájához.

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

• ASP.NET Core
• Jáva
• Node.js
• Piton
• PHP
• Egyedi tárolók

A kapcsolati sztringek mindig titkosítva vannak a tárolásukkor (inaktív állapotban titkosítva).

Megjegyzés:

A Key Vault kapcsolati sztringjei a Key Vault hivatkozásainak használatával is feloldhatók.

Azure Portal

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 Beállítások>környezet változói lehetőséget. Ezután válassza a Kapcsolati karakterláncokat.

   Alapértelmezés szerint a portálon a kapcsolati karakterláncok értékei a biztonság érdekében rejtettek. Egy kapcsolati sztring rejtett értékének megtekintéséhez válassza az Érték csoportban az Érték megjelenítése lehetőséget. Az összes kapcsolati sztring rejtett értékeinek megtekintéséhez válassza az Értékek megjelenítése lehetőséget.

3. Új kapcsolati sztring hozzáadásához válassza a Hozzáadás lehetőséget. Egy kapcsolati sztring szerkesztéséhez válassza ki azt.

4. A párbeszédpanelen ön a kapcsolati láncot az aktuális helyhez ragaszthatja.

5. Amikor végzett, válassza az Alkalmaz elemet. Ezután válassza az Alkalmaz lehetőséget a Környezeti változók lapon.

Azure CLI

Alkalmazásbeállítás hozzáadása vagy szerkesztése az webapp config connection-string set használatával:

az webapp config connection-string set --resource-group <group-name> --name <app-name> --connection-string-type <type> --settings <string-name>='<value>'

Cserélje le <string-name> a kapcsolati karakterlánc nevére. Cserélje le <value> a kapcsolati sztringhez hozzárendelni kívánt értékre. Az <type> lehetséges értékeivel kapcsolatban, mint például SQLAzure, lásd a CLI-parancsok dokumentációját.

Mutasd meg az összes kapcsolati karakterláncot és azok értékeit az az webapp config connection-string list parancs használatával.

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

Egy vagy több kapcsolati karakterlánc eltávolítása az webapp config connection-string delete használatával:

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

Azure PowerShell

Egy vagy több csatlakozási karakterláncot állíthat be a Set-AzWebApp használatával:

$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

Minden kapcsolati sztring tartalmaz egy nevet (<string-name1>), egy értéket (<connection-string1>) és egy típust. A típus egy numerikus érték, amely a ConnectionStringType enumerátormezők egyikének felel meg. Például az Azure SQL esetében adja meg a következőt: type="2".

Ez a parancsmag a kapcsolati sztringek teljes készletét lecseréli a megadottakra. Ha meglévő készleten belüli alkalmazásbeállítást szeretne hozzáadni vagy szerkeszteni, a Get-AzWebApp parancsmaggal adja meg a meglévő alkalmazásbeállításokat a bemeneti kivonatoló táblában. Példa:

# Get app configuration
$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Copy connection strings to a new hash table
$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

Ha ellenőrizni szeretné, hogy egy kapcsolati sztring pontspecifikus-e, használja a Get-AzWebAppSlotConfigName parancsot:

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

Ha egy vagy több kapcsolat sztringet slot-specifikussá szeretne tenni, használja a Set-AzWebAppSlotConfigName-et.

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

Tömeges kapcsolati karakterláncok szerkesztése

Azure Portal

1. Válassza a Speciális szerkesztés lehetőséget.
2. Szerkessze a kapcsolati karakterláncokat a szövegmezőben.
3. Amikor végzett, válassza az Alkalmaz elemet. Ne felejtse el a Környezeti változók lapon az Alkalmaz lehetőséget is kiválasztani.

A kapcsolati sztringek a következő JSON-formázással rendelkeznek:

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

Azure CLI

Futtassa a webapp config connection-string set parancsot a JSON-fájl nevével:

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

Jótanács

A fájlnév idézőjelekkel való körbefuttatása csak a PowerShellben szükséges.

A szükséges fájlformátum a kapcsolati sztringek JSON-tömbje, ahol a slot beállítási mező nem kötelező. Példa:

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

A kényelem érdekében a meglévő kapcsolati sztringeket mentheti egy JSON fájlba, az az webapp config connection-string list parancs használatával.

# 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

A kapcsolati sztring nem szerkeszthető tömegesen egy JSON-fájl használatával az Azure PowerShell-lel.

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

A nyelvi verem beállításainak konfigurálásához tekintse meg az alábbi erőforrásokat:

• ASP.NET Core
• Jáva
• Node.js
• Piton
• PHP

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

Az általános beállítások konfigurálásához kövesse az előnyben részesített eszközök lépéseit.

Azure Portal

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 Beállítások konfigurációja lehetőséget>. Ezután válassza az Általános beállítások lehetőséget.

   

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: Konfigurálja a szoftververem beállításait az alkalmazás futtatásához, 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.

• Platformbeállítások: Az üzemeltetési platform beállításainak konfigurálása, beleértve a következőket:

  • Platform: Válassza a 32 bites vagy a 64 bites lehetőséget. 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.

    Megjegyzés:

    A legtöbb modern böngésző csak a TLS-en keresztül támogatja a HTTP/2 protokollt. A titkosítatlan 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 biztonságának biztosítása TLS/SSL-kötéssel az App Service-ben.

  • Webes szoftvercsatornák: Konfigurálja például ASP.NET SignalR-hez vagy socket.io.

  • Always On: Kapcsolja be, ha az alkalmazást még akkor is betöltve szeretné tartani, ha nincs forgalom.

    Ha az Always On ki van kapcsolva (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 küld egy kérést GET az alkalmazás gyökerének. A folyamatos pingelés megakadályozza az alkalmazás kikapcsolását.

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

  • Munkamenet-affinitás: Többpéldányos üzembe helyezés esetén győződjön meg arról, hogy az ügyfél ugyanahhoz a példányhoz van irányítva a munkamenet élettartama során. Az opciót Kikapcsolt állásba állíthatja állapot nélküli alkalmazások esetén.

  • Munkamenet-affinitási proxy: Kapcsolja be, ha az alkalmazás fordított proxy mögött található (például az Azure Application Gateway vagy az Azure Front Door), és az alapértelmezett gazdagépnevet használja. A munkamenet-affinitási süti tartománya igazodik a fordított proxyból származó továbbított host névhez.

  • CSAK HTTPS: Engedélyezve van, ha az összes HTTP-forgalmat HTTPS-be szeretné átirányítani.

  • 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.

Azure CLI

Az az webapp konfigurációs készlettel számos általános konfigurálható beállítást megadhat. Az alábbi példa a konfigurálható beállítások egy részhalmazát mutatja be:

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

A meglévő beállítások megjelenítéséhez használja az az webapp config show parancsot.

Azure PowerShell

A Set-AzWebApp használatával számos általános konfigurálható beállítást megadhat. Az alábbi példa a konfigurálható beállítások egy részhalmazát mutatja be:

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

A meglévő beállítások megjelenítéséhez használja a Get-AzWebApp parancsot.

Alapértelmezett dokumentumok konfigurálása

Az alapértelmezett dokumentum az App Service-alkalmazás gyökér URL-címében 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.

Az alapértelmezett dokumentumok konfigurálására szolgáló beállítás csak Windows-alkalmazásokhoz használható.

Azure Portal

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ó lehetőséget. Ezután válassza az Alapértelmezett dokumentumok lehetőséget.
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.

Azure CLI

Adjunk hozzá egy alapértelmezett dokumentumot az az resource update használatával.

az resource update --resource-group <group-name> --resource-type "Microsoft.Web/sites/config" --name <app-name>/config/web --add properties.defaultDocuments <filename>

Azure PowerShell

Alapértelmezett dokumentum hozzáadása az alkalmazás PowerShell-objektumának módosításával:

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

URL-útvonal leképezése egy könyvtárra

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ő lenne http://contoso.com/public, de általában inkább a http://contoso.com könyvtárba szeretné irányítani public. 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.

A virtuális címtár fizikai elérési úthoz való leképezésének funkciója csak Windows-alkalmazásokban érhető el.

Azure Portal

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 Beállítások konfigurációja lehetőséget>. Ezután válassza az Elérési útvonalak lehetőséget.

3. Válassza az Új virtuális alkalmazás vagy könyvtár lehetőséget. Ezután hajtsa végre az alábbi műveletek egyikét:

   • Ha egy virtuális könyvtárat fizikai útvonalra szeretne képezni, hagyja a könyvtárat kijelölve. 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 címtár kijelölését.

   

4. Kattintson az OK gombra. Ezután válassza a Mentés lehetőséget a Konfiguráció lapon.

Azure CLI

Az alábbi példa a gyökérútvonalat / a public alkönyvtárra állítja be, ami Laravel esetében működik. Emellett hozzáad egy második virtuális alkalmazást is az /app2 elérési úthoz. A futtatáshoz hozzon létre egy fájlt json.txt a következő tartalommal:

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

Módosítsa <group-name> és <app-name> elemeket az erőforrásaihoz, majd futtassa a következő parancsot. A parancs futtatásakor vegye figyelembe a feloldó karaktereket. További információ a feloldó karakterekről: Tippek az Azure CLI sikeres használatához.

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

Az alábbi példa a gyökérútvonalat / a public alkönyvtárra állítja be, ami Laravel esetében működik. Emellett hozzáad egy második virtuális alkalmazást is az /app2 elérési úthoz. A futtatáshoz változtassa meg a <group-name> és <app-name> elemeket.

$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

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 Beállítások konfigurációja lehetőséget>. Ezután válassza az Elérési útvonalak lehetőséget.

3. Válassza az Új kezelőtérképezés 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 a handler.fcgi.
   • Szkriptfeldolgozó. A szkriptfeldolgozó abszolút elérési útja számodra. A szkriptfeldolgozó feldolgozza a fájlkiterjesztésnek megfelelő fájlokra irányuló kérelmeket. Használja az elérési utat D:\home\site\wwwroot az alkalmazás gyökérkönyvtárára való hivatkozáshoz.
   • Argumentumok. Nem kötelező parancssori argumentumok a szkriptfeldolgozóhoz.

4. Kattintson az OK gombra. Ezután válassza a Mentés lehetőséget a Konfiguráció lapon.

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

• Egyéni tároló konfigurálása az Azure App Service-hez
• Az Azure Storage csatlakoztatása helyi megosztásként az App Service-ben

Kapcsolódó tartalom

• Környezeti változók és alkalmazásbeállítások az Azure App Service
• Meglévő egyéni tartomány beállítása az Azure App Service-ben
• Átmeneti környezetek beállítása az Azure App Service-ben
• HTTPS engedélyezése egyéni tartományhoz az Azure App Service-ben
• Alkalmazások diagnosztikai célú naplózásának engedélyezése az Azure App Service-ben
• Alkalmazás vertikális felskálázása a Azure-alkalmazás Szolgáltatásban
• Azure App Service-kvóták és riasztások
• Az applicationHost.config beállításainak módosítása az applicationHost.xdt használatával