Megosztás a következőn keresztül:


sfctl-alkalmazás

Alkalmazások és alkalmazástípusok létrehozása, törlése és kezelése.

Parancsok

Parancs Leírás
create Létrehoz egy Service Fabric-alkalmazást a megadott leírás használatával.
delete Töröl egy meglévő Service Fabric-alkalmazást.
Telepített Lekéri a Service Fabric-csomóponton üzembe helyezett alkalmazás adatait.
üzembe helyezett állapot Lekéri egy Service Fabric-csomóponton üzembe helyezett alkalmazás állapotával kapcsolatos információkat.
üzembe helyezett lista Lekéri a Service Fabric-csomóponton üzembe helyezett alkalmazások listáját.
Egészségügyi Lekéri a Service Fabric-alkalmazás állapotát.
Info Információt kér le egy Service Fabric-alkalmazásról.
list Lekéri a Service Fabric-fürtben létrehozott, a megadott szűrőknek megfelelő alkalmazások listáját.
betöltés Beolvassa a Service Fabric-alkalmazás betöltési adatait.
manifest Lekéri az alkalmazástípust leíró jegyzékfájlt.
Rendelkezés Kiépít vagy regisztrál egy Service Fabric-alkalmazástípust a fürtben a ".sfpkg" csomag használatával a külső tárolóban vagy az alkalmazáscsomag használatával a lemezképtárolóban.
report-health Állapotjelentést küld a Service Fabric-alkalmazásról.
típus Lekéri a Service Fabric-fürt azon alkalmazástípusainak listáját, amelyek pontosan megfelelnek a megadott névnek.
típuslista Lekéri a Service Fabric-fürt alkalmazástípusainak listáját.
leépítés megszüntetése Eltávolítja vagy törli a Service Fabric-alkalmazástípus regisztrációját a fürtből.
frissítés Megkezdi egy alkalmazás frissítését a Service Fabric-fürtben.
frissítés folytatása Folytatja egy alkalmazás frissítését a Service Fabric-fürtben.
frissítés-visszaállítás Megkezdi egy alkalmazás folyamatban lévő frissítésének visszaállítását a Service Fabric-fürtben.
frissítés állapota Lekéri az alkalmazáson végrehajtott legújabb frissítés részleteit.
feltöltés Másolja a Service Fabric-alkalmazáscsomagot a képtárolóba.

sfctl-alkalmazás létrehozása

Létrehoz egy Service Fabric-alkalmazást a megadott leírás használatával.

Argumentumok

Argumentum Description
--app-name [Kötelező] Az alkalmazás neve, beleértve a "fabric:" URI sémát.
--app-type [Kötelező] Az alkalmazásjegyzékben található alkalmazástípus neve.
--app-version [Kötelező] Az alkalmazástípus verziója az alkalmazásjegyzékben meghatározottak szerint.
--max-node-count Azon csomópontok maximális száma, ahol a Service Fabric kapacitást foglal le ehhez az alkalmazáshoz. Vegye figyelembe, hogy ez nem jelenti azt, hogy az alkalmazás szolgáltatásai az összes csomópontra kerülnek.
--Mutatókat Az alkalmazáskapacitás metrikáinak JSON-kódolt listája. A metrika névként van definiálva, és minden olyan csomópont kapacitáskészletéhez van társítva, amelyen az alkalmazás létezik.
--min-node-count Azon csomópontok minimális száma, ahol a Service Fabric kapacitást foglal le ehhez az alkalmazáshoz. Vegye figyelembe, hogy ez nem jelenti azt, hogy az alkalmazás szolgáltatásai az összes csomópontra kerülnek.
--Paraméterek Az alkalmazás létrehozásakor alkalmazandó alkalmazásparaméter-felülbírálások JSON-kódolású listája.
--timeout -t Alapértelmezett: 60.

Globális argumentumok

Argumentum Description
--Debug Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
--output -o Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json.
--Lekérdezés JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ : .
--Részletes Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

sfctl-alkalmazás törlése

Töröl egy meglévő Service Fabric-alkalmazást.

A törlés előtt létre kell hozni egy alkalmazást. Ha töröl egy alkalmazást, azzal törli az alkalmazás részét képező összes szolgáltatást. Alapértelmezés szerint a Service Fabric megpróbálja szabályos módon bezárni a szolgáltatásreplikákat, majd törölni a szolgáltatást. Ha azonban egy szolgáltatás problémákat tapasztal a replika szabályos bezárásakor, a törlési művelet hosszabb időt vehet igénybe, vagy elakadhat. A választható ForceRemove jelzővel kihagyhatja a kecses bezárássorozatot, és kényszerített módon törölheti az alkalmazást és annak összes szolgáltatását.

Argumentumok

Argumentum Description
--application-id [Kötelező] Az alkalmazás identitása. Ez általában az alkalmazás teljes neve a "háló:" URI-séma nélkül. A 6.0-s verziótól kezdve a hierarchikus nevek a "~" 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.
--force-remove Távolítsa el a Service Fabric-alkalmazásokat vagy -szolgáltatásokat erőteljesen anélkül, hogy végigmenne a kecses leállítási sorrenden. Ez a paraméter egy olyan alkalmazás vagy szolgáltatás kényszerített törlésére használható, amelynek törlése a szolgáltatáskód azon hibái miatt, amelyek megakadályozzák a replikák kecses bezárását.
--timeout -t A kiszolgáló időtúllépése a művelet másodpercben történő végrehajtásához. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60.

Globális argumentumok

Argumentum Description
--Debug Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
--output -o Kimeneti formátum. Engedélyezett értékek: json, jsonc, table, tsv. Alapértelmezett: json.
--Lekérdezés JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
--Részletes A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

üzembe helyezett sfctl-alkalmazás

Lekéri a Service Fabric-csomóponton üzembe helyezett alkalmazás adatait.

Ez a lekérdezés a rendszeralkalmazás adatait adja vissza, ha a megadott alkalmazásazonosító a rendszeralkalmazáshoz tartozik. Az eredmények közé tartoznak az aktív, aktiválási és letöltési állapotban üzembe helyezett alkalmazások. Ehhez a lekérdezéshez a csomópont nevének meg kell felelnie a fürt egyik csomópontjának. A lekérdezés meghiúsul, ha a megadott csomópontnév nem mutat a fürt aktív Service Fabric-csomópontjaira.

Argumentumok

Argumentum Description
--application-id [Kötelező] Az alkalmazás identitása. Ez általában az alkalmazás teljes neve a "háló:" URI-séma nélkül. A 6.0-s verziótól kezdve a hierarchikus nevek a "~" 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.
--node-name [Kötelező] A csomópont neve.
--include-health-state Adja meg egy entitás állapotának állapotát. Ha ez a paraméter hamis vagy nincs megadva, akkor a visszaadott állapot "Ismeretlen". Ha igaz értékre van állítva, a lekérdezés párhuzamosan halad a csomóponttal és az állapotrendszer-szolgáltatással az eredmények egyesítése előtt. Ennek eredményeképpen a lekérdezés drágább, és hosszabb időt vehet igénybe.
--timeout -t A kiszolgáló időtúllépése a művelet másodpercben történő végrehajtásához. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60.

Globális argumentumok

Argumentum Description
--Debug Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
--output -o Kimeneti formátum. Engedélyezett értékek: json, jsonc, table, tsv. Alapértelmezett: json.
--Lekérdezés JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
--Részletes A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

sfctl-alkalmazás üzembe helyezett állapota

Lekéri egy Service Fabric-csomóponton üzembe helyezett alkalmazás állapotával kapcsolatos információkat.

Lekéri egy Service Fabric-csomóponton üzembe helyezett alkalmazás állapotával kapcsolatos információkat. Az EventsHealthStateFilter használatával igény szerint szűrhet az üzembe helyezett alkalmazásban az állapot alapján jelentett HealthEvent-objektumok gyűjteményére. Az DeployedServicePackagesHealthStateFilter használatával igény szerint szűrhet az DeployedServicePackageHealth gyermekekre az állapot alapján.

Argumentumok

Argumentum Description
--application-id [Kötelező] Az alkalmazás identitása. Ez általában az alkalmazás teljes neve a "háló:" URI-séma nélkül. A 6.0-s verziótól kezdve a hierarchikus nevek a "~" 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.
--node-name [Kötelező] A csomópont neve.
--deployed-service-packages-health-state-filter Lehetővé teszi az üzembe helyezett szolgáltatáscsomag állapotobjektumainak szűrését, amelyeket az üzembe helyezett alkalmazásállapot-lekérdezés eredményeként ad vissza az állapotuk alapján. A paraméter lehetséges értékei közé tartozik az alábbi állapotok egyikének egész értéke. A rendszer csak a szűrőnek megfelelő üzembe helyezett szolgáltatáscsomagokat adja vissza. Az összes üzembe helyezett szolgáltatáscsomag az üzembe helyezett alkalmazás összesített állapotának kiértékelésére szolgál. Ha nincs megadva, a rendszer minden bejegyzést visszaad. Az állapotértékek jelzőalapú számbavételt jelentenek, így az érték az értékek kombinációja lehet, amelyet a bitenkénti "OR" operátorral szerezhetünk be. Ha például a megadott érték 6, akkor a rendszer az OK (2) és a Figyelmeztetés (4) Állapotértékkel rendelkező szolgáltatáscsomagok állapotát adja vissza.
- Alapértelmezett – Alapértelmezett érték. Bármely HealthState-nak megfelel. Az érték nulla.
- Nincs – Olyan szűrő, amely nem felel meg a HealthState értéknek. Egy adott állapotgyűjtemény eredményeinek visszaadására szolgál. Az érték 1.
- Ok – Szűrő, amely megfelel a bemenetnek a HealthState ok értékével. Az érték 2.
- Figyelmeztetés – Olyan szűrő, amely megfelel a bemenetnek a HealthState Warning értékkel. Az érték 4.
- Hiba – Olyan szűrő, amely megfelel a HealthState error értéknek. Az érték 8.
- Mind – Olyan szűrő, amely megfelel a bemenetnek bármely HealthState értékkel. Az érték 65535.
--events-health-state-filter Lehetővé teszi az állapot alapján visszaadott HealthEvent objektumok gyűjteményének szűrését. A paraméter lehetséges értékei közé tartozik az alábbi állapotok egyikének egész értéke. A rendszer csak a szűrőnek megfelelő eseményeket adja vissza. Az összes esemény az összesített állapot kiértékelésére szolgál. Ha nincs megadva, a rendszer az összes bejegyzést visszaadja. Az állapotértékek jelzőalapú számbavételek, ezért az érték az értékek kombinációja lehet, amelyet a bitenkénti "OR" operátorral kapunk. Ha például a megadott érték 6, akkor a rendszer az OK (2) és a Figyelmeztetés (4) állapotértékkel rendelkező összes eseményt visszaadja.
- Alapértelmezett – Alapértelmezett érték. Bármely HealthState-ra illeszkedik. Az érték nulla.
- Nincs – Olyan szűrő, amely nem felel meg a HealthState értéknek. Egy adott állapotgyűjtemény eredményének visszaadására szolgál. Az érték 1.
- Ok – Szűrő, amely megfelel a bemenetnek a HealthState ok értékével. Az érték 2.
- Figyelmeztetés – Olyan szűrő, amely megfelel a bemenetnek a HealthState Warning értékkel. Az érték 4.
- Hiba – Olyan szűrő, amely megfelel a HealthState error értéknek. Az érték 8.
- Mind – Olyan szűrő, amely megfelel a bemenetnek bármely HealthState értékkel. Az érték 65535.
--exclude-health-statistics Azt jelzi, hogy az állapotstatisztikát vissza kell-e adni a lekérdezés eredményének részeként. Alapértelmezés szerint hamis. A statisztikák az Ok, a Figyelmeztetés és a Hiba állapotú gyermekentitások számát mutatják.
--timeout -t A művelet végrehajtásának kiszolgálói időtúllépése másodpercben. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60.

Globális argumentumok

Argumentum Description
--Debug Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
--output -o Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json.
--Lekérdezés JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ : .
--Részletes Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

sfctl-alkalmazás üzembe helyezett listája

Lekéri a Service Fabric-csomóponton üzembe helyezett alkalmazások listáját.

Lekéri a Service Fabric-csomóponton üzembe helyezett alkalmazások listáját. Az eredmények nem tartalmaznak információt az üzembe helyezett rendszeralkalmazásokról, kivéve, ha az azonosító kifejezetten lekérdezi. Az eredmények közé tartoznak az aktív, aktiválási és letöltési állapotban üzembe helyezett alkalmazások. Ehhez a lekérdezéshez a csomópont nevének meg kell felelnie a fürt egyik csomópontjának. A lekérdezés meghiúsul, ha a megadott csomópontnév nem mutat a fürt aktív Service Fabric-csomópontjaira.

Argumentumok

Argumentum Description
--node-name [Kötelező] A csomópont neve.
--continuation-token A folytatási jogkivonat paramétere a következő eredmények lekérésére szolgál. Az API válaszában szerepel egy nem üres értékkel rendelkező folytatási jogkivonat, ha a rendszer eredményei nem férnek el egyetlen válaszban. Amikor ezt az értéket átadja a következő API-hívásnak, az API a következő eredményhalmazt adja vissza. Ha nincsenek további eredmények, akkor a folytatási jogkivonat nem tartalmaz értéket. Ennek a paraméternek az értéke nem lehet URL-kódolású.
--include-health-state Egy entitás állapotának belefoglalása. Ha ez a paraméter hamis vagy nincs megadva, akkor a visszaadott állapot "Ismeretlen". Ha igaz értékre van állítva, a lekérdezés párhuzamosan halad a csomóponttal és az állapotrendszer-szolgáltatással az eredmények egyesítése előtt. Ennek eredményeképpen a lekérdezés drágább, és hosszabb időt vehet igénybe.
--max-results A lapozott lekérdezések részeként visszaadandó eredmények maximális száma. Ez a paraméter határozza meg a visszaadott eredmények számának felső határát. A visszaadott eredmények kisebbek lehetnek a megadott maximális eredménynél, ha nem férnek el az üzenetben a konfigurációban meghatározott maximális üzenetméret-korlátozásoknak megfelelően. Ha ez a paraméter nulla vagy nincs megadva, a lapozott lekérdezés a lehető legtöbb eredményt tartalmazza, amely illeszkedik a visszatérési üzenetbe.
--timeout -t A művelet végrehajtásának kiszolgálói időtúllépése másodpercben. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60.

Globális argumentumok

Argumentum Description
--Debug Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
--output -o Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json.
--Lekérdezés JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
--Részletes A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

sfctl-alkalmazás állapota

Lekéri a Service Fabric-alkalmazás állapotát.

A service fabric alkalmazás hőállapotát adja vissza. A válasz az Ok, a Hiba vagy a Figyelmeztetés állapotot jelenti. Ha az entitás nem található az állapottárolóban, a hibaüzenet jelenik meg.

Argumentumok

Argumentum Description
--application-id [Kötelező] Az alkalmazás identitása. Ez általában az alkalmazás teljes neve a "háló:" URI-séma nélkül. A 6.0-s verziótól kezdve a hierarchikus nevek a "~" 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.
--deployed-applications-health-state-filter Lehetővé teszi az üzembe helyezett alkalmazások állapotobjektumainak szűrését, amelyeket az alkalmazásállapot-lekérdezés eredményeként ad vissza az állapotuk alapján. A paraméter lehetséges értékei közé tartozik az alábbi állapotok egyikének egész értéke. A rendszer csak a szűrőnek megfelelő üzembe helyezett alkalmazásokat adja vissza. Az összes üzembe helyezett alkalmazás az összesített állapot kiértékelésére szolgál. Ha nincs megadva, a rendszer minden bejegyzést visszaad. Az állapotértékek jelzőalapú számbavételek, ezért az érték az értékek kombinációja lehet, amely bitenkénti "OR" operátorral érhető el. Ha például a megadott érték 6, akkor az üzembe helyezett alkalmazások állapotának állapota OK (2) és Figyelmeztetés (4) értékkel lesz visszaadva.
- Alapértelmezett – Alapértelmezett érték. Bármely HealthState-nak megfelel. Az érték nulla.
- Nincs – Olyan szűrő, amely nem felel meg a HealthState értéknek. Egy adott állapotgyűjtemény eredményeinek visszaadására szolgál. Az érték 1.
- Ok – Szűrő, amely megfelel a bemenetnek a HealthState ok értékével. Az érték 2.
- Figyelmeztetés – Olyan szűrő, amely megfelel a HealthState értékének Figyelmeztetés értékének. Az érték 4.
- Hiba – Olyan szűrő, amely megegyezik a HealthState érték hiba értékével. Az érték 8.
- Mind – Szűrő, amely megfelel a bemenetnek bármely HealthState-értékkel. Az érték 65535.
--events-health-state-filter Lehetővé teszi a HealthEvent-objektumok gyűjteményének szűrését az állapot alapján. A paraméter lehetséges értékei közé tartozik az alábbi állapotok egyikének egész értéke. A rendszer csak a szűrőnek megfelelő eseményeket adja vissza. Az összes esemény az összesített állapot kiértékelésére szolgál. Ha nincs megadva, a rendszer minden bejegyzést visszaad. Az állapotértékek jelzőalapú számbavételek, ezért az érték az értékek kombinációja lehet, amelyet a bitenkénti "OR" operátorral szerezhetünk be. Ha például a megadott érték 6, akkor a rendszer az OK (2) és a Figyelmeztetés (4) HealthState értékkel rendelkező összes eseményt visszaadja.
- Alapértelmezett – Alapértelmezett érték. Bármely HealthState-nak megfelel. Az érték nulla.
- Nincs – Olyan szűrő, amely nem felel meg a HealthState értéknek. Egy adott állapotgyűjtemény eredményeinek visszaadására szolgál. Az érték 1.
- Ok – Szűrő, amely megfelel a bemenetnek a HealthState ok értékével. Az érték 2.
- Figyelmeztetés – Olyan szűrő, amely megfelel a HealthState értékének Figyelmeztetés értékének. Az érték 4.
- Hiba – Olyan szűrő, amely megegyezik a HealthState érték hiba értékével. Az érték 8.
- Mind – Szűrő, amely megfelel a bemenetnek bármely HealthState-értékkel. Az érték 65535.
--exclude-health-statistics Azt jelzi, hogy az állapotstatisztikát a lekérdezés eredményének részeként kell-e visszaadni. Alapértelmezés szerint hamis. A statisztikák az Ok, a Figyelmeztetés és a Hiba állapotú gyermek entitások számát mutatják.
--services-health-state-filter Lehetővé teszi a szolgáltatások állapot-lekérdezésének eredményeként visszaadott szolgáltatások állapotobjektumainak szűrését az állapotuk alapján. A paraméter lehetséges értékei közé tartozik az alábbi állapotok egyikének egész értéke. A rendszer csak a szűrőnek megfelelő szolgáltatásokat adja vissza. Az összes szolgáltatás az összesített állapot kiértékelésére szolgál. Ha nincs megadva, a rendszer minden bejegyzést visszaad. Az állapotértékek jelzőalapú számbavételek, ezért az érték az értékek kombinációja lehet, amely bitenkénti "OR" operátorral érhető el. Ha például a megadott érték 6, akkor a rendszer az OK (2) és a Figyelmeztetés (4) Állapotértékkel rendelkező szolgáltatások állapotát adja vissza.
- Alapértelmezett – Alapértelmezett érték. Bármely HealthState-nak megfelel. Az érték nulla.
- Nincs – Olyan szűrő, amely nem felel meg a HealthState értéknek. Egy adott állapotgyűjtemény eredményeinek visszaadására szolgál. Az érték 1.
- Ok – Szűrő, amely megfelel a bemenetnek a HealthState ok értékével. Az érték 2.
- Figyelmeztetés – Olyan szűrő, amely megfelel a HealthState értékének Figyelmeztetés értékének. Az érték 4.
- Hiba – Olyan szűrő, amely megegyezik a HealthState érték hiba értékével. Az érték 8.
- Mind – Szűrő, amely megfelel a bemenetnek bármely HealthState-értékkel. Az érték 65535.
--timeout -t A kiszolgáló időtúllépése a művelet másodpercben történő végrehajtásához. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60.

Globális argumentumok

Argumentum Description
--Debug Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
--output -o Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json.
--Lekérdezés JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ : .
--Részletes Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

sfctl-alkalmazásadatok

Információt kér le egy Service Fabric-alkalmazásról.

A Service Fabric-fürtben létrehozott vagy folyamatban lévő alkalmazás adatait adja vissza, amelynek neve megegyezik a paraméterként megadott alkalmazással. A válasz tartalmazza az alkalmazás nevét, típusát, állapotát, paramétereit és egyéb adatait.

Argumentumok

Argumentum Description
--application-id [Kötelező] Az alkalmazás identitása. 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, illetve a "myapp/app1" a korábbi verziókban.
--exclude-application-parameters Az a jelző, amely meghatározza, hogy az alkalmazásparaméterek ki lesznek-e zárva az eredményből.
--timeout -t A művelet végrehajtásának kiszolgálói időtúllépése másodpercben. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60.

Globális argumentumok

Argumentum Description
--Debug Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
--output -o Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json.
--Lekérdezés JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ : .
--Részletes Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

sfctl-alkalmazáslista

Lekéri a Service Fabric-fürtben létrehozott, a megadott szűrőknek megfelelő alkalmazások listáját.

Lekéri a Service Fabric-fürtben létrehozott vagy folyamatban lévő alkalmazásokkal kapcsolatos információkat, és egyezteti a megadott szűrőket. A válasz tartalmazza az alkalmazás nevét, típusát, állapotát, paramétereit és egyéb adatait. Ha az alkalmazások nem férnek el egy oldalon, a rendszer egy oldalnyi eredményt ad vissza, valamint egy folytatási jogkivonatot, amely a következő oldal lekéréséhez használható. Az ApplicationTypeName és az ApplicationDefinitionKindFilter szűrők nem adhatók meg egyszerre.

Argumentumok

Argumentum Description
--application-definition-kind-filter Az ApplicationDefinitionKind szűrésére szolgál, amely a Service Fabric-alkalmazások definiálására szolgáló mechanizmus.
- Alapértelmezett – Alapértelmezett érték, amely ugyanazt a függvényt hajtja végre, mint az "Összes" lehetőséget. Az érték 0.
- Mind – Olyan szűrő, amely megfelel bármely ApplicationDefinitionKind értéknek. Az érték 65535.
- ServiceFabricApplicationDescription – Olyan szűrő, amely megfelel az ApplicationDefinitionKind ServiceFabricApplicationDescription értéknek. Az érték 1.
- Levélírás – Szűrő, amely megfelel az ApplicationDefinitionKind Érték Compose értékének. Az érték 2.
--application-type-name Az alkalmazástípus neve, amellyel szűrheti az alkalmazásokat a lekérdezéshez. Ez az érték nem tartalmazhatja az alkalmazástípus verzióját.
--continuation-token A folytatási jogkivonat paramétere a következő eredmények lekérésére szolgál. Az API válaszában szerepel egy nem üres értékkel rendelkező folytatási jogkivonat, ha a rendszer eredményei nem férnek el egyetlen válaszban. Amikor ezt az értéket átadja a következő API-hívásnak, az API a következő eredményhalmazt adja vissza. Ha nincsenek további eredmények, akkor a folytatási jogkivonat nem tartalmaz értéket. Ennek a paraméternek az értéke nem lehet URL-kódolású.
--exclude-application-parameters Az a jelző, amely meghatározza, hogy az alkalmazásparaméterek ki lesznek-e zárva az eredményből.
--max-results A lapozott lekérdezések részeként visszaadandó eredmények maximális száma. Ez a paraméter határozza meg a visszaadott eredmények számának felső határát. A visszaadott eredmények kisebbek lehetnek a megadott maximális eredménynél, ha nem férnek el az üzenetben a konfigurációban meghatározott maximális üzenetméret-korlátozásoknak megfelelően. Ha ez a paraméter nulla vagy nincs megadva, a lapozott lekérdezés a lehető legtöbb eredményt tartalmazza, amely illeszkedik a visszatérési üzenetbe.
--timeout -t A művelet végrehajtásának kiszolgálói időtúllépése másodpercben. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60.

Globális argumentumok

Argumentum Description
--Debug Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
--output -o Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json.
--Lekérdezés JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ : .
--Részletes Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

sfctl-alkalmazás terhelése

Beolvassa a Service Fabric-alkalmazás betöltési adatait.

Visszaadja a Service Fabric-fürtben létrehozott vagy folyamatban lévő alkalmazás betöltési adatait, és amelynek a neve megegyezik a paraméterként megadottval. A válasz tartalmazza a nevet, a minimális csomópontokat, a maximális csomópontokat, az alkalmazás által jelenleg foglalt csomópontok számát, valamint az alkalmazás terhelési metrikáinak adatait az alkalmazásról.

Argumentumok

Argumentum Description
--application-id [Kötelező] Az alkalmazás identitása. 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, illetve a "myapp/app1" a korábbi verziókban.
--timeout -t A művelet végrehajtásának kiszolgálói időtúllépése másodpercben. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60.

Globális argumentumok

Argumentum Description
--Debug Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
--output -o Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json.
--Lekérdezés JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ : .
--Részletes Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

sfctl-alkalmazásjegyzék

Lekéri az alkalmazástípust leíró jegyzékfájlt.

A válasz sztringként tartalmazza az alkalmazásjegyzék XML-fájlját.

Argumentumok

Argumentum Description
--application-type-name [Kötelező] Az alkalmazástípus neve.
--application-type-version [Kötelező] Az alkalmazástípus verziója.
--timeout -t A művelet végrehajtásának kiszolgálói időtúllépése másodpercben. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60.

Globális argumentumok

Argumentum Description
--Debug Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
--output -o Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json.
--Lekérdezés JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ : .
--Részletes Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

sfctl-alkalmazás kiépítése

Kiépít vagy regisztrál egy Service Fabric-alkalmazástípust a fürtben a ".sfpkg" csomag használatával a külső tárolóban vagy az alkalmazáscsomag használatával a lemezképtárolóban.

Kiépít egy Service Fabric-alkalmazástípust a fürttel. A kiépítésre minden új alkalmazás példányosítása előtt szükség van. A kiépítési művelet elvégezhető a relativePathInImageStore által megadott alkalmazáscsomagon, vagy a külső '.sfpkg' URI-jának használatával. Ha a --external-provision beállítás nincs beállítva, ez a parancs képtároló-kiépítést vár.

Argumentumok

Argumentum Description
--application-package-download-uri A.sfpkg alkalmazáscsomag elérési útja, ahonnan az alkalmazáscsomag letölthető HTTP- vagy HTTPS-protokollokkal.

Csak külső tároló típusú kiépítéshez. Az alkalmazáscsomag egy külső tárolóban tárolható, amely GET műveletet biztosít a fájl letöltéséhez. A támogatott protokollok a HTTP és a HTTPS, és az elérési útnak engedélyeznie kell a READ-hozzáférést.
--application-type-build-path Csak a rendszerképtár típusú kiépítéshez. Az alkalmazáscsomag relatív elérési útja az előző feltöltési művelet során megadott képtárolóban.
--application-type-name Csak külső tároló típusú kiépítéshez. Az alkalmazástípus neve az alkalmazásjegyzékben található alkalmazástípus nevét jelöli.
--application-type-version Csak külső tároló típusú kiépítéshez. Az alkalmazástípus verziója az alkalmazásjegyzékben található alkalmazástípus verzióját jelöli.
--external-provision Az a hely, ahonnan az alkalmazáscsomag regisztrálható vagy kiéphető. Azt jelzi, hogy a kiépítés egy olyan alkalmazáscsomaghoz tartozik, amelyet korábban egy külső tárolóba töltöttek fel. Az alkalmazáscsomag a *.sfpkg kiterjesztéssel végződik.
--no-wait Azt jelzi, hogy a kiépítésnek aszinkron módon kell-e történnie.

Igaz értékre állítva a kiépítési művelet akkor tér vissza, ha a rendszer elfogadja a kérést, és a kiépítési művelet időkorlát nélkül folytatódik. Az alapértelmezett érték a hamis. Nagy alkalmazáscsomagok esetén azt javasoljuk, hogy állítsa az értéket true (igaz) értékre.
--timeout -t Alapértelmezett: 60.

Globális argumentumok

Argumentum Description
--Debug Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
--output -o Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json.
--Lekérdezés JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ : .
--Részletes Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

sfctl-alkalmazás jelentés-állapota

Állapotjelentést küld a Service Fabric-alkalmazásról.

A megadott Service Fabric-alkalmazás állapotjelentése. A jelentésnek tartalmaznia kell az állapotjelentés forrására és a jelentés alapjául szolgáló tulajdonságra vonatkozó információkat. A jelentés egy Service Fabric-átjáróalkalmazásnak lesz elküldve, amely az állapottárolóba továbbítja. Előfordulhat, hogy az átjáró elfogadja a jelentést, de a további ellenőrzés után az állapottároló elutasítja. Előfordulhat például, hogy az állapottároló elutasítja a jelentést egy érvénytelen paraméter, például egy elavult sorszám miatt. Annak ellenőrzéséhez, hogy a jelentés alkalmazva lett-e az állapottárolóban, kérje le az alkalmazás állapotát, és ellenőrizze, hogy megjelenik-e a jelentés.

Argumentumok

Argumentum Description
--application-id [Kötelező] Az alkalmazás identitása.

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.
--health-property [Kötelező] Az állapotadatok tulajdonsága.

Az entitások különböző tulajdonságokra vonatkozó állapotjelentésekkel rendelkezhetnek. A tulajdonság egy sztring, nem pedig rögzített számbavétel, amely lehetővé teszi, hogy a riporter rugalmasan kategorizálja a jelentést kiváltó állapotfeltételt. Egy "LocalWatchdog" SourceId azonosítóval rendelkező riporter például figyelheti a csomóponton elérhető lemez állapotát, így jelentheti az adott csomópont "AvailableDisk" tulajdonságát. Ugyanaz a riporter figyelheti a csomópontkapcsolatot, így jelentheti a "Connectivity" tulajdonságot ugyanazon a csomóponton. Az állapottárolóban ezek a jelentések külön állapoteseményként lesznek kezelve a megadott csomóponthoz. A SourceId tulajdonsággal együtt a tulajdonság egyedileg azonosítja az állapotadatokat.
--health-state [Kötelező] Lehetséges értékek: 'Invalid', 'Ok', 'Warning', 'Error', 'Unknown'.
--source-id [Kötelező] Az állapotinformációkat létrehozó ügyfél-/watchdog/rendszerösszetevőt azonosító forrásnév.
--Leírás Az állapotinformációk leírása.

A jelentés emberi olvasásra alkalmas információinak hozzáadására használt szabad szöveget jelöli. A leírás maximális sztringhossza 4096 karakter. Ha a megadott sztring hosszabb, automatikusan csonkul. Csonkításkor a leírás utolsó karakterei egy "[Csonkolt]" jelölőt tartalmaznak, és a teljes sztringméret 4096 karakter. A jelölő jelenléte azt jelzi a felhasználóknak, hogy csonkítás történt. Vegye figyelembe, hogy csonkolt leírás esetén a leírás kevesebb, mint 4096 karakterből áll az eredeti sztringből.
--Azonnali Jelölő, amely jelzi, hogy a jelentést azonnal el kell-e küldeni.

A rendszer állapotjelentést küld egy Service Fabric-átjáróalkalmazásnak, amely az állapottárolóba továbbítja. Ha az Azonnali érték igaz, a rendszer azonnal elküldi a jelentést a HTTP Gatewayből az állapottárolóba, függetlenül attól, hogy a HTTP Gateway-alkalmazás milyen hálóügyfél-beállításokat használ. Ez olyan kritikus jelentések esetén hasznos, amelyeket a lehető leghamarabb el kell küldeni. Az időzítéstől és más feltételektől függően a jelentés küldése továbbra is sikertelen lehet, például ha a HTTP-átjáró bezárult, vagy az üzenet nem éri el az átjárót. Ha az Azonnali érték false (hamis) értékre van állítva, a rendszer a jelentést a HTTP-átjáró állapotügyfél-beállításai alapján küldi el. Ezért a rendszer a HealthReportSendInterval konfigurációnak megfelelően kötegelve lesz. Ez az ajánlott beállítás, mert lehetővé teszi, hogy az állapotügyfél optimalizálja az állapotjelentési üzeneteket az állapottárolóba, valamint az állapotjelentések feldolgozását. Alapértelmezés szerint a jelentések nem lesznek azonnal elküldve.
--remove-when-expired Érték, amely azt jelzi, hogy a jelentés el lett-e távolítva az állapottárolóból a lejáratkor.

Ha igaz értékre van állítva, a jelentés el lesz távolítva az állapottárolóból a lejárata után. Ha false (hamis) értékre van állítva, a jelentés hibaként lesz kezelve, ha lejárt. Ennek a tulajdonságnak az értéke alapértelmezés szerint hamis. Amikor az ügyfelek rendszeresen jelentést tesznek, a RemoveWhenExpired false (alapértelmezett) értéket kell beállítaniuk. Így a riporter problémákat (például holtpontot) tapasztal, és nem tud jelentést készíteni, az entitás kiértékelése hiba esetén történik, amikor az állapotjelentés lejár. Ez hibaállapotúként jelöli meg az entitást.
--sequence-number Az állapotjelentés sorszáma numerikus sztringként.

Az állapottároló a jelentéssorozat számát használja az elavult jelentések észlelésére. Ha nincs megadva, az állapotügyfél automatikusan létrehoz egy sorszámot a jelentés hozzáadásakor.
--timeout -t Alapértelmezett: 60.
--Ttl Az az időtartam, amelyre ez az állapotjelentés érvényes. Ez a mező ISO8601 formátumot használ az időtartam megadásához.

Amikor az ügyfelek rendszeres időközönként jelentést küldenek, az élettartamnál nagyobb gyakorisággal kell jelentéseket küldeniük. Ha az ügyfelek jelentést tesznek az átmenetről, az élettartamot végtelenre állíthatják. Az élettartam lejártakor az állapotinformációkat tartalmazó állapotesemény vagy törlődik az állapottárolóból, ha a RemoveWhenExpired értéke igaz, vagy hiba esetén lesz kiértékelve, ha a RemoveWhenExpired hamis. Ha nincs megadva, az élettartam alapértelmezett értéke végtelen.

Globális argumentumok

Argumentum Description
--Debug Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
--output -o Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json.
--Lekérdezés JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ : .
--Részletes Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

sfctl-alkalmazás típusa

Lekéri a Service Fabric-fürt azon alkalmazástípusainak listáját, amelyek pontosan megfelelnek a megadott névnek.

A kiépített vagy a Service Fabric-fürtben üzembe helyezés alatt álló alkalmazástípusokra vonatkozó információkat adja vissza. Ezek az eredmények olyan alkalmazástípusok, amelyek neve pontosan megegyezik a paraméterként megadott névvel, és amelyek megfelelnek a megadott lekérdezési paramétereknek. A rendszer az alkalmazástípus nevének megfelelő összes verziót visszaadja, és minden verziót egyetlen alkalmazástípusként ad vissza. A válasz tartalmazza az alkalmazás típusának nevét, verzióját, állapotát és egyéb adatait. Ez egy lapozott lekérdezés, ami azt jelenti, hogy ha nem minden alkalmazástípus fér el egy lapon, a rendszer egy oldalnyi eredményt ad vissza, valamint egy folytatási jogkivonatot, amely a következő oldal lekéréséhez használható. Ha például 10 alkalmazástípus van, de egy oldal csak az első három alkalmazástípusnak felel meg, vagy ha a maximális eredmény 3-ra van állítva, akkor a rendszer három értéket ad vissza. A többi eredmény eléréséhez kérje le a következő oldalakat a következő lekérdezés visszaadott folytatási jogkivonatával. Ha nincsenek további lapok, a rendszer üres folytatási jogkivonatot ad vissza.

Argumentumok

Argumentum Description
--application-type-name [Kötelező] Az alkalmazástípus neve.
--application-type-version Az alkalmazástípus verziója.
--continuation-token A folytatási jogkivonat paramétere a következő eredmények lekérésére szolgál. Az API válaszában szerepel egy nem üres értékkel rendelkező folytatási jogkivonat, ha a rendszer eredményei nem férnek el egyetlen válaszban. Amikor ezt az értéket átadja a következő API-hívásnak, az API a következő eredményhalmazt adja vissza. Ha nincsenek további eredmények, akkor a folytatási jogkivonat nem tartalmaz értéket. Ennek a paraméternek az értéke nem lehet URL-kódolású.
--exclude-application-parameters Az a jelző, amely meghatározza, hogy az alkalmazásparaméterek ki lesznek-e zárva az eredményből.
--max-results A lapozott lekérdezések részeként visszaadandó eredmények maximális száma. Ez a paraméter határozza meg a visszaadott eredmények számának felső határát. A visszaadott eredmények kisebbek lehetnek a megadott maximális eredménynél, ha nem férnek el az üzenetben a konfigurációban meghatározott maximális üzenetméret-korlátozásoknak megfelelően. Ha ez a paraméter nulla vagy nincs megadva, a lapozott lekérdezés a lehető legtöbb eredményt tartalmazza, amely illeszkedik a visszatérési üzenetbe.
--timeout -t A művelet végrehajtásának kiszolgálói időtúllépése másodpercben. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60.

Globális argumentumok

Argumentum Description
--Debug Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
--output -o Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json.
--Lekérdezés JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ : .
--Részletes Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

sfctl-alkalmazástípus-lista

Lekéri a Service Fabric-fürt alkalmazástípusainak listáját.

A kiépített vagy a Service Fabric-fürtben üzembe helyezés alatt álló alkalmazástípusokra vonatkozó információkat adja vissza. A rendszer egy alkalmazástípus minden verzióját egy alkalmazástípusként adja vissza. A válasz tartalmazza az alkalmazás típusának nevét, verzióját, állapotát és egyéb adatait. Ez egy lapozott lekérdezés, ami azt jelenti, hogy ha nem minden alkalmazástípus fér el egy lapon, a rendszer egy oldalnyi eredményt ad vissza, valamint egy folytatási jogkivonatot, amely a következő oldal lekéréséhez használható. Ha például 10 alkalmazástípus van, de egy oldal csak az első három alkalmazástípusnak felel meg, vagy ha a maximális eredmény 3-ra van állítva, akkor a rendszer három értéket ad vissza. A többi eredmény eléréséhez kérje le a következő oldalakat a következő lekérdezés visszaadott folytatási jogkivonatával. Ha nincsenek további lapok, a rendszer üres folytatási jogkivonatot ad vissza.

Argumentumok

Argumentum Description
--application-type-definition-kind-filter Az ApplicationTypeDefinitionKind szűrésére szolgál, amely a Service Fabric-alkalmazástípus meghatározására szolgáló mechanizmus.
- Alapértelmezett – Alapértelmezett érték, amely ugyanazt a függvényt hajtja végre, mint az "Összes" lehetőséget. Az érték 0.
- Mind – Olyan szűrő, amely megfelel bármely ApplicationTypeDefinitionKind értéknek. Az érték 65535.
- ServiceFabricApplicationPackage – Az ApplicationTypeDefinitionKind ServiceFabricApplicationPackage értékkel egyező szűrő. Az érték 1.
- Compose – Szűrő, amely megfelel az ApplicationTypeDefinitionKind Érték Compose értékének. Az érték 2.
--continuation-token A folytatási jogkivonat paramétere a következő eredmények lekérésére szolgál. Az API válaszában szerepel egy nem üres értékkel rendelkező folytatási jogkivonat, ha a rendszer eredményei nem férnek el egyetlen válaszban. Amikor ezt az értéket átadja a következő API-hívásnak, az API a következő eredményhalmazt adja vissza. Ha nincsenek további eredmények, akkor a folytatási jogkivonat nem tartalmaz értéket. Ennek a paraméternek az értéke nem lehet URL-kódolású.
--exclude-application-parameters Az a jelző, amely meghatározza, hogy az alkalmazásparaméterek ki lesznek-e zárva az eredményből.
--max-results A lapozott lekérdezések részeként visszaadandó eredmények maximális száma. Ez a paraméter határozza meg a visszaadott eredmények számának felső határát. A visszaadott eredmények kisebbek lehetnek a megadott maximális eredménynél, ha nem férnek el az üzenetben a konfigurációban meghatározott maximális üzenetméret-korlátozásoknak megfelelően. Ha ez a paraméter nulla vagy nincs megadva, a lapozott lekérdezés a lehető legtöbb eredményt tartalmazza, amely illeszkedik a visszatérési üzenetbe.
--timeout -t A művelet végrehajtásának kiszolgálói időtúllépése másodpercben. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60.

Globális argumentumok

Argumentum Description
--Debug Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
--output -o Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json.
--Lekérdezés JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ : .
--Részletes Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

sfctl-alkalmazás leépítése

Eltávolítja vagy törli a Service Fabric-alkalmazástípus regisztrációját a fürtből.

Ez a művelet csak akkor nyitható meg, ha az alkalmazástípus összes alkalmazáspéldányát törölték. Az alkalmazástípus regisztrációjának törlése után nem hozhatók létre új alkalmazáspéldányok ehhez az alkalmazástípushoz.

Argumentumok

Argumentum Description
--application-type-name [Kötelező] Az alkalmazástípus neve.
--application-type-version [Kötelező] Az alkalmazástípus verziója az alkalmazásjegyzékben meghatározottak szerint.
--async-parameter A jelölő, amely jelzi, hogy a kiépítésnek aszinkron módon kell-e történnie. Igaz értékre állítva a leépítési művelet akkor tér vissza, ha a rendszer elfogadja a kérést, és a leépítési művelet időtúllépési korlát nélkül folytatódik. Az alapértelmezett érték a hamis. Azt javasoljuk azonban, hogy állítsa true (igaz) értékre a kiépített nagy alkalmazáscsomagok esetében.
--timeout -t A művelet végrehajtásának kiszolgálói időtúllépése másodpercben. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60.

Globális argumentumok

Argumentum Description
--Debug Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
--output -o Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json.
--Lekérdezés JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ : .
--Részletes Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

sfctl-alkalmazás frissítése

Megkezdi egy alkalmazás frissítését a Service Fabric-fürtben.

Ellenőrzi a megadott alkalmazásfrissítési paramétereket, és megkezdi az alkalmazás frissítését, ha a paraméterek érvényesek. Vegye figyelembe, hogy a frissítés leírása felülírja a meglévő alkalmazásleírást. Ez azt jelenti, hogy ha a paraméterek nincsenek megadva, az alkalmazások meglévő paramétereit felülírja a rendszer az üres paraméterek listájával. Ez azt eredményezné, hogy az alkalmazás az alkalmazásjegyzékben szereplő paraméterek alapértelmezett értékét használja.

Argumentumok

Argumentum Description
--application-id [Kötelező] Az alkalmazás identitása.

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, illetve a "myapp/app1" a korábbi verziókban.
--application-version [Kötelező] A célalkalmazás-típus verziója (amely az alkalmazásjegyzékben található) az alkalmazásfrissítéshez.
--parameters [Kötelező] Az alkalmazásfrissítéskor alkalmazandó alkalmazásparaméter-felülbírálások JSON-kódolású listája.
--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.
--failure-action Az a művelet, amelyet akkor kell végrehajtani, ha egy figyelt frissítés figyelési szabályzatot vagy állapotszabályzat-szabálysértést tapasztal.
--force-restart A frissítés során a folyamatok kényszerített újraindítása akkor is, ha a kód verziója nem változott.
--health-check-retry-timeout Az állapotellenőrzési kísérletek közötti időtartam, ha az alkalmazás vagy a fürt állapota nem megfelelő. Alapértelmezett: PT0H10M0S.
--health-check-stable-duration Az az idő, amíg 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 folytatódik. Alapértelmezett: PT0H2M0S.

Először egy ISO 8601-időtartamot jelölő sztringként értelmezik. Ha ez nem sikerül, akkor a rendszer az ezredmásodpercek teljes számát jelölő számként értelmezi.
--health-check-wait-duration Az állapot-ellenőrzési folyamat megkezdése előtt a frissítési tartomány befejezését követő várakozási idő. Alapértelmezett: 0.
--max-unhealthy-apps A nem kifogástalan állapotú üzembe helyezett alkalmazások maximálisan engedélyezett százalékos aránya. 0 és 100 közötti számként jelenik meg.
--Mód A működés közbeni frissítés állapotának figyelésére használt mód. Alapértelmezett: UnmonitoredAuto.
--replica-set-check-timeout A frissítési tartomány feldolgozásának letiltásához és a rendelkezésre állás elvesztésének megelőzéséhez szükséges maximális idő váratlan problémák esetén. Másodpercben mérve.
--service-health-policy JSON-kódolású térkép szolgáltatástípus-állapotszabályzattal szolgáltatástípus-név szerint. A térkép alapértelmezett értéke üres.
--timeout -t Alapértelmezett: 60.
--upgrade-domain-timeout Az egyes frissítési tartományoknak a FailureAction végrehajtása előtt le kell töltenie az időt. Alapértelmezett: P10675199DT02H48M05.4775807S.

Először egy ISO 8601-időtartamot jelölő sztringként értelmezik. Ha ez nem sikerül, akkor a rendszer az ezredmásodpercek teljes számát jelölő számként értelmezi.
--upgrade-timeout Az az idő, amíg a teljes frissítésnek befejeződnie kell a FailureAction végrehajtása előtt. Alapértelmezett: P10675199DT02H48M05.4775807S.

Először egy ISO 8601-időtartamot jelölő sztringként értelmezik. Ha ez nem sikerül, akkor a rendszer az ezredmásodpercek teljes számát jelölő számként értelmezi.
--warning-as-error Azt jelzi, hogy a figyelmeztetések a hibákéval azonos súlyossággal vannak-e kezelve.

Globális argumentumok

Argumentum Description
--Debug Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
--output -o Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json.
--Lekérdezés JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ : .
--Részletes Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

sfctl-alkalmazás frissítése-folytatása

Folytatja egy alkalmazás frissítését a Service Fabric-fürtben.

Nem figyelt manuális Service Fabric-alkalmazásfrissítés folytatása. A Service Fabric egyszerre egy frissítési tartományt frissít. Nem figyelt manuális frissítések esetén, miután a Service Fabric befejezett egy frissítési tartományt, megvárja, amíg meghívja ezt az API-t, mielőtt továbblép a következő frissítési tartományra.

Argumentumok

Argumentum Description
--application-id [Kötelező] Az alkalmazás identitása. 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, illetve a "myapp/app1" a korábbi verziókban.
--upgrade-domain-name [Kötelező] Annak a frissítési tartománynak a neve, amelyben a frissítést folytatni szeretné.
--timeout -t A művelet végrehajtásának kiszolgálói időtúllépése másodpercben. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60.

Globális argumentumok

Argumentum Description
--Debug Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
--output -o Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json.
--Lekérdezés JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ : .
--Részletes Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

sfctl-alkalmazásfrissítés-visszaállítás

Megkezdi egy alkalmazás folyamatban lévő frissítésének visszaállítását a Service Fabric-fürtben.

Elkezdi visszagördíteni az aktuális alkalmazásfrissítést az előző verzióra. Ez az API csak az aktuális folyamatban lévő frissítés új verzióra való visszaállítására használható. Ha az alkalmazást jelenleg nem frissítik, használja a StartApplicationUpgrade API-t a kívánt verzióra való frissítéshez, beleértve a korábbi verzióra való visszaállítást is.

Argumentumok

Argumentum Description
--application-id [Kötelező] Az alkalmazás identitása. 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, illetve a "myapp/app1" a korábbi verziókban.
--timeout -t A művelet végrehajtásának kiszolgálói időtúllépése másodpercben. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60.

Globális argumentumok

Argumentum Description
--Debug Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
--output -o Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json.
--Lekérdezés JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ : .
--Részletes Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

sfctl-alkalmazásfrissítés állapota

Lekéri az alkalmazáson végrehajtott legújabb frissítés részleteit.

Információkat ad vissza a legújabb alkalmazásfrissítés állapotáról, valamint az alkalmazás állapotával kapcsolatos problémák hibakeresését segítő részleteket.

Argumentumok

Argumentum Description
--application-id [Kötelező] Az alkalmazás identitása. 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, illetve a "myapp/app1" a korábbi verziókban.
--timeout -t A művelet végrehajtásának kiszolgálói időtúllépése másodpercben. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc. Alapértelmezett: 60.

Globális argumentumok

Argumentum Description
--Debug Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
--output -o Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json.
--Lekérdezés JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ : .
--Részletes Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

sfctl-alkalmazás feltöltése

Másolja a Service Fabric-alkalmazáscsomagot a képtárolóba.

Igény szerint megjelenítheti a csomagban lévő összes fájl feltöltési folyamatát. A rendszer elküldi a feltöltési folyamatot a(z) címre stderr.

Argumentumok

Argumentum Description
--path [Kötelező] A helyi alkalmazáscsomag elérési útja.
--Tömöríteni Csak Service Fabric-alkalmazáscsomagokra alkalmazható. Hozzon létre egy új mappát, amely tartalmazza a tömörített alkalmazáscsomagot az alapértelmezett helyre vagy a tömörített hely paraméter által megadott helyre, majd töltse fel az újonnan létrehozott mappát.

Ha már van sfctl által létrehozott tömörített fájl, a rendszer felülírja, ha ez a jelző be van állítva. A rendszer hibát ad vissza, ha a könyvtár nem alkalmazáscsomag. Ha már tömörített alkalmazáscsomag, a mappa a következőképpen lesz átmásolva. Alapértelmezés szerint az újonnan létrehozott tömörített alkalmazáscsomag a sikeres feltöltés után törlődik. Ha a feltöltés sikertelen, szükség szerint törölje manuálisan a tömörített csomagot. A törlés nem távolítja el azokat az üres naplókat, amelyek akkor hozhatók létre, ha a tömörített hely paramétere nem létező könyvtárakra hivatkozik.
--compressed-location A tömörített alkalmazáscsomag elhelyezésének helye.

Ha nincs megadva hely, a tömörített csomag egy újonnan létrehozott, sfctl_compressed_temp nevű mappába kerül az elérési út argumentumban megadott szülőkönyvtár alá. Ha például az elérési út argumentum értéke C:/FolderA/AppPkg, akkor a tömörített csomag hozzá lesz adva a C:/FolderA/sfctl_compressed_temp/AppPkg fájlhoz.
--imagestore-string Célként szolgáló rendszerképtár az alkalmazáscsomag feltöltéséhez. Alapértelmezett: fabric:ImageStore.

Fájlhelyre való feltöltéshez indítsa el ezt a paramétert a következővel: "file:". Ellenkező esetben az értéknek a képtároló kapcsolati sztring kell lennie, például az alapértelmezett értéknek.
--keep-compressed Azt határozza meg, hogy a létrehozott tömörített csomag sikeres feltöltési folyamaton maradjon-e.

Ha nincs beállítva, akkor a sikeres végrehajtás után a tömörített alkalmazáscsomagok törlődnek. Ha a feltöltés sikertelen volt, az alkalmazáscsomag mindig a kimeneti könyvtárban marad az újbóli feltöltéshez.
--show-progress Nagyméretű csomagok fájlfeltöltési folyamatának megjelenítése.
--timeout -t A teljes időtúllépés másodpercben. A feltöltés sikertelen lesz, és hibát ad vissza a feltöltési időtúllépési időtartam leteltét követően. Ez az időtúllépés a teljes alkalmazáscsomagra vonatkozik, és az egyes fájlok időtúllépése megegyezik a fennmaradó időtúllépési idővel. Az időtúllépés nem tartalmazza az alkalmazáscsomag tömörítéséhez szükséges időt. Alapértelmezett: 300.

Globális argumentumok

Argumentum Description
--Debug Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
--help -h Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
--output -o Kimeneti formátum. Megengedett értékek: json, jsonc, table, tsv. Alapértelmezett: json.
--Lekérdezés JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ : .
--Részletes Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

Következő lépések

  • Állítsa be a Service Fabric parancssori felületét.
  • Megtudhatja, hogyan használhatja a Service Fabric parancssori felületét a mintaszkriptekkel.