Alkalmazásfrissítési paraméterek
Ez a cikk az Azure Service Fabric-alkalmazások frissítése során alkalmazott különböző paramétereket ismerteti. Az alkalmazásfrissítési paraméterek szabályozzák a frissítés során alkalmazott időtúllépéseket és állapotellenőrzéseket, és meghatározzák azokat a szabályzatokat, amelyeket a frissítés meghiúsulásakor kell alkalmazni. Az alkalmazásparaméterek az alábbiak használatával történő frissítésre vonatkoznak:
- PowerShell
- Visual Studio
- SFCTL
- REST
Az alkalmazásfrissítések három, felhasználó által kiválasztható frissítési mód egyikével indíthatók el. Minden mód saját alkalmazásparaméterekkel rendelkezik:
- Figyelt
- Nem figyelt automatikus
- Nem figyelt kézikönyv
A vonatkozó kötelező és nem kötelező paramétereket az egyes szakaszokban az alábbiak szerint ismertetjük.
Visual Studio- és PowerShell-paraméterek
A PowerShell használatával végzett Service Fabric-alkalmazásfrissítések a Start-ServiceFabricApplicationUpgrade parancsot használják. A frissítési mód úgy van kiválasztva, hogy átadja a Figyelt, a UnmonitoredAuto vagy a UnmonitoredManual paramétert a Start-ServiceFabricApplicationUpgrade paraméternek.
A Visual Studio Service Fabric alkalmazásfrissítési paraméterei a Visual Studio frissítési beállításai párbeszédpanelen állíthatók be. A Visual Studio frissítési módja a Frissítési mód legördülő listában a Figyelt, a Nem figyeltAuto vagy a Nem figyeltManual értékre van kiválasztva. További információ: Service Fabric-alkalmazás frissítésének konfigurálása a Visual Studióban.
Kötelező paraméterek
| Paraméter | Érvényesség | Description |
|---|---|---|
| ApplicationName | PowerShell | A frissíteni kívánt alkalmazás neve. Példák: fabric:/VisualObjects, fabric:/ClusterMonitor. |
| ApplicationTypeVersion | PowerShell | Annak az alkalmazástípusnak a verziója, amelyet a frissítés megcélz. |
| FailureAction | PowerShell, Visual Studio | Az engedélyezett értékek a visszaállítás, a manuális és az érvénytelen értékek. Kompenzáló művelet, amelyet akkor kell végrehajtani, ha egy figyelt frissítés figyelési szabályzatot vagy az állapotszabályzatok megsértését tapasztalja. A visszaállítás azt adja meg, hogy a frissítés automatikusan visszatér a frissítés előtti verzióra. A Manuális funkció azt jelzi, hogy a frissítés a Nem figyeltManual frissítési módra vált. Az Érvénytelen érték azt jelzi, hogy a hibaművelet érvénytelen. |
| Figyelt | PowerShell | Azt jelzi, hogy a frissítési mód figyelve van. Miután a parancsmag befejezte egy frissítési tartomány frissítését, ha a frissítési tartomány és a fürt állapota megfelel a megadott állapotszabályzatoknak, a Service Fabric frissíti a következő frissítési tartományt. Ha a frissítési tartomány vagy fürt nem felel meg az állapotszabályzatoknak, a frissítés meghiúsul, és a Service Fabric visszaállítja a frissítési tartomány frissítését, vagy a megadott szabályzatnak megfelelően manuális módra vált. Ez az alkalmazásfrissítések ajánlott módja éles környezetben. |
| UpgradeMode | Visual Studio | Az engedélyezett értékek: Monitorozott (alapértelmezett), UnmonitoredAuto vagy UnmonitoredManual. A részletekért tekintse meg az egyes módok PowerShell-paramétereit ismertető cikket. |
| UnmonitoredAuto | PowerShell | Azt jelzi, hogy a frissítési mód nem figyel automatikusan. Miután a Service Fabric frissített egy frissítési tartományt, a Service Fabric az alkalmazás állapotától függetlenül frissíti a következő frissítési tartományt. Ez a mód éles környezetben nem ajánlott, és csak egy alkalmazás fejlesztése során hasznos. |
| UnmonitoredManual | PowerShell | Azt jelzi, hogy a frissítési mód nem figyelt manuális. Miután a Service Fabric frissített egy frissítési tartományt, megvárja a következő frissítési tartomány frissítését a Resume-ServiceFabricApplicationUpgrade parancsmag használatával. |
Választható paraméterek
Az állapotértékelési paraméterek megadása nem kötelező. Ha az állapotértékelési feltételek nincsenek megadva a frissítés indításakor, a Service Fabric az alkalmazáspéldány ApplicationManifest.xml megadott alkalmazásállapot-szabályzatokat használja.
| Paraméter | Érvényesség | Description |
|---|---|---|
| ApplicationParameter | PowerShell, Visual Studio | Megadja az alkalmazásparaméterek felülbírálásait. A PowerShell-alkalmazásparaméterek kivonattáblázat-név/érték párként vannak megadva. Például: @{ "VotingData_MinReplicaSetSize" = "3"; "VotingData_PartitionCount" = "1" }. A Visual Studio alkalmazásparaméterei a Service Fabric-alkalmazás közzététele párbeszédpanel Alkalmazásparaméterek fájl mezőjében adhatók meg. |
| Jóváhagyás | PowerShell | Az engedélyezett értékek : True (Igaz ) és False (Hamis). Megerősítést kér a parancsmag futtatása előtt. |
| ConsiderWarningAsError | PowerShell, Visual Studio | Az engedélyezett értékek : True (Igaz ) és False (Hamis). Az alapértelmezett érték Hamis. A frissítés során az alkalmazás állapotának kiértékelésekor az alkalmazás figyelmeztetési állapoteseményeit kezelje hibákként. Alapértelmezés szerint a Service Fabric nem értékeli ki a figyelmeztetési állapoteseményeket hibáknak (hibáknak), így a frissítés akkor is folytatódhat, ha vannak figyelmeztetési események. |
| DefaultServiceTypeHealthPolicy | PowerShell, Visual Studio | Meghatározza a figyelt frissítéshez használandó alapértelmezett szolgáltatástípus állapotszabályzatát MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices formátumban. Az 5,10,15 például a következő értékeket jelzi: MaxPercentUnhealthyPartitionsPerService = 5, MaxPercentUnhealthyReplicasPerPartition = 10, MaxPercentUnhealthyServices = 15. |
| Force | PowerShell, Visual Studio | Az engedélyezett értékek : True (Igaz ) és False (Hamis). Azt jelzi, hogy a frissítési folyamat kihagyja a figyelmeztető üzenetet, és akkor is kényszeríti a frissítést, ha a verziószám nem változott. Ez hasznos a helyi teszteléshez, de éles környezetben nem ajánlott, mivel a meglévő üzemelő példány eltávolítását igényli, ami leállást és potenciális adatvesztést okoz. |
| ForceRestart | PowerShell, Visual Studio | Ha a szolgáltatáskód frissítése nélkül frissít egy konfigurációt vagy adatcsomagot, a szolgáltatás csak akkor indul újra, ha a ForceRestart tulajdonság Értéke Igaz. A frissítés befejezése után a Service Fabric értesíti a szolgáltatást, hogy elérhető egy új konfigurációs csomag vagy adatcsomag. A módosítások alkalmazásáért a szolgáltatás felelős. Ha szükséges, a szolgáltatás újraindulhat. |
| HealthCheckRetryTimeoutSec | PowerShell, Visual Studio | Az az időtartam (másodpercben), ameddig a Service Fabric továbbra is állapotértékelést végez a frissítés sikertelenként való deklarálása előtt. Az alapértelmezett érték 600 másodperc. Ez az időtartam a HealthCheckWaitDurationSec elérése után kezdődik. Ebben a HealthCheckRetryTimeoutban a Service Fabric több állapotellenőrzést is végrehajthat az alkalmazás állapotán. Az alapértelmezett érték 10 perc, és az alkalmazásnak megfelelően kell testre szabni. |
| HealthCheckStableDurationSec | PowerShell, Visual Studio | Az alkalmazás stabil állapotának ellenőrzéséhez szükséges időtartam (másodpercben), mielőtt továbblépne a következő frissítési tartományra, vagy befejezené a frissítést. Ez a várakozási időtartam közvetlenül az állapot-ellenőrzés végrehajtása után megakadályozza az állapot nem észlelt változásait. Az alapértelmezett érték 120 másodperc, és az alkalmazásnak megfelelően kell testre szabni. |
| HealthCheckWaitDurationSec | PowerShell, Visual Studio | A frissítés befejezése után (másodpercben) várandó idő a frissítési tartományon, mielőtt a Service Fabric kiértékeli az alkalmazás állapotát. Ezt az időtartamot úgy is tekinthetjük, hogy az alkalmazásnak futnia kell ahhoz, hogy kifogástalan állapotúnak lehessen tekinteni. Ha az állapot-ellenőrzés sikeres, a frissítési folyamat a következő frissítési tartományra folytatódik. Ha az állapot-ellenőrzés sikertelen, a Service Fabric megvárja az UpgradeHealthCheckInterval műveletet, mielőtt újra megkísérlené az állapot-ellenőrzést, amíg el nem éri a HealthCheckRetryTimeoutSec értéket. Az alapértelmezett és ajánlott érték 0 másodperc. |
| MaxPercentUnhealthyDeployedApplications | PowerShell, Visual Studio | Az alapértelmezett és ajánlott érték 0. Adja meg az üzembe helyezett alkalmazások maximális számát (lásd az Állapot szakaszt), amely nem megfelelő állapotú lehet, mielőtt az alkalmazás nem megfelelő állapotúnak minősül, és meghiúsul a frissítés. Ez a paraméter határozza meg az alkalmazás állapotát a csomóponton, és segít észlelni a problémákat a frissítés során. Az alkalmazás replikái általában terheléselosztást kapnak a másik csomóponton, ami lehetővé teszi, hogy az alkalmazás kifogástalan állapotúnak tűnjön, így lehetővé téve a frissítés folytatását. A Szigorú MaxPercentUnhealthyDeployedApplications állapot megadásával a Service Fabric gyorsan észleli az alkalmazáscsomaggal kapcsolatos problémát, és segít a sikertelen gyors frissítésben. |
| MaxPercentUnhealthyServices | PowerShell, Visual Studio | A DefaultServiceTypeHealthPolicy és a ServiceTypeHealthPolicyMap paraméter. Az alapértelmezett és ajánlott érték 0. Adja meg az alkalmazáspéldány azon szolgáltatásainak maximális számát, amelyek nem megfelelő állapotúak lehetnek, mielőtt az alkalmazás nem megfelelő állapotúnak minősül, és meghiúsul a frissítés. |
| MaxPercentUnhealthyPartitionsPerService | PowerShell, Visual Studio | A DefaultServiceTypeHealthPolicy és a ServiceTypeHealthPolicyMap paraméter. Az alapértelmezett és ajánlott érték 0. Adja meg a szolgáltatás azon partícióinak maximális számát, amelyek nem kifogástalan állapotúak lehetnek, mielőtt a szolgáltatás nem megfelelő állapotúnak minősül. |
| MaxPercentUnhealthyReplicasPerPartition | PowerShell, Visual Studio | A DefaultServiceTypeHealthPolicy és a ServiceTypeHealthPolicyMap paraméter. Az alapértelmezett és ajánlott érték 0. Adja meg, hogy a partíción legfeljebb hány replika lehet nem megfelelő állapotú, mielőtt a partíció nem megfelelő állapotúnak minősül. |
| ServiceTypeHealthPolicyMap | PowerShell, Visual Studio | A szolgáltatástípushoz tartozó szolgáltatások állapotának kiértékeléséhez használt állapotszabályzatot jelöli. A kivonattábla bemenete a következő formátumban történik: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"} Például: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" } |
| TimeoutSec | PowerShell , Visual Studio | A művelet időtúllépési időtartamát adja meg másodpercben. |
| UpgradeDomainTimeoutSec | PowerShell, Visual Studio | Egyetlen frissítési tartomány frissítésének maximális ideje (másodpercben). Ha eléri ezt az időtúllépést, a frissítés leáll, és a FailureAction beállítás alapján folytatódik. Az alapértelmezett érték soha nem (Végtelen), és az alkalmazásnak megfelelően kell testre szabni. |
| UpgradeReplicaSetCheckTimeoutSec | PowerShell, Visual Studio | Másodpercben mérve. Állapot nélküli szolgáltatás – Egyetlen frissítési tartományon belül a Service Fabric megpróbálja biztosítani, hogy a szolgáltatás további példányai is elérhetők legyenek. Ha a célpéldányok száma egynél több, a Service Fabric egynél több példány elérhetőségét várja, legfeljebb egy maximális időtúllépési értékig. Ezt az időtúllépést az UpgradeReplicaSetCheckTimeoutSec tulajdonság használatával lehet megadni. Ha az időkorlát lejár, a Service Fabric a szolgáltatáspéldányok számától függetlenül folytatja a frissítést. Ha a célpéldányok száma egy, a Service Fabric nem vár, és azonnal folytatja a frissítést. Állapotalapú szolgáltatás – Egyetlen frissítési tartományon belül a Service Fabric megpróbálja biztosítani, hogy a replikakészlet kvórummal rendelkezzen. A Service Fabric megvárja, amíg a kvórum elérhető lesz, legfeljebb egy maximális időtúllépési értékig (amelyet az UpgradeReplicaSetCheckTimeoutSec tulajdonság határoz meg). Ha az időkorlát lejár, a Service Fabric a kvórumtól függetlenül folytatja a frissítést. Ez a beállítás soha (végtelen) értékre van állítva előregördüléskor, és 1200 másodperc a visszagördüléskor. |
| UpgradeTimeoutSec | PowerShell, Visual Studio | Időtúllépés (másodpercben), amely a teljes frissítésre vonatkozik. Ha eléri ezt az időtúllépést, a frissítés leáll, és a FailureAction aktiválódik. Az alapértelmezett érték soha nem (Végtelen), és az alkalmazásnak megfelelően kell testre szabni. |
| WhatIf | PowerShell | Az engedélyezett értékek : True (Igaz ) és False (Hamis). Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut. |
A MaxPercentUnhealthyServices, a MaxPercentUnhealthyPartitionsPerService és a MaxPercentUnhealthyReplicasPerPartition feltétel szolgáltatástípusonként adható meg egy alkalmazáspéldányhoz. Ezeknek a paramétereknek a szolgáltatásonkénti beállítása lehetővé teszi, hogy az alkalmazások különböző, különböző kiértékelési szabályzatokkal rendelkező szolgáltatástípusokat tartalmazzanak. Az állapot nélküli átjárószolgáltatás típusa lehet például egy MaxPercentUnhealthyPartitionsPerService , amely eltér egy adott alkalmazáspéldány állapotalapú motorszolgáltatás-típusától.
SFCTL-paraméterek
A Service Fabric cli-vel végzett Service Fabric-alkalmazásfrissítések az sfctl alkalmazásfrissítési parancsot, valamint az alábbi kötelező és nem kötelező paramétereket használják.
Kötelező paraméterek
| Paraméter | Leírás |
|---|---|
| alkalmazásazonosító | A frissíteni kívánt alkalmazás azonosítója. Ez általában az alkalmazás teljes neve a "fabric:" URI séma nélkül. A 6.0-s verziótól kezdődően a hierarchikus nevek "~" karakterrel vannak elválasztva. Ha például az alkalmazás neve "fabric:/myapp/app1", akkor az alkalmazás identitása a "myapp~app1" lesz a 6.0-s vagy újabb verziókban, a "myapp/app1" pedig a korábbi verziókban. |
| alkalmazásverzió | Annak az alkalmazástípusnak a verziója, amelyet a frissítés megcélz. |
| parameters | Az alkalmazásfrissítéskor alkalmazandó alkalmazásparaméter-felülbírálások JSON-kódolású listája. |
Választható paraméterek
| Paraméter | Leírás |
|---|---|
| default-service-health-policy | A szolgáltatástípus állapotának kiértékeléséhez alapértelmezés szerint használt állapotházirend JSON-kódolású specifikációja. A térkép alapértelmezés szerint üres. |
| hibaművelet | Az engedélyezett értékek a visszaállítás, a manuális és az érvénytelen értékek. Kompenzáló művelet, amelyet akkor kell végrehajtani, ha egy figyelt frissítés figyelési szabályzatot vagy az állapotszabályzatok megsértését tapasztalja. A visszaállítás azt adja meg, hogy a frissítés automatikusan visszatér a frissítés előtti verzióra. A Manuális funkció azt jelzi, hogy a frissítés a Nem figyeltManual frissítési módra vált. Az Érvénytelen érték azt jelzi, hogy a hibaművelet érvénytelen. |
| kényszerített újraindítás | Ha a szolgáltatáskód frissítése nélkül frissít egy konfigurációt vagy adatcsomagot, a szolgáltatás csak akkor indul újra, ha a ForceRestart tulajdonság Értéke Igaz. A frissítés befejezése után a Service Fabric értesíti a szolgáltatást arról, hogy elérhető egy új konfigurációs csomag vagy adatcsomag. A módosítások alkalmazásáért a szolgáltatás felel. Szükség esetén a szolgáltatás újraindulhat. |
| health-check-retry-timeout | Az állapotértékelés újrapróbálásához szükséges idő, amikor az alkalmazás vagy a fürt állapota nem megfelelő a FailureAction végrehajtása előtt. Először egy ISO 8601-időtartamot képviselő sztringként értelmezik. Ha ez nem sikerül, akkor a rendszer az ezredmásodpercek teljes számát képviselő számként értelmezi. Alapértelmezett: PT0H10M0S. |
| állapot-ellenőrzés-stabil-időtartam | Az az idő, amely alatt az alkalmazásnak vagy a fürtnek kifogástalan állapotban kell maradnia, mielőtt a frissítés a következő frissítési tartományra lép. Először egy ISO 8601-időtartamot képviselő sztringként értelmezik. Ha ez nem sikerül, akkor a rendszer az ezredmásodpercek teljes számát képviselő számként értelmezi. Alapértelmezett: PT0H2M0S. |
| állapot-ellenőrzés-várakozás időtartama | Az állapotszabályzatok alkalmazása előtt a frissítési tartomány befejezése után várakozó idő. Először egy ISO 8601-időtartamot képviselő sztringként értelmezik. Ha ez nem sikerül, akkor a rendszer az ezredmásodpercek teljes számát képviselő számként értelmezi. Alapértelmezett: 0. |
| max-unhealthy-apps | Az alapértelmezett és ajánlott érték a 0. Adja meg az üzembe helyezett alkalmazások maximális számát (lásd az Állapot szakaszt), amely nem megfelelő állapotú lehet, mielőtt az alkalmazás nem megfelelő állapotúnak minősül, és nem sikerül a frissítés. Ez a paraméter meghatározza az alkalmazás állapotát a csomóponton, és segít észlelni a frissítések során felmerülő problémákat. Az alkalmazás replikái általában terheléselosztást kapnak a másik csomóponton, ami lehetővé teszi, hogy az alkalmazás kifogástalan állapotúnak tűnjön, így lehetővé téve a frissítés folytatását. Az alkalmazások szigorú maximális állapotának megadásával a Service Fabric gyorsan észleli az alkalmazáscsomaggal kapcsolatos problémát, és segít a sikertelen gyors frissítésben. 0 és 100 közötti számként jelölve. |
| mód | Engedélyezett értékek: Monitorozott, UpgradeMode, UnmonitoredAuto, UnmonitoredManual. Az alapértelmezett érték a UnmonitoredAuto. Az értékek leírását a Visual Studio és a PowerShell Kötelező paraméterek szakaszában találja. |
| replica-set-check-timeout | Másodpercben mérve. Állapot nélküli szolgáltatás – Egyetlen frissítési tartományban a Service Fabric megpróbálja biztosítani, hogy a szolgáltatás további példányai is elérhetők legyenek. Ha a célpéldányok száma egynél több, a Service Fabric egynél több példány elérhetőségét várja, legfeljebb egy maximális időtúllépési értékig. Ezt az időtúllépést a replica-set-check-timeout tulajdonság használatával adhatja meg. Ha az időtúllépés lejár, a Service Fabric a szolgáltatáspéldányok számától függetlenül folytatja a frissítést. Ha a célpéldányok száma egy, a Service Fabric nem vár, és azonnal folytatja a frissítést. Állapotalapú szolgáltatás – Egyetlen frissítési tartományon belül a Service Fabric megpróbálja biztosítani, hogy a replikakészlet kvórummal rendelkezzen. A Service Fabric megvárja, amíg a kvórum elérhető lesz, legfeljebb egy maximális időtúllépési értékig (amelyet a replica-set-check-timeout tulajdonság határoz meg). Ha az időkorlát lejár, a Service Fabric a kvórumtól függetlenül folytatja a frissítést. Ez a beállítás soha (végtelen) értékre van állítva előregördüléskor, és 1200 másodperc a visszagördüléskor. |
| service-health-policy | JSON-kódolású térkép szolgáltatástípus-állapotszabályzattal szolgáltatástípusonként. A térkép alapértelmezés szerint üres. Paraméter JSON-formátuma. Az "Érték" rész JSON-értéke tartalmazza a MaxPercentUnhealthyServices, a MaxPercentUnhealthyPartitionsPerService és a MaxPercentUnhealthyReplicasPerPartition értéket. A paraméterek leírását a Visual Studio és a PowerShell Opcionális paraméterek szakaszában találja. |
| timeout | A művelet időtúllépési időtartamát adja meg másodpercben. Alapértelmezett: 60. |
| upgrade-domain-timeout | Az egyes frissítési tartományoknak a FailureAction végrehajtása előtt le kell fejeződniük. Először egy ISO 8601-időtartamot képviselő sztringként értelmezik. Ha ez nem sikerül, akkor a rendszer az ezredmásodpercek teljes számát képviselő számként értelmezi. Az alapértelmezett érték soha nem (Végtelen), és az alkalmazásnak megfelelően kell testre szabni. Alapértelmezett: P10675199DT02H48M05.4775807S. |
| frissítési időtúllépés | Az egyes frissítési tartományoknak a FailureAction végrehajtása előtt le kell fejeződniük. Először egy ISO 8601-időtartamot képviselő sztringként értelmezik. Ha ez nem sikerül, akkor a rendszer az ezredmásodpercek teljes számát képviselő számként értelmezi. Az alapértelmezett érték soha nem (Végtelen), és az alkalmazásnak megfelelően kell testre szabni. Alapértelmezett: P10675199DT02H48M05.4775807S. |
| figyelmeztetés hibaként | Az engedélyezett értékek : True (Igaz ) és False (Hamis). Az alapértelmezett érték Hamis. Jelölőként átadható. Az alkalmazás figyelmeztetési állapoteseményeit a frissítés során az alkalmazás állapotának értékelésekor hibákként kezelje. Alapértelmezés szerint a Service Fabric nem értékeli ki a figyelmeztetési állapoteseményeket hibáknak (hibáknak), így a frissítés akkor is folytatódhat, ha vannak figyelmeztetési események. |
Következő lépések
Az alkalmazás Visual Studio használatával történő frissítése végigvezeti a Visual Studióval végzett alkalmazásfrissítésen.
Az alkalmazás PowerShell-lel történő frissítése végigvezeti a PowerShell használatával végzett alkalmazásfrissítésen.
Az alkalmazás linuxos Service Fabric CLI-vel történő frissítése végigvezeti önt egy alkalmazásfrissítésen a Service Fabric CLI használatával.
Az alkalmazás frissítése a Service Fabric Eclipse beépülő modullal
Az adatszializálás használatának elsajátításával kompatibilissé teheti az alkalmazásfrissítéseket.
A speciális témakörökre hivatkozva megtudhatja, hogyan használhatja a speciális funkciókat az alkalmazás frissítése során.
Az alkalmazásfrissítések gyakori problémáinak megoldásához kövesse az alkalmazásfrissítések hibaelhárítása című témakör lépéseit.