Set up staging environments in Azure App Service

Amikor a webalkalmazást, a webalkalmazást Linuxon, mobil háttérrendszeren vagy API-alkalmazáson helyezi üzembe a Azure-alkalmazás Service-ben, az alapértelmezett éles pont helyett egy külön üzembe helyezési pontot használhat, amikor a Standard, a Premium vagy az Izolált App Service csomagszinten fut. Az üzembehelyezési pontok saját gazdagépnevekkel rendelkező élő alkalmazások. Az alkalmazástartalom és a konfigurációk elemei felcserélhetők két üzembe helyezési tárhely között az üzemelési pontot is beleértve.

Az alkalmazás nem gyártási ponton való üzembe helyezése a következő előnyökkel jár:

• Az előkészítési üzembehelyezési ponton végrehajtott alkalmazásmódosításokat érvényesítheti, mielőtt felcserélené azokat az éles ponttal.
• Az alkalmazás először egy pontra való üzembe helyezésével, majd az éles környezetbe történő váltásával biztosítható, hogy a pont minden példánya üzemkészen kerüljön az éles környezetbe. Ezzel kiküszöbölhetők az állásidők az alkalmazás üzembe helyezésekor. A forgalom átirányítása zökkenőmentes, és a felcserélési műveletek miatt nem történik kérések elvetése. Ezt a teljes munkafolyamatot automatizálhatja az automatikus felcserélés konfigurálásával, ha nincs szükség előcseréléses ellenőrzésre.
• A felcserélés után a korábban előkészített alkalmazással rendelkező pont már rendelkezik az előző éles alkalmazással. Ha az éles pontra felcserélt módosítások nem a várt módon történnek, azonnal elvégezheti ugyanezt a felcserélést, hogy visszakapja a "legutóbbi ismert jó webhelyet".

Minden App Service-csomagszint különböző számú üzembehelyezési pontot támogat. Az üzembehelyezési pontok használata nem jár külön díjjal. Az alkalmazásszint által támogatott pontok számának megtekintéséhez tekintse meg az App Service korlátait.

Ha az alkalmazást egy másik szintre szeretné skálázni, győződjön meg arról, hogy a célszint támogatja az alkalmazás által már használt tárolóhelyek számát. Ha például az alkalmazás ötnél több tárolóhellyel rendelkezik, nem skálázhatja le a Standard szintre, mert a Standard szint csak öt üzembehelyezési pontot támogat.

Ez a videó bemutatja, hogyan állíthat be átmeneti környezeteket Azure-alkalmazás Szolgáltatásban.

A videó lépéseit a következő szakaszokban is ismertetjük.

Előfeltételek

A kívánt pontművelet végrehajtásához szükséges engedélyekkel kapcsolatban lásd az erőforrás-szolgáltató műveleteit (például pontkeresés).

Tárhely felvétele

Az alkalmazásnak a Standard, a Premium vagy az Izolált szinten kell futnia ahhoz, hogy több üzembehelyezési pontot engedélyezhessen.

az webapp deployment slot create --name <app-name> --resource-group <group-name> --slot <slot-name>

New-AzWebAppSlot -ResourceGroupName <group-name> -Name <app-name> -Slot <slot-name> -AppServicePlan <plan-name>

Az új üzembehelyezési pont nem tartalmaz tartalmat, még akkor sem, ha a beállításokat egy másik pontról klónozza. Közzéteheti például ezt a pontot a Gittel. Egy másik adattárágból vagy egy másik adattárból is üzembe helyezheti a pontot. Szerezze be a közzétételi profilt Azure-alkalmazás szolgáltatásból, amely biztosítja a pontban való üzembe helyezéshez szükséges információkat. A profilt a Visual Studio importálhatja a tartalom pontba való üzembe helyezéséhez.

A pont URL-címe formátuma http://sitename-slotname.azurewebsites.net. Ha az URL-cím hosszát a szükséges DNS-korlátokon belül szeretné tartani, a rendszer 40 karakterből csonkolja a webhely nevét, és az egyesített helynévnek és pontnévnek 59 karakternél kevesebbnek kell lennie.

Mi történik a felcserélés során?

A felcserélési művelet lépései

Ha két tárolóhelyet cserél fel (általában forrásként egy átmeneti pontból az éles pontba célként), az App Service a következőket teszi annak érdekében, hogy a célhely ne tapasztaljon állásidőt:

1. Alkalmazza a következő beállításokat a célhelyről (például az éles pontról) a forráshely összes példányára:

   • Pontspecifikus alkalmazásbeállítások és kapcsolati sztring, ha vannak.
   • Folyamatos üzembe helyezési beállítások, ha engedélyezve van.
   • Az App Service hitelesítési beállításai, ha engedélyezve van.

   Az ilyen esetek bármelyike elindítja a forráshelyen lévő összes példányt az újraindításhoz. Az előzetes verzióval való felcserélés során ez az első fázis végét jelöli. A felcserélési művelet szüneteltetve van, és ellenőrizheti, hogy a forráshely megfelelően működik-e a célhely beállításaival.

2. Várja meg, amíg a forráshely minden példánya befejezi az újraindítást. Ha egy példány nem indul újra, a felcserélési művelet visszaállítja a forráshely összes módosítását, és leállítja a műveletet.

3. Ha a helyi gyorsítótár engedélyezve van, aktiválja a helyi gyorsítótár inicializálását úgy, hogy http-kérést küld a forráshely minden példányán az alkalmazásgyökérnek ("/"). Várjon, amíg minden példány http-választ ad vissza. A helyi gyorsítótár inicializálása minden példányon újraindul.

4. Ha az automatikus felcserélés engedélyezve van az egyéni bemelegítéssel, aktiválja az alkalmazásindítást úgy, hogy http-kérést küld az alkalmazásgyökérnek ("/") a forráshely minden egyes példányán.

   Ha applicationInitialization nincs megadva, http-kérést indíthat el az egyes példányok forráshelyének alkalmazásgyökeréhez.

   Ha egy példány http-választ ad vissza, az bemelegítésnek minősül.

5. Ha a forráshely összes példánya sikeresen felmelegedik, cserélje fel a két pontot a két pont útválasztási szabályainak módosításával. A lépés után a célhely (például az éles pont) rendelkezik a forráshelyen korábban bemelegített alkalmazással.

6. Most, hogy a forráshelyen már szerepel az előcserélés előtti alkalmazás a célhelyen, hajtsa végre ugyanezt a műveletet az összes beállítás alkalmazásával és a példányok újraindításával.

A felcserélési művelet bármely pontján a felcserélt alkalmazások inicializálása a forrásponton történik. A célhely online állapotban marad, miközben a forráspont előkészítése és bemelegedése folyamatban van, függetlenül attól, hogy hol sikeres vagy sikertelen a csere. Ha fel szeretne cserélni egy előkészítési pontot az éles ponttal, győződjön meg arról, hogy az éles pont mindig a célhely. Így a felcserélési művelet nincs hatással az éles alkalmazásra.

Mely beállítások vannak felcserélve?

Ha egy másik üzembehelyezési pontról klónozza a konfigurációt, a klónozott konfiguráció szerkeszthető. Egyes konfigurációelemek a felcserélés tartalmát követik (nem pontspecifikusak), míg a többi konfigurációs elem ugyanabban a pontban marad a felcserélés után (pontspecifikus). Az alábbi listák a pontok felcserélésekor változó beállításokat mutatják be.

felcserélt Gépház:

• Általános beállítások, például keretrendszerverzió, 32/64 bites, webes szoftvercsatornák
• Alkalmazásbeállítások (konfigurálható egy ponthoz való ragaszkodáshoz)
• Csatlakozás ion sztringek (konfigurálhatók úgy, hogy egy ponthoz tartsanak)
• Kezelőleképezések
• Nyilvános tanúsítványok
• WebJobs-tartalom
• Hibrid kapcsolatok *
• Szolgáltatásvégpontok *
• Azure Content Delivery Network *
• Elérésiút-hozzárendelések

A csillaggal (*) jelölt funkciók a tervek szerint nem lesznek leképezve.

Gépház, amelyek nincsenek felcserélve:

• Végpontok közzététele
• Custom domain names
• Nem nyilvános tanúsítványok és TLS/SSL-beállítások
• Méretezési beállítások
• WebJobs-ütemezők
• IP-korlátozások
• Folyamatos üzem
• Diagnosztikai beállítások
• Cross-origin resource sharing (CORS)
• Virtuális hálózat integrációja
• Felügyelt identitások és kapcsolódó beállítások
• Gépház _EXTENSION_VERSION utótaggal végződik
• Gépház által létrehozott Szolgáltatás Csatlakozás or

Ha egy alkalmazásbeállítást szeretne konfigurálni, vagy kapcsolati sztring egy adott ponthoz való ragaszkodáshoz (nem felcserélve), lépjen az adott pont konfigurációs lapjára. Adjon hozzá vagy szerkesszen egy beállítást, majd válassza az üzembehelyezési pont beállításait. Ha bejelöli ezt a jelölőnégyzetet, az App Service azt jelzi, hogy a beállítás nem cserélhető fel.

Két tárolóhely felcserélése

Az üzembehelyezési pontok felcserélhetők az alkalmazás Üzembehelyezési pontok lapján és az Áttekintés lapon. A pontcserére vonatkozó technikai részletekért lásd : Mi történik a felcserélés során.

az webapp deployment slot swap --resource-group <group-name> --name <app-name> --slot <source-slot-name> --target-slot production

Switch-AzWebAppSlot -SourceSlotName "<source-slot-name>" -DestinationSlotName "production" -ResourceGroupName "<group-name>" -Name "<app-name>"

Ha bármilyen problémája van, tekintse meg a csereelhárítók hibaelhárítását.

Felcserélés előzetes verzióval (többfázisú felcserélés)

Mielőtt célhelyként felcseréli az éles környezetbe, ellenőrizze, hogy az alkalmazás a felcserélt beállításokkal fut-e. A forráshelyet a csere befejezése előtt is bemelegíti a rendszer, ami kritikus fontosságú alkalmazások esetében kívánatos.

Ha előzetes verziójú felcserélést hajt végre, az App Service ugyanezt a felcserélési műveletet hajtja végre, de az első lépés után szünetel. Ezután ellenőrizheti az eredményt az előkészítési ponton, mielőtt befejezi a felcserélést.

Ha megszakítja a felcserélést, az App Service újra alkalmazza a konfigurációs elemeket a forráshelyre.

az webapp deployment slot swap --resource-group <group-name> --name <app-name> --slot <source-slot-name> --target-slot production --action preview

az webapp deployment slot swap --resource-group <group-name> --name <app-name> --slot <source-slot-name> --target-slot production --action swap

az webapp deployment slot swap --resource-group <group-name> --name <app-name> --slot <source-slot-name> --target-slot production --action reset

Switch-AzWebAppSlot -SourceSlotName "<source-slot-name>" -DestinationSlotName "production" -ResourceGroupName "<group-name>" -Name "<app-name>" -SwapWithPreviewAction ApplySlotConfig

Switch-AzWebAppSlot -SourceSlotName "<source-slot-name>" -DestinationSlotName "production" -ResourceGroupName "<group-name>" -Name "<app-name>" -SwapWithPreviewAction CompleteSlotSwap

Switch-AzWebAppSlot -SourceSlotName "<source-slot-name>" -DestinationSlotName "production" -ResourceGroupName "<group-name>" -Name "<app-name>" -SwapWithPreviewAction ResetSlotSwap

Ha bármilyen problémája van, tekintse meg a csereelhárítók hibaelhárítását.

Csere visszaállítása

Ha hiba történik a célhelyen (például az éles pontban) egy pontcserét követően, állítsa vissza a réseket a felcserélés előtti állapotukba úgy, hogy azonnal felcseréli ugyanazt a két pontot.

Automatikus felcserélés konfigurálása

Az automatikus felcserélés leegyszerűsíti az Azure DevOps-forgatókönyveket, ahol az alkalmazást folyamatosan szeretné üzembe helyezni nulla hidegindítással és nulla állásidővel az alkalmazás ügyfelei számára. Ha az automatikus felcserélés engedélyezve van egy pontról az éles üzembe helyezésre, minden alkalommal, amikor a kód módosításait erre a pontra küldi, az App Service automatikusan felcseréli az alkalmazást éles környezetbe , miután bemelegedett a forráshelyen.

az webapp deployment slot auto-swap --name <app-name> --resource-group <group-name> --slot <source-slot-name>

az webapp deployment slot auto-swap --name <app-name> --resource-group <group-name> --slot <source-slot-name> --disable

Set-AzWebAppSlot -ResourceGroupName "<group-name>" -Name "<app-name>" -Slot "<source-slot-name>" -AutoSwapSlotName "production"

Ha bármilyen problémája van, tekintse meg a csereelhárítók hibaelhárítását.

Egyéni bemelegítés megadása

Egyes alkalmazások egyéni bemelegítési műveleteket igényelhetnek a felcserélés előtt. A applicationInitialization web.config konfigurációs eleme lehetővé teszi egyéni inicializálási műveletek megadását. A felcserélési művelet megvárja, amíg ez az egyéni bemelegítés befejeződik, mielőtt felcseréli a célhelyet. Íme egy web.config mintatöredék.

<system.webServer>
    <applicationInitialization>
        <add initializationPage="/" hostName="[app hostname]" />
        <add initializationPage="/Home/About" hostName="[app hostname]" />
    </applicationInitialization>
</system.webServer>

Az elem testreszabásával kapcsolatos további információkért tekintse meg az applicationInitialization üzembehelyezési pontok leggyakoribb felcserélési hibáit és azok javítását ismertető témakört.

A bemelegítési viselkedést az alábbi alkalmazásbeállítások egyikével vagy mindkettővel is testre szabhatja:

• WEBSITE_SWAP_WARMUP_PING_PATH: A HTTP-kapcsolaton keresztüli pingelés elérési útja a webhely bemelegítéséhez. Adja hozzá ezt az alkalmazásbeállítást egy egyéni elérési út megadásával, amely egy perjellel kezdődik értékként. Például: /statuscheck. Az alapértelmezett érték /.
• WEBSITE_SWAP_WARMUP_PING_STATUSES: Érvényes HTTP-válaszkódok a bemelegítési művelethez. Adja hozzá ezt az alkalmazásbeállítást a HTTP-kódok vesszővel tagolt listájával. Ilyen például a .200,202 Ha a visszaadott állapotkód nem szerepel a listában, a bemelegítési és felcserélési műveletek leállnak. Alapértelmezés szerint az összes válaszkód érvényes.
• WEBSITE_WARMUP_PATH: Relatív elérési út a webhelyen, amelyet a webhely újraindulásakor (nem csak a pontcserék során) kell pingelni. Példaértékek a következők: /statuscheck vagy a gyökér elérési útja. /

Ha bármilyen problémája van, tekintse meg a csereelhárítók hibaelhárítását.

Felcserélés figyelése

Ha a felcserélési művelet végrehajtása hosszú időt vesz igénybe, a tevékenységnaplóban információkat kaphat a felcserélési műveletről.

az monitor activity-log list --resource-group <group-name> --query "[?contains(operationName.value,'Microsoft.Web/sites/slots/slotsswap/action')]"

Get-AzLog -ResourceGroup <group-name> -StartTime 2023-07-07 | where{$_.OperationName -eq 'Swap Web App Slots'}

Éles forgalom automatikus átirányítása

Alapértelmezés szerint a rendszer az alkalmazás éles URL-címére (http://<app_name>.azurewebsites.net) irányuló összes ügyfélkérést az éles ponthoz irányítja. A forgalom egy részét átirányíthatja egy másik pontra. Ez a funkció akkor hasznos, ha felhasználói visszajelzésre van szüksége egy új frissítéshez, de még nem áll készen arra, hogy éles környezetben kiadja.

az webapp traffic-routing set --resource-group <group-name> --name <app-name> --distribution <slot-name>=15

Add-AzWebAppTrafficRouting -ResourceGroupName "<group-name>" -WebAppName "<app-name>" -RoutingRule @{ActionHostName='<app-name>-<slot-name>.azurewebsites.net';ReroutePercentage='15';Name='<slot-name>'}

Miután az ügyfél automatikusan egy adott ponthoz lett irányítva, a rendszer egy órán keresztül vagy a cookie-k törléséig "rögzítve" lesz az adott pontra. Az ügyfélböngészőben láthatja, hogy a munkamenet melyik pontjára van rögzítve, ha megtekinti a cookie-t a x-ms-routing-name HTTP-fejlécekben. Az "előkészítési" ponthoz irányított kéréshez tartozik a cookie x-ms-routing-name=staging. Az éles ponthoz irányított kéréshez tartozik a cookie x-ms-routing-name=self.

Éles forgalom manuális irányítása

Az automatikus forgalomirányítás mellett az App Service átirányíthatja a kéréseket egy adott pontra. Ez akkor hasznos, ha azt szeretné, hogy a felhasználók a bétaalkalmazást választhassák vagy kikapcsolhassák. Az éles forgalom manuális irányításához használja a lekérdezési x-ms-routing-name paramétert.

Ha például azt szeretné, hogy a felhasználók kikapcsolják a bétaalkalmazást, ezt a hivatkozást elhelyezheti a weblapján:

<a href="<webappname>.azurewebsites.net/?x-ms-routing-name=self">Go back to production app</a>

A sztring x-ms-routing-name=self megadja az éles pontot. Miután az ügyfélböngésző hozzáfér a hivatkozáshoz, a rendszer átirányítja az éles pontra. Minden további kérés rendelkezik azzal a x-ms-routing-name=self cookie-val, amely a munkamenetet az éles ponthoz rögzíti.

Ha lehetővé szeretné tenni a felhasználóknak, hogy a bétaalkalmazást választják, állítsa ugyanazt a lekérdezési paramétert a nem gyártási pont nevére. Példa:

<webappname>.azurewebsites.net/?x-ms-routing-name=staging

Alapértelmezés szerint az új pontokhoz a rendszer a szürke színnel megjelenített útválasztási 0%szabályt adja meg. Ha ezt az értéket 0% explicit módon (fekete szövegben) állítja be, a felhasználók manuálisan férhetnek hozzá az előkészítési ponthoz a x-ms-routing-name lekérdezési paraméter használatával. A rendszer azonban nem irányítja őket automatikusan a ponthoz, mert az útválasztás százalékos értéke 0. Ez egy speciális forgatókönyv, amelyben "elrejtheti" az előkészítési pontot a nyilvánosság elől, miközben a belső csapatok tesztelhetik a módosításokat a ponton.

Pont törlése

az webapp deployment slot delete --name <app-name> --resource-group <group-name> --slot <slot-name>

Remove-AzWebAppSlot -ResourceGroupName "<group-name>" -Name "<app-name>" -Slot "<slot-name>"

Automatizálás Resource Manager-sablonokkal

Az Azure Resource Manager-sablonok deklaratív JSON-fájlok, amelyek az Azure-erőforrások üzembe helyezésének és konfigurálásának automatizálására szolgálnak. Ha Resource Manager-sablonokkal szeretne réseket cserélni, két tulajdonságot kell beállítania a Microsoft.Web/sites/slots és a Microsoft.Web/sites erőforrásokon:

• buildVersion: ez egy sztringtulajdonság, amely a pontban üzembe helyezett alkalmazás aktuális verzióját jelöli. Például: "v1", "1.0.0.1" vagy "2019-09-20T11:53:25.2887393-07:00".
• targetBuildVersion: ez egy sztringtulajdonság, amely meghatározza, hogy milyen buildVersion ponttal kell rendelkeznie. Ha az targetBuildVersion aktuális buildVersionérték nem egyenlő, a felcserélési műveletet úgy indítja el, hogy megkeresi a megadott buildVersionponttal rendelkező pontot .

Példa Resource Manager-sablonra

Az alábbi Resource Manager-sablon két pontot cserél fel a buildVersionstaging pont frissítésével és az targetBuildVersion éles pont beállításával. Feltételezi, hogy létrehozott egy .staging

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "my_site_name": {
            "defaultValue": "SwapAPIDemo",
            "type": "String"
        },
        "sites_buildVersion": {
            "defaultValue": "v1",
            "type": "String"
        }
    },
    "resources": [
        {
            "type": "Microsoft.Web/sites/slots",
            "apiVersion": "2018-02-01",
            "name": "[concat(parameters('my_site_name'), '/staging')]",
            "location": "East US",
            "kind": "app",
            "properties": {
                "buildVersion": "[parameters('sites_buildVersion')]"
            }
        },
        {
            "type": "Microsoft.Web/sites",
            "apiVersion": "2018-02-01",
            "name": "[parameters('my_site_name')]",
            "location": "East US",
            "kind": "app",
            "dependsOn": [
                "[resourceId('Microsoft.Web/sites/slots', parameters('my_site_name'), 'staging')]"
            ],
            "properties": {
                "targetBuildVersion": "[parameters('sites_buildVersion')]"
            }
        }        
    ]
}

Ez a Resource Manager-sablon idempotens, ami azt jelenti, hogy ismétlődően végrehajtható, és a tárolóhelyek azonos állapotát hozza létre. A sablon módosítása nélkül ugyanannak a sablonnak a későbbi futtatásai nem váltanak ki pontcserét, mert a pontok már a kívánt állapotban vannak.

Felcserélések hibaelhárítása

Ha hiba történik egy pontcserélés során, a rendszer a D:\home\LogFiles\eventlog.xml fájlba naplózza. A rendszer az alkalmazásspecifikus hibanaplóban is naplózza.

Íme néhány gyakori felcserélési hiba:

• Az alkalmazás gyökerének küldött HTTP-kérés időzít. A felcserélési művelet minden HTTP-kérelemre 90 másodpercet vár, és legfeljebb ötször próbálkozik újra. Ha az összes újrapróbálkozási művelet túllépi az időkorlátot, a felcserélési művelet leáll.

• A helyi gyorsítótár inicializálása meghiúsulhat, ha az alkalmazás tartalma meghaladja a helyi gyorsítótárhoz megadott helyi lemezkvótát. További információ: Helyi gyorsítótár áttekintése.

• Az egyéni bemelegítés során a HTTP-kérések belsőleg lesznek megkérve (a külső URL-címen való áthaladás nélkül). A Web.config bizonyos URL-átírási szabályaival meghiúsulhatnak. Például a tartománynevek átirányítására vagy a HTTPS kényszerítésére vonatkozó szabályok megakadályozhatják, hogy a bemelegítési kérések elérjék az alkalmazás kódját. A probléma megoldásához módosítsa az átírási szabályokat az alábbi két feltétel hozzáadásával:

  <conditions>
    <add input="{WARMUP_REQUEST}" pattern="1" negate="true" />
    <add input="{REMOTE_ADDR}" pattern="^100?\." negate="true" />
    ...
  </conditions>
  

• Egyéni bemelegítés nélkül az URL-átírási szabályok továbbra is blokkolhatják a HTTP-kéréseket. A probléma megoldásához módosítsa az átírási szabályokat az alábbi feltétel hozzáadásával:

  <conditions>
    <add input="{REMOTE_ADDR}" pattern="^100?\." negate="true" />
    ...
  </conditions>
  

• A pontcserék után előfordulhat, hogy az alkalmazás váratlan újraindítást tapasztal. Ennek az az oka, hogy a felcserélés után a gazdagépnév kötésének konfigurációja megszakad, ami önmagában nem okoz újraindítást. Bizonyos mögöttes tárolási események (például a tárolókötet feladatátvételei) azonban észlelhetik ezeket az eltéréseket, és az összes feldolgozói folyamatot újraindításra kényszeríthetik. Az ilyen típusú újraindítások minimalizálásához állítsa be az alkalmazásbeállítást az WEBSITE_ADD_SITENAME_BINDINGS_IN_APPHOST_CONFIG=1 összes ponton. Ez az alkalmazásbeállítás azonban nem működik a Windows Communication Foundation (WCF) alkalmazásokkal.

További lépések

Nem gyártási pontokhoz való hozzáférés letiltása