Sdílet prostřednictvím


sfctl application

Vytváření, odstraňování a správa aplikací a typů aplikací

Příkazy

Příkaz Popis
create Vytvoří aplikaci Service Fabric pomocí zadaného popisu.
delete Odstraní existující aplikaci Service Fabric.
Nasazeny Získá informace o aplikaci nasazené v uzlu Service Fabric.
deployed-health Získá informace o stavu aplikace nasazené v uzlu Service Fabric.
deployed-list Získá seznam aplikací nasazených v uzlu Service Fabric.
Zdraví Získá stav aplikace Service Fabric.
Info Získá informace o aplikaci Service Fabric.
list Získá seznam aplikací vytvořených v clusteru Service Fabric, které odpovídají zadaným filtrům.
načítání Získá informace o načtení o aplikaci Service Fabric.
manifest Získá manifest popisující typ aplikace.
Poskytování Zřídí nebo zaregistruje typ aplikace Service Fabric v clusteru pomocí balíčku .sfpkg v externím úložišti nebo pomocí balíčku aplikace v úložišti imagí.
report-health Odešle zprávu o stavu aplikace Service Fabric.
typ Získá seznam typů aplikací v clusteru Service Fabric, který přesně odpovídá zadanému názvu.
type-list Získá seznam typů aplikací v clusteru Service Fabric.
zrušit zřízení Odebere nebo zruší registraci typu aplikace Service Fabric z clusteru.
upgrade Spustí upgrade aplikace v clusteru Service Fabric.
upgrade-resume Obnoví upgrade aplikace v clusteru Service Fabric.
upgrade a vrácení zpět Zahájí vrácení aktuálně probíhajícího upgradu aplikace v clusteru Service Fabric.
upgrade-status Získá podrobnosti o nejnovějším upgradu provedeném v této aplikaci.
nahrání Zkopírujte balíček aplikace Service Fabric do úložiště imagí.

vytvoření aplikace sfctl

Vytvoří aplikaci Service Fabric pomocí zadaného popisu.

Argumenty

Argument Popis
--app-name [Povinné] Název aplikace, včetně schématu identifikátoru URI fabric:.
--app-type [Povinné] Název typu aplikace nalezený v manifestu aplikace.
--app-version [Povinné] Verze typu aplikace definovaná v manifestu aplikace.
--max-node-count Maximální počet uzlů, kde service Fabric vyhradí kapacitu pro tuto aplikaci. Upozorňujeme, že to neznamená, že služby této aplikace budou umístěny na všech těchto uzlech.
--Metriky Seznam popisů metrik kapacity aplikace kódovaný ve formátu JSON. Metrika je definována jako název přidružený k sadě kapacit pro každý uzel, na který aplikace existuje.
--min-node-count Minimální počet uzlů, ve kterých service Fabric vyrezervuje kapacitu pro tuto aplikaci. Upozorňujeme, že to neznamená, že služby této aplikace budou umístěny na všech těchto uzlech.
--Parametry Seznam přepsání parametrů aplikace kódovaný ve formátu JSON, který se použije při vytváření aplikace.
--timeout -t Výchozí hodnota: 60.

Globální argumenty

Argument Popis
--Ladění Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h Zobrazte tuto zprávu nápovědy a ukončete ji.
--output -o Výstupní formát. Povolené hodnoty: json, jsonc, table, tsv. Výchozí: json.
--Dotazu Řetězec dotazu JMESPath. Další informace a příklady najdete v tématu http://jmespath.org/ .
--Podrobné Zvyšte úroveň podrobností protokolování. Pro úplné protokoly ladění použijte --debug.

odstranění aplikace sfctl

Odstraní existující aplikaci Service Fabric.

Aby bylo možné aplikaci odstranit, musí být vytvořena. Odstraněním aplikace se odstraní všechny služby, které jsou součástí této aplikace. Ve výchozím nastavení se Service Fabric pokusí řádně zavřít repliky služby a pak službu odstranit. Pokud má ale služba problémy s řádném zavřením repliky, může operace odstranění trvat dlouho nebo se zaseknout. Pomocí volitelného příznaku ForceRemove přeskočte elegantní závěrkovou sekvenci a vynuceně odstraňte aplikaci a všechny její služby.

Argumenty

Argument Popis
--application-id [Povinné] Identita aplikace. Obvykle se jedná o úplný název aplikace bez schématu identifikátoru URI fabric:. Od verze 6.0 jsou hierarchické názvy oddělené znakem "~". Pokud je například název aplikace "fabric:/myapp/app1", bude identita aplikace ve verzi 6.0 nebo novější myapp~app1 a v předchozích verzích myapp/app1.
--force-remove Odeberte aplikaci nebo službu Service Fabric vynuceně, aniž byste museli projít sekvencí odkladu. Tento parametr lze použít k vynucení odstranění aplikace nebo služby, u které dochází k vypršení časového limitu odstranění kvůli problémům v kódu služby, které brání řádnému zavření replik.
--timeout -t Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochoten čekat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60.

Globální argumenty

Argument Popis
--Ladění Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h Zobrazte tuto zprávu nápovědy a ukončete ji.
--output -o Výstupní formát. Povolené hodnoty: json, jsonc, table, tsv. Výchozí: json.
--Dotazu Řetězec dotazu JMESPath. Další informace a příklady najdete v tématu http://jmespath.org/ .
--Podrobné Zvyšte úroveň podrobností protokolování. Pro úplné protokoly ladění použijte --debug.

Nasazená aplikace sfctl

Získá informace o aplikaci nasazené v uzlu Service Fabric.

Tento dotaz vrátí informace o systémové aplikaci, pokud je zadané ID aplikace určené pro systémovou aplikaci. Výsledky zahrnují nasazené aplikace ve stavu aktivní, aktivace a stahování. Tento dotaz vyžaduje, aby název uzlu odpovídal uzlu v clusteru. Dotaz selže, pokud zadaný název uzlu neodkazuje na žádné aktivní uzly Service Fabric v clusteru.

Argumenty

Argument Popis
--application-id [Povinné] Identita aplikace. Obvykle se jedná o úplný název aplikace bez schématu identifikátoru URI fabric:. Od verze 6.0 jsou hierarchické názvy oddělené znakem "~". Pokud je například název aplikace "fabric:/myapp/app1", bude identita aplikace ve verzi 6.0 nebo novější myapp~app1 a v předchozích verzích myapp/app1.
--node-name [Povinné] Název uzlu
--include-health-state Uveďte stav entity. Pokud je tento parametr false nebo není zadaný, je vrácený stav Neznámý. Pokud je nastavená hodnota true, dotaz se před sloučením výsledků paralelně přesune do uzlu a služby health system. V důsledku toho je dotaz dražší a může trvat delší dobu.
--timeout -t Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochoten čekat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60.

Globální argumenty

Argument Popis
--Ladění Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h Zobrazte tuto zprávu nápovědy a ukončete ji.
--output -o Výstupní formát. Povolené hodnoty: json, jsonc, table, tsv. Výchozí: json.
--Dotazu Řetězec dotazu JMESPath. Další informace a příklady najdete v tématu http://jmespath.org/ .
--Podrobné Zvyšte úroveň podrobností protokolování. Pro úplné protokoly ladění použijte --debug.

sfctl application deployed-health

Získá informace o stavu aplikace nasazené v uzlu Service Fabric.

Získá informace o stavu aplikace nasazené v uzlu Service Fabric. Pomocí funkce EventsHealthStateFilter můžete volitelně filtrovat kolekci objektů HealthEvent hlášených v nasazené aplikaci na základě stavu. Pomocí nástroje DeployedServicePackagesHealthStateFilter můžete volitelně filtrovat podřízené položky DeployedServicePackageHealth na základě stavu.

Argumenty

Argument Popis
--application-id [Povinné] Identita aplikace. Obvykle se jedná o úplný název aplikace bez schématu identifikátoru URI fabric:. Od verze 6.0 jsou hierarchické názvy oddělené znakem "~". Pokud je například název aplikace "fabric:/myapp/app1", bude identita aplikace ve verzi 6.0 nebo novější myapp~app1 a v předchozích verzích myapp/app1.
--node-name [Povinné] Název uzlu
--deployed-service-packages-health-state-filter Umožňuje filtrování objektů stavu nasazených balíčků služeb vrácených v důsledku nasazeného dotazu na stav aplikace na základě jejich stavu. Možné hodnoty tohoto parametru zahrnují celočíselnou hodnotu jednoho z následujících stavů. Vrátí se pouze nasazené balíčky služeb, které odpovídají filtru. Všechny nasazené balíčky služeb slouží k vyhodnocení agregovaného stavu nasazené aplikace. Pokud není zadán, vrátí se všechny položky. Hodnoty stavu jsou výčet založený na příznaku, takže hodnota může být kombinací těchto hodnot, která se získá pomocí bitového operátoru OR. Pokud je například zadaná hodnota 6, vrátí se stav balíčků služeb s hodnotami HealthState OK (2) a Warning (4).
– Výchozí – Výchozí hodnota. Odpovídá libovolnému stavu stavu. Hodnota je nula.
- Žádné – Filtr, který neodpovídá žádné hodnotě HealthState. Používá se k vrácení žádných výsledků v dané kolekci stavů. Hodnota je 1.
- Ok – Filtr, který odpovídá vstupu s hodnotou HealthState Ok. Hodnota je 2.
– Upozornění – Filtr, který odpovídá vstupu s hodnotou HealthState Warning. Hodnota je 4.
- Error – Filtr, který odpovídá vstupu s hodnotou HealthState Error. Hodnota je 8.
- Vše – Filtr, který odpovídá vstupu s libovolnou hodnotou HealthState. Hodnota je 65535.
--events-health-state-filter Umožňuje filtrovat kolekci vrácených objektů HealthEvent na základě stavu. Možné hodnoty tohoto parametru zahrnují celočíselnou hodnotu jednoho z následujících stavů. Vrátí se pouze události, které odpovídají filtru. Všechny události se používají k vyhodnocení agregovaného stavu stavu. Pokud není zadán, vrátí se všechny položky. Hodnoty stavu jsou výčet založený na příznaku, takže hodnota může být kombinací těchto hodnot, která se získá pomocí bitového operátoru OR. Pokud je například zadaná hodnota 6, vrátí se všechny události s hodnotou HealthState OK (2) a Warning (4).
– Výchozí – Výchozí hodnota. Odpovídá libovolnému stavu stavu. Hodnota je nula.
- Žádné – Filtr, který neodpovídá žádné hodnotě HealthState. Používá se k vrácení žádných výsledků v dané kolekci stavů. Hodnota je 1.
- Ok – Filtr, který odpovídá vstupu s hodnotou HealthState Ok. Hodnota je 2.
– Upozornění – Filtr, který odpovídá vstupu s hodnotou HealthState Warning. Hodnota je 4.
- Error – Filtr, který odpovídá vstupu s hodnotou HealthState Error. Hodnota je 8.
- Vše – Filtr, který odpovídá vstupu s libovolnou hodnotou HealthState. Hodnota je 65535.
--exclude-health-statistics Určuje, jestli se mají jako součást výsledku dotazu vrátit statistiky stavu. Ve výchozím nastavení nepravda. Statistika zobrazuje počet podřízených entit ve stavu OK, Upozornění a Chyba.
--timeout -t Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochoten čekat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60.

Globální argumenty

Argument Popis
--Ladění Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h Zobrazte tuto zprávu nápovědy a ukončete ji.
--output -o Výstupní formát. Povolené hodnoty: json, jsonc, table, tsv. Výchozí: json.
--Dotazu Řetězec dotazu JMESPath. Další informace a příklady najdete v tématu http://jmespath.org/ .
--Podrobné Zvyšte úroveň podrobností protokolování. Pro úplné protokoly ladění použijte --debug.

sfctl application deployed-list

Získá seznam aplikací nasazených v uzlu Service Fabric.

Získá seznam aplikací nasazených v uzlu Service Fabric. Výsledky neobsahují informace o nasazených systémových aplikacích, pokud nejsou explicitně dotazovány podle ID. Výsledky zahrnují nasazené aplikace ve stavu aktivní, aktivace a stahování. Tento dotaz vyžaduje, aby název uzlu odpovídal uzlu v clusteru. Dotaz selže, pokud zadaný název uzlu neodkazuje na žádné aktivní uzly Service Fabric v clusteru.

Argumenty

Argument Popis
--node-name [Povinné] Název uzlu
--continuation-token Parametr pokračovacího tokenu se používá k získání další sady výsledků. Token pokračování s neprázdnou hodnotou je součástí odpovědi rozhraní API, pokud se výsledky ze systému nevejdou do jedné odpovědi. Když se tato hodnota předá dalšímu volání rozhraní API, vrátí rozhraní API další sadu výsledků. Pokud nejsou k dispozici žádné další výsledky, znamená to, že pokračovací token neobsahuje hodnotu. Hodnota tohoto parametru by neměla být kódovaná adresa URL.
--include-health-state Uveďte stav entity. Pokud je tento parametr false nebo není zadaný, je vrácený stav Neznámý. Pokud je nastavená hodnota true, dotaz se před sloučením výsledků paralelně přesune do uzlu a služby health system. V důsledku toho je dotaz dražší a může trvat delší dobu.
--max-results Maximální počet výsledků, které se mají vrátit jako součást stránkovaných dotazů. Tento parametr definuje horní mez počtu vrácených výsledků. Vrácené výsledky můžou být menší než zadané maximální výsledky, pokud se nevejdou do zprávy podle omezení maximální velikosti zprávy definované v konfiguraci. Pokud je tento parametr nula nebo není zadaný, stránkovaný dotaz obsahuje co nejvíce výsledků, které se vejdou do návratové zprávy.
--timeout -t Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochoten čekat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60.

Globální argumenty

Argument Popis
--Ladění Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h Zobrazte tuto zprávu nápovědy a ukončete ji.
--output -o Výstupní formát. Povolené hodnoty: json, jsonc, table, tsv. Výchozí: json.
--Dotazu Řetězec dotazu JMESPath. Další informace a příklady najdete v tématu http://jmespath.org/ .
--Podrobné Zvyšte úroveň podrobností protokolování. Pro úplné protokoly ladění použijte --debug.

stav aplikace sfctl

Získá stav aplikace Service Fabric.

Vrátí stav vřesu aplikace Service Fabric. Odpověď hlásí stav OK, Chyba nebo Stav upozornění. Pokud entita není v úložišti stavů nalezena, vrátí chybu.

Argumenty

Argument Popis
--application-id [Povinné] Identita aplikace. Obvykle se jedná o úplný název aplikace bez schématu identifikátoru URI fabric:. Od verze 6.0 jsou hierarchické názvy oddělené znakem "~". Pokud je například název aplikace "fabric:/myapp/app1", bude identita aplikace ve verzi 6.0 nebo novější myapp~app1 a v předchozích verzích myapp/app1.
--deployed-applications-health-state-filter Umožňuje filtrování objektů stavu nasazených aplikací vrácených ve výsledku dotazu na stav aplikace na základě jejich stavu. Možné hodnoty tohoto parametru zahrnují celočíselnou hodnotu jednoho z následujících stavů. Vrátí se pouze nasazené aplikace, které odpovídají filtru. Všechny nasazené aplikace se používají k vyhodnocení agregovaného stavu stavu. Pokud není zadán, vrátí se všechny položky. Hodnoty stavu jsou výčty založené na příznaku, takže hodnota může být kombinací těchto hodnot, která se získá pomocí bitového operátoru OR. Pokud je například zadaná hodnota 6, vrátí se stav nasazených aplikací s hodnotami HealthState OK (2) a Warning (4).
– Výchozí – Výchozí hodnota. Odpovídá libovolnému stavu stavu. Hodnota je nula.
- Žádné – Filtr, který neodpovídá žádné hodnotě HealthState. Používá se k vrácení žádných výsledků v dané kolekci stavů. Hodnota je 1.
- Ok – Filtr, který odpovídá vstupu s hodnotou HealthState Ok. Hodnota je 2.
– Upozornění – Filtr, který odpovídá vstupu s hodnotou HealthState Warning. Hodnota je 4.
- Error – Filtr, který odpovídá vstupu s hodnotou HealthState Error. Hodnota je 8.
- Vše – Filtr, který odpovídá vstupu s libovolnou hodnotou HealthState. Hodnota je 65535.
--events-health-state-filter Umožňuje filtrovat kolekci vrácených objektů HealthEvent na základě stavu. Možné hodnoty tohoto parametru zahrnují celočíselnou hodnotu jednoho z následujících stavů. Vrátí se pouze události, které odpovídají filtru. Všechny události se používají k vyhodnocení agregovaného stavu stavu. Pokud není zadán, vrátí se všechny položky. Hodnoty stavu jsou výčet založený na příznaku, takže hodnota může být kombinací těchto hodnot, která se získá pomocí bitového operátoru OR. Pokud je například zadaná hodnota 6, vrátí se všechny události s hodnotou HealthState OK (2) a Warning (4).
– Výchozí – Výchozí hodnota. Odpovídá libovolnému stavu stavu. Hodnota je nula.
- Žádné – Filtr, který neodpovídá žádné hodnotě HealthState. Používá se k vrácení žádných výsledků v dané kolekci stavů. Hodnota je 1.
- Ok – Filtr, který odpovídá vstupu s hodnotou HealthState Ok. Hodnota je 2.
– Upozornění – Filtr, který odpovídá vstupu s hodnotou HealthState Warning. Hodnota je 4.
- Error – Filtr, který odpovídá vstupu s hodnotou HealthState Error. Hodnota je 8.
- Vše – Filtr, který odpovídá vstupu s libovolnou hodnotou HealthState. Hodnota je 65535.
--exclude-health-statistics Určuje, jestli se mají jako součást výsledku dotazu vrátit statistiky stavu. Ve výchozím nastavení nepravda. Statistika zobrazuje počet podřízených entit ve stavu OK, Upozornění a Chyba.
--services-health-state-filter Umožňuje filtrování objektů stavu služeb vrácených ve výsledku dotazu na stav služeb na základě jejich stavu. Možné hodnoty tohoto parametru zahrnují celočíselnou hodnotu jednoho z následujících stavů. Vrátí se pouze služby, které odpovídají filtru. K vyhodnocení agregovaného stavu se používají všechny služby. Pokud není zadán, vrátí se všechny položky. Hodnoty stavu jsou výčty založené na příznaku, takže hodnota může být kombinací těchto hodnot, která se získá pomocí bitového operátoru OR. Pokud je například zadaná hodnota 6, vrátí se stav služeb s hodnotami HealthState OK (2) a Warning (4).
– Výchozí – Výchozí hodnota. Odpovídá libovolnému stavu stavu. Hodnota je nula.
- Žádné – Filtr, který neodpovídá žádné hodnotě HealthState. Používá se k vrácení žádných výsledků v dané kolekci stavů. Hodnota je 1.
- Ok – Filtr, který odpovídá vstupu s hodnotou HealthState Ok. Hodnota je 2.
– Upozornění – Filtr, který odpovídá vstupu s hodnotou HealthState Warning. Hodnota je 4.
- Error – Filtr, který odpovídá vstupu s hodnotou HealthState Error. Hodnota je 8.
- Vše – Filtr, který odpovídá vstupu s libovolnou hodnotou HealthState. Hodnota je 65535.
--timeout -t Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochoten čekat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60.

Globální argumenty

Argument Popis
--Ladění Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h Zobrazte tuto zprávu nápovědy a ukončete ji.
--output -o Výstupní formát. Povolené hodnoty: json, jsonc, table, tsv. Výchozí: json.
--Dotazu Řetězec dotazu JMESPath. Další informace a příklady najdete v tématu http://jmespath.org/ .
--Podrobné Zvyšte úroveň podrobností protokolování. Pro úplné protokoly ladění použijte --debug.

informace o aplikaci sfctl

Získá informace o aplikaci Service Fabric.

Vrátí informace o aplikaci, která byla vytvořena nebo v procesu vytváření v clusteru Service Fabric a jejíž název odpovídá názvu zadanému jako parametr. Odpověď obsahuje název, typ, stav, parametry a další podrobnosti o aplikaci.

Argumenty

Argument Popis
--application-id [Povinné] Identita aplikace. Obvykle se jedná o úplný název aplikace bez schématu identifikátoru URI fabric:. Od verze 6.0 jsou hierarchické názvy oddělené znakem "~". Pokud je například název aplikace "fabric:/myapp/app1", bude identita aplikace ve verzi 6.0 nebo novější myapp~app1 a v předchozích verzích myapp/app1.
--exclude-application-parameters Příznak, který určuje, jestli budou parametry aplikace vyloučeny z výsledku.
--timeout -t Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochoten čekat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60.

Globální argumenty

Argument Popis
--Ladění Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h Zobrazte tuto zprávu nápovědy a ukončete ji.
--output -o Výstupní formát. Povolené hodnoty: json, jsonc, table, tsv. Výchozí: json.
--Dotazu Řetězec dotazu JMESPath. Další informace a příklady najdete v tématu http://jmespath.org/ .
--Podrobné Zvyšte úroveň podrobností protokolování. Pro úplné protokoly ladění použijte --debug.

seznam aplikací sfctl

Získá seznam aplikací vytvořených v clusteru Service Fabric, které odpovídají zadaným filtrům.

Získá informace o aplikacích, které byly vytvořeny nebo v procesu vytváření v clusteru Service Fabric a odpovídají zadaným filtrům. Odpověď obsahuje název, typ, stav, parametry a další podrobnosti o aplikaci. Pokud se aplikace nevejdou na stránku, vrátí se jedna stránka výsledků a také token pokračování, který lze použít k získání další stránky. Filtry ApplicationTypeName a ApplicationDefinitionKindFilter nelze zadat současně.

Argumenty

Argument Popis
--application-definition-kind-filter Slouží k filtrování applicationDefinitionKind, což je mechanismus, který se používá k definování aplikace Service Fabric.
- Výchozí – výchozí hodnota, která provádí stejnou funkci jako při výběru možnosti Vše. Hodnota je 0.
- Vše – Filtr, který odpovídá vstupu s libovolnou hodnotou ApplicationDefinitionKind. Hodnota je 65535.
- ServiceFabricApplicationDescription – filtr, který odpovídá vstupu s hodnotou ApplicationDefinitionKind ServiceFabricApplicationDescription. Hodnota je 1.
- Compose – filtr, který odpovídá vstupu s hodnotou ApplicationDefinitionKind Compose. Hodnota je 2.
--application-type-name Název typu aplikace, který slouží k filtrování aplikací, na které se mají dotazovat. Tato hodnota by neměla obsahovat verzi typu aplikace.
--continuation-token Parametr pokračovacího tokenu se používá k získání další sady výsledků. Token pokračování s neprázdnou hodnotou je součástí odpovědi rozhraní API, pokud se výsledky ze systému nevejdou do jedné odpovědi. Když se tato hodnota předá dalšímu volání rozhraní API, vrátí rozhraní API další sadu výsledků. Pokud nejsou k dispozici žádné další výsledky, znamená to, že pokračovací token neobsahuje hodnotu. Hodnota tohoto parametru by neměla být kódovaná adresa URL.
--exclude-application-parameters Příznak, který určuje, jestli budou parametry aplikace vyloučeny z výsledku.
--max-results Maximální počet výsledků, které se mají vrátit jako součást stránkovaných dotazů. Tento parametr definuje horní mez počtu vrácených výsledků. Vrácené výsledky můžou být menší než zadané maximální výsledky, pokud se nevejdou do zprávy podle omezení maximální velikosti zprávy definované v konfiguraci. Pokud je tento parametr nula nebo není zadaný, stránkovaný dotaz obsahuje co nejvíce výsledků, které se vejdou do návratové zprávy.
--timeout -t Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochoten čekat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60.

Globální argumenty

Argument Popis
--Ladění Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h Zobrazte tuto zprávu nápovědy a ukončete ji.
--output -o Výstupní formát. Povolené hodnoty: json, jsonc, table, tsv. Výchozí: json.
--Dotazu Řetězec dotazu JMESPath. Další informace a příklady najdete v tématu http://jmespath.org/ .
--Podrobné Zvyšte úroveň podrobností protokolování. Pro úplné protokoly ladění použijte --debug.

sfctl – načtení aplikace

Získá informace o načtení o aplikaci Service Fabric.

Vrátí informace o zatížení aplikace, která byla vytvořena nebo v procesu vytváření v clusteru Service Fabric a jejíž název odpovídá názvu zadanému jako parametr. Odpověď obsahuje název, minimální uzly, maximální počet uzlů, počet uzlů, které aplikace aktuálně zabírá, a informace o metrice načítání aplikace.

Argumenty

Argument Popis
--application-id [Povinné] Identita aplikace. Obvykle se jedná o úplný název aplikace bez schématu identifikátoru URI fabric:. Od verze 6.0 jsou hierarchické názvy oddělené znakem "~". Pokud je například název aplikace "fabric:/myapp/app1", bude identita aplikace ve verzi 6.0 nebo novější myapp~app1 a v předchozích verzích myapp/app1.
--timeout -t Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochoten čekat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60.

Globální argumenty

Argument Popis
--Ladění Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h Zobrazte tuto zprávu nápovědy a ukončete ji.
--output -o Výstupní formát. Povolené hodnoty: json, jsonc, table, tsv. Výchozí: json.
--Dotazu Řetězec dotazu JMESPath. Další informace a příklady najdete v tématu http://jmespath.org/ .
--Podrobné Zvyšte úroveň podrobností protokolování. Pro úplné protokoly ladění použijte --debug.

manifest aplikace sfctl

Získá manifest popisující typ aplikace.

Odpověď obsahuje xml manifestu aplikace jako řetězec.

Argumenty

Argument Popis
--application-type-name [Povinné] Název typu aplikace.
--application-type-version [Povinné] Verze typu aplikace.
--timeout -t Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochoten čekat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60.

Globální argumenty

Argument Popis
--Ladění Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h Zobrazte tuto zprávu nápovědy a ukončete ji.
--output -o Výstupní formát. Povolené hodnoty: json, jsonc, table, tsv. Výchozí: json.
--Dotazu Řetězec dotazu JMESPath. Další informace a příklady najdete v tématu http://jmespath.org/ .
--Podrobné Zvyšte úroveň podrobností protokolování. Pro úplné protokoly ladění použijte --debug.

Zřízení aplikace sfctl

Zřídí nebo zaregistruje typ aplikace Service Fabric v clusteru pomocí balíčku .sfpkg v externím úložišti nebo pomocí balíčku aplikace v úložišti imagí.

Zřídí typ aplikace Service Fabric s clusterem. Zřízení se vyžaduje před vytvořením instance nových aplikací. Operaci zřízení lze provést buď na balíčku aplikace určeném v úložišti relativePathInImageStore, nebo pomocí identifikátoru URI externího souboru .sfpkg. Pokud není nastavený parametr --external-provision, bude tento příkaz očekávat zřízení úložiště imagí.

Argumenty

Argument Popis
--application-package-download-uri Cesta k balíčku aplikace .sfpkg, ze kterého lze stáhnout balíček aplikace pomocí protokolů HTTP nebo HTTPS.

Pro zřízení typu pouze externí úložiště. Balíček aplikace může být uložen v externím úložišti, které poskytuje operaci GET pro stažení souboru. Podporované protokoly jsou HTTP a HTTPS a cesta musí umožňovat přístup ke čtení.
--application-type-build-path Pouze pro zřízení úložiště imagí typu. Relativní cesta k balíčku aplikace v úložišti imagí zadaná během předchozí operace nahrávání.
--application-type-name Pro zřízení typu pouze externí úložiště. Název typu aplikace představuje název typu aplikace, který se nachází v manifestu aplikace.
--application-type-version Pro zřízení typu pouze externí úložiště. Verze typu aplikace představuje verzi typu aplikace, která se nachází v manifestu aplikace.
--external-provision Umístění, ze kterého lze balíček aplikace zaregistrovat nebo zřídit. Označuje, že zřizování je pro balíček aplikace, který byl dříve nahrán do externího úložiště. Balíček aplikace končí příponou *.sfpkg.
--no-wait Určuje, jestli má zřizování probíhat asynchronně.

Pokud je nastavená hodnota true, operace zřízení se vrátí, když systém přijme požadavek a operace zřizování pokračuje bez jakéhokoli časového limitu. Výchozí hodnota je False. U velkých balíčků aplikací doporučujeme nastavit hodnotu na true.
--timeout -t Výchozí hodnota: 60.

Globální argumenty

Argument Popis
--Ladění Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h Zobrazit tuto zprávu nápovědy a ukončit ji.
--output -o Formát výstupu. Povolené hodnoty: json, jsonc, table, tsv. Výchozí: json.
--Dotazu Řetězec dotazu JMESPath Další informace a příklady najdete v tématu http://jmespath.org/ .
--Podrobné Zvyšte úroveň podrobností protokolování. Pro úplné protokoly ladění použijte příkaz --debug.

sfctl application report-health

Odešle zprávu o stavu aplikace Service Fabric.

Hlásí stav zadané aplikace Service Fabric. Sestava musí obsahovat informace o zdroji sestavy o stavu a vlastnosti, na které je sestava hlášena. Sestava se odešle do aplikace brány Service Fabric, která se předá do úložiště stavů. Sestava může být bránou přijata, ale po dodatečném ověření odmítnuta úložištěm stavů. Úložiště stavů může například sestavu odmítnout kvůli neplatnému parametru, jako je zastaralé pořadové číslo. Pokud chcete zjistit, jestli se sestava použila v úložišti stavů, získejte stav aplikace a zkontrolujte, jestli se sestava zobrazuje.

Argumenty

Argument Popis
--application-id [Povinné] Identita aplikace.

Obvykle se jedná o úplný název aplikace bez schématu identifikátoru URI fabric:. Od verze 6.0 jsou hierarchické názvy oddělené znakem ~. Pokud je například název aplikace "fabric:/myapp/app1", identita aplikace bude ve verzi 6.0 nebo novější ve verzi 6.0 a myapp/app1.
--health-property [Povinné] Vlastnost informací o stavu.

Entita může mít sestavy stavu pro různé vlastnosti. Vlastnost je řetězec, nikoli pevný výčet, který umožňuje zpravodaji flexibilitu kategorizovat stav podmínku, která aktivuje sestavu. Například reportér s Id zdroje "LocalWatchdog" může monitorovat stav dostupného disku na uzlu, aby mohl na tomto uzlu hlásit vlastnost AvailableDisk. Stejný zpravodaj může monitorovat připojení uzlu, takže může nahlásit vlastnost "Připojení" na stejném uzlu. V úložišti stavů se tyto sestavy považují za samostatné události stavu pro zadaný uzel. Spolu s SourceId vlastnost jednoznačně identifikuje informace o stavu.
--health-state [Povinné] Mezi možné hodnoty patří: Neplatný, Ok, Upozornění, Chyba, Neznámý.
--source-id [povinné] Název zdroje, který identifikuje komponentu klienta, watchdog nebo systému, která vygenerovala informace o stavu.
--Popis Popis informací o zdravotním stavu.

Představuje volný text, který se používá k přidání čitelných informací o sestavě. Maximální délka řetězce pro popis je 4096 znaků. Pokud je zadaný řetězec delší, automaticky se zkrátí. Při zkrácení budou poslední znaky popisu obsahovat značku "[Zkráceno] a celková velikost řetězce je 4096 znaků. Přítomnost značky označuje uživatelům, že došlo ke zkrácení. Všimněte si, že při zkrácení má popis z původního řetězce méně než 4096 znaků.
--Okamžité Příznak, který označuje, zda má být sestava odeslána okamžitě.

Zpráva o stavu se odešle do aplikace brány Service Fabric, která se předává do úložiště stavů. Pokud je vlastnost Immediate nastavená na hodnotu true, sestava se okamžitě odešle z http Gateway do úložiště stavů bez ohledu na nastavení klienta prostředků infrastruktury, které aplikace služby HTTP Gateway používá. To je užitečné pro kritické sestavy, které by se měly odeslat co nejdříve. V závislosti na načasování a dalších podmínkách může odeslání sestavy přesto selhat, například pokud je brána HTTP zavřená nebo se zpráva nedorazí do brány. Pokud je možnost Immediate nastavená na false, sestava se odešle na základě nastavení klienta stavu z brány HTTP. Proto bude dávková podle konfigurace HealthReportSendInterval. Toto nastavení se doporučuje, protože umožňuje klientovi stavu optimalizovat zprávy sestav o stavu do úložiště stavu i zpracování sestav stavu. Ve výchozím nastavení se sestavy neodesílají okamžitě.
--remove-when-expired Hodnota, která určuje, jestli se sestava po vypršení platnosti odebere z úložiště stavů.

Pokud je nastavená hodnota true, sestava se po vypršení platnosti odebere z úložiště stavů. Pokud je nastavená hodnota false, bude sestava po vypršení platnosti považována za chybu. Hodnota této vlastnosti je ve výchozím nastavení false. Když klienti pravidelně hlásí, měli by nastavit RemoveWhenExpired false (výchozí). Pokud má reportér problémy (např. vzájemné zablokování) a nemůže nahlásit, entita se při vypršení platnosti sestavy stavu vyhodnotí s chybou. Tím se entita označí jako ve stavu Chyba.
--pořadové číslo Pořadové číslo pro tuto sestavu stavu jako číselný řetězec.

Pořadové číslo sestavy se používá v úložišti stavů ke zjišťování zastaralých sestav. Pokud není zadané, při přidání sestavy se automaticky vygeneruje číslo sekvence klientem stavu.
--timeout -t Výchozí hodnota: 60.
--Ttl Doba, po kterou je tato zpráva o stavu platná. Toto pole používá k určení doby trvání formát ISO8601.

Když klienti pravidelně hlásí sestavy, měli by posílat sestavy s vyšší frekvencí, než je hodnota TTL (Time to Live). Pokud klienti hlásí přechod, můžou nastavit hodnotu TTL (Time to Live) na nekonečnou hodnotu. Když vyprší hodnota Time to Live, událost stavu, která obsahuje informace o stavu, se buď odebere z úložiště stavů, pokud má RemoveWhenExpired hodnotu true, nebo se vyhodnotí jako chyba, pokud RemoveWhenExpired false. Pokud není zadaný, hodnota Time to Live bude ve výchozím nastavení nekonečná.

Globální argumenty

Argument Popis
--Ladění Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h Zobrazit tuto zprávu nápovědy a ukončit ji.
--output -o Formát výstupu. Povolené hodnoty: json, jsonc, table, tsv. Výchozí: json.
--Dotazu Řetězec dotazu JMESPath. Další informace a příklady najdete v tématu http://jmespath.org/ .
--Podrobné Zvyšte úroveň podrobností protokolování. Pro úplné protokoly ladění použijte --debug.

Typ aplikace sfctl

Získá seznam typů aplikací v clusteru Service Fabric, který přesně odpovídá zadanému názvu.

Vrátí informace o typech aplikací, které jsou zřízené nebo v procesu zřizování v clusteru Service Fabric. Tyto výsledky jsou typů aplikací, jejichž název přesně odpovídá názvu zadanému jako parametr a které odpovídají zadaným parametrům dotazu. Vrátí se všechny verze typu aplikace, které odpovídají názvu typu aplikace, přičemž každá verze se vrátí jako jeden typ aplikace. Odpověď obsahuje název, verzi, stav a další podrobnosti o typu aplikace. Jedná se o stránkovaný dotaz, což znamená, že pokud se na stránku nevejdou všechny typy aplikací, vrátí se jedna stránka výsledků a také token pokračování, který lze použít k získání další stránky. Pokud je například 10 typů aplikací, ale stránka odpovídá pouze prvním třem typům aplikace, nebo pokud je maximální počet výsledků nastaven na 3, vrátí se tři. Pokud chcete získat přístup ke zbývajícím výsledkům, načtěte následující stránky pomocí vráceného tokenu pokračování v dalším dotazu. Pokud neexistují žádné další stránky, vrátí se prázdný token pokračování.

Argumenty

Argument Popis
--application-type-name [Povinné] Název typu aplikace.
--application-type-version Verze typu aplikace.
--continuation-token Parametr pokračovacího tokenu se používá k získání další sady výsledků. Token pokračování s neprázdnou hodnotou je součástí odpovědi rozhraní API, pokud se výsledky ze systému nevejdou do jedné odpovědi. Když se tato hodnota předá dalšímu volání rozhraní API, vrátí rozhraní API další sadu výsledků. Pokud nejsou k dispozici žádné další výsledky, znamená to, že pokračovací token neobsahuje hodnotu. Hodnota tohoto parametru by neměla být kódovaná adresa URL.
--exclude-application-parameters Příznak, který určuje, jestli budou parametry aplikace vyloučeny z výsledku.
--max-results Maximální počet výsledků, které se mají vrátit jako součást stránkovaných dotazů. Tento parametr definuje horní mez počtu vrácených výsledků. Vrácené výsledky můžou být menší než zadané maximální výsledky, pokud se nevejdou do zprávy podle omezení maximální velikosti zprávy definované v konfiguraci. Pokud je tento parametr nula nebo není zadaný, stránkovaný dotaz obsahuje co nejvíce výsledků, které se vejdou do návratové zprávy.
--timeout -t Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochoten čekat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60.

Globální argumenty

Argument Popis
--Ladění Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h Zobrazte tuto zprávu nápovědy a ukončete ji.
--output -o Výstupní formát. Povolené hodnoty: json, jsonc, table, tsv. Výchozí: json.
--Dotazu Řetězec dotazu JMESPath. Další informace a příklady najdete v tématu http://jmespath.org/ .
--Podrobné Zvyšte úroveň podrobností protokolování. Pro úplné protokoly ladění použijte --debug.

sfctl application type-list

Získá seznam typů aplikací v clusteru Service Fabric.

Vrátí informace o typech aplikací, které jsou zřízené nebo v procesu zřizování v clusteru Service Fabric. Každá verze typu aplikace se vrátí jako jeden typ aplikace. Odpověď obsahuje název, verzi, stav a další podrobnosti o typu aplikace. Jedná se o stránkovaný dotaz, což znamená, že pokud se na stránku nevejdou všechny typy aplikací, vrátí se jedna stránka výsledků a také token pokračování, který lze použít k získání další stránky. Pokud je například 10 typů aplikací, ale stránka odpovídá pouze prvním třem typům aplikace, nebo pokud je maximální počet výsledků nastaven na 3, vrátí se tři. Pokud chcete získat přístup ke zbývajícím výsledkům, načtěte následující stránky pomocí vráceného tokenu pokračování v dalším dotazu. Pokud neexistují žádné další stránky, vrátí se prázdný token pokračování.

Argumenty

Argument Popis
--application-type-definition-kind-filter Používá se k filtrování applicationTypeDefinitionKind, což je mechanismus, který se používá k definování typu aplikace Service Fabric.
- Výchozí – výchozí hodnota, která provádí stejnou funkci jako při výběru možnosti Vše. Hodnota je 0.
- Vše – Filtr, který odpovídá vstupu s libovolnou hodnotou ApplicationTypeDefinitionKind. Hodnota je 65535.
- ServiceFabricApplicationPackage – filtr, který odpovídá vstupu s hodnotou ApplicationTypeDefinitionKind ServiceFabricApplicationPackage. Hodnota je 1.
- Compose – filtr, který odpovídá vstupu s hodnotou ApplicationTypeDefinitionKind Compose. Hodnota je 2.
--continuation-token Parametr pokračovacího tokenu se používá k získání další sady výsledků. Token pokračování s neprázdnou hodnotou je součástí odpovědi rozhraní API, pokud se výsledky ze systému nevejdou do jedné odpovědi. Když se tato hodnota předá dalšímu volání rozhraní API, vrátí rozhraní API další sadu výsledků. Pokud nejsou k dispozici žádné další výsledky, znamená to, že pokračovací token neobsahuje hodnotu. Hodnota tohoto parametru by neměla být kódovaná adresa URL.
--exclude-application-parameters Příznak, který určuje, jestli budou parametry aplikace vyloučeny z výsledku.
--max-results Maximální počet výsledků, které se mají vrátit jako součást stránkovaných dotazů. Tento parametr definuje horní mez počtu vrácených výsledků. Vrácené výsledky můžou být menší než zadané maximální výsledky, pokud se nevejdou do zprávy podle omezení maximální velikosti zprávy definované v konfiguraci. Pokud je tento parametr nula nebo není zadaný, stránkovaný dotaz obsahuje co nejvíce výsledků, které se vejdou do návratové zprávy.
--timeout -t Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochoten čekat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60.

Globální argumenty

Argument Popis
--Ladění Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h Zobrazte tuto zprávu nápovědy a ukončete ji.
--output -o Výstupní formát. Povolené hodnoty: json, jsonc, table, tsv. Výchozí: json.
--Dotazu Řetězec dotazu JMESPath. Další informace a příklady najdete v tématu http://jmespath.org/ .
--Podrobné Zvyšte úroveň podrobností protokolování. Pro úplné protokoly ladění použijte --debug.

zrušení zřízení aplikace sfctl

Odebere nebo zruší registraci typu aplikace Service Fabric z clusteru.

Tuto operaci lze provést pouze v případě, že byly odstraněny všechny instance aplikace typu aplikace. Po zrušení registrace typu aplikace nelze pro tento konkrétní typ aplikace vytvořit žádné nové instance aplikace.

Argumenty

Argument Popis
--application-type-name [Povinné] Název typu aplikace.
--application-type-version [Povinné] Verze typu aplikace definovaná v manifestu aplikace.
--async-parameter Příznak označující, zda má dojít k zrušení zřízení asynchronně. Pokud je nastavená hodnota true, operace zrušení zřízení se vrátí, když systém přijme požadavek, a operace zrušení zřízení pokračuje bez jakéhokoli omezení časového limitu. Výchozí hodnota je False. Pro velké balíčky aplikací, které byly zřízené, ale doporučujeme nastavit hodnotu true.
--timeout -t Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochoten čekat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60.

Globální argumenty

Argument Popis
--Ladění Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h Zobrazte tuto zprávu nápovědy a ukončete ji.
--output -o Výstupní formát. Povolené hodnoty: json, jsonc, table, tsv. Výchozí: json.
--Dotazu Řetězec dotazu JMESPath. Další informace a příklady najdete v tématu http://jmespath.org/ .
--Podrobné Zvyšte úroveň podrobností protokolování. Pro úplné protokoly ladění použijte --debug.

upgrade aplikace sfctl

Spustí upgrade aplikace v clusteru Service Fabric.

Ověří zadané parametry upgradu aplikace a zahájí upgrade aplikace, pokud jsou parametry platné. Všimněte si, že popis upgradu nahrazuje existující popis aplikace. To znamená, že pokud parametry nejsou zadány, existující parametry v aplikacích budou přepsány prázdným seznamem parametrů. Výsledkem by bylo, že aplikace použije výchozí hodnotu parametrů z manifestu aplikace.

Argumenty

Argument Popis
--application-id [Povinné] Identita aplikace.

Obvykle se jedná o úplný název aplikace bez schématu identifikátoru URI fabric:. Od verze 6.0 jsou hierarchické názvy oddělené znakem "~". Pokud je například název aplikace "fabric:/myapp/app1", bude identita aplikace ve verzi 6.0 nebo novější myapp~app1 a v předchozích verzích myapp/app1.
--application-version [Povinné] Verze cílového typu aplikace (nachází se v manifestu aplikace) pro upgrade aplikace.
--parameters [Povinné] Seznam přepsání parametrů aplikace zakódovaný ve formátu JSON, který se má použít při upgradu aplikace.
--default-service-health-policy Specifikace zásad stavu zakódovaná ve formátu JSON, která se ve výchozím nastavení používá k vyhodnocení stavu typu služby.
--failure-action Akce, která se má provést, když monitorovaný upgrade narazí na porušení zásad monitorování nebo zásad stavu.
--force-restart Vynuceně restartujte procesy během upgradu, i když se nezměnila verze kódu.
--health-check-retry-timeout Doba mezi pokusy o provedení kontrol stavu, pokud aplikace nebo cluster nejsou v pořádku. Výchozí: PT0H10M0S.
--health-check-stable-duration Doba, po kterou musí aplikace nebo cluster zůstat v pořádku, než upgrade přejde na další doménu upgradu. Výchozí hodnota: PT0H2M0S.

Nejprve se interpretuje jako řetězec představující dobu trvání ISO 8601. Pokud se to nezdaří, pak se interpretuje jako číslo představující celkový počet milisekund.
--health-check-wait-duration Doba čekání po dokončení upgradu domény před zahájením procesu kontroly stavu. Výchozí hodnota: 0.
--max-není v pořádku-apps Maximální povolené procento nasazených aplikací, které nejsou v pořádku. Reprezentováno jako číslo mezi 0 a 100.
--Režimu Režim, který se používá k monitorování stavu během upgradu se zajištěním provozu. Výchozí: UnmonitoredAuto.
--replica-set-check-timeout Maximální doba pro blokování zpracování upgradované domény a zabránění ztrátě dostupnosti v případech, kdy dojde k neočekávaným problémům. Měřeno v sekundách.
--service-health-policy Mapování kódované json se zásadami stavu typu služby na název typu služby. Mapa je prázdná a výchozí.
--timeout -t Výchozí hodnota: 60.
--upgrade-domain-timeout Doba, po kterou je potřeba dokončit každou upgradovanou doménu, než se provede akce FailureAction. Výchozí: P10675199DT02H48M05.4775807S.

Nejprve se interpretuje jako řetězec představující dobu trvání ISO 8601. Pokud se to nezdaří, pak se interpretuje jako číslo představující celkový počet milisekund.
--upgrade-timeout Doba, po kterou je potřeba dokončit celkový upgrade, než se provede akce FailureAction. Výchozí: P10675199DT02H48M05.4775807S.

Nejprve se interpretuje jako řetězec představující dobu trvání ISO 8601. Pokud se to nezdaří, pak se interpretuje jako číslo představující celkový počet milisekund.
--warning-as-error Označuje, jestli se s upozorněními zachází se stejnou závažností jako s chybami.

Globální argumenty

Argument Popis
--Ladění Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h Zobrazte tuto zprávu nápovědy a ukončete ji.
--output -o Výstupní formát. Povolené hodnoty: json, jsonc, table, tsv. Výchozí: json.
--Dotazu Řetězec dotazu JMESPath. Další informace a příklady najdete v tématu http://jmespath.org/ .
--Podrobné Zvyšte úroveň podrobností protokolování. Pro úplné protokoly ladění použijte --debug.

sfctl application upgrade-resume

Obnoví upgrade aplikace v clusteru Service Fabric.

Obnoví nemonitorovaný ruční upgrade aplikace Service Fabric. Service Fabric upgraduje jednu upgradovanou doménu najednou. U nemonitorovaných ručních upgradů Service Fabric po dokončení upgradované domény čeká, až budete toto rozhraní API volat, než přejdete k další upgradované doméně.

Argumenty

Argument Popis
--application-id [Povinné] Identita aplikace. Obvykle se jedná o úplný název aplikace bez schématu identifikátoru URI fabric:. Od verze 6.0 jsou hierarchické názvy oddělené znakem "~". Pokud je například název aplikace "fabric:/myapp/app1", bude identita aplikace ve verzi 6.0 nebo novější myapp~app1 a v předchozích verzích myapp/app1.
--upgrade-domain-name [Povinné] Název domény upgradu, ve které chcete pokračovat v upgradu.
--timeout -t Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochoten čekat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60.

Globální argumenty

Argument Popis
--Ladění Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h Zobrazte tuto zprávu nápovědy a ukončete ji.
--output -o Výstupní formát. Povolené hodnoty: json, jsonc, table, tsv. Výchozí: json.
--Dotazu Řetězec dotazu JMESPath. Další informace a příklady najdete v tématu http://jmespath.org/ .
--Podrobné Zvyšte úroveň podrobností protokolování. Pro úplné protokoly ladění použijte --debug.

sfctl application upgrade-rollback

Zahájí vrácení aktuálně probíhajícího upgradu aplikace v clusteru Service Fabric.

Zahájí vrácení aktuálního upgradu aplikace na předchozí verzi. Toto rozhraní API je možné použít pouze k vrácení aktuálního probíhajícího upgradu, který se postupně vrací na novou verzi. Pokud se aplikace právě neupgraduje, upgradujte ji na požadovanou verzi pomocí rozhraní API StartApplicationUpgrade, včetně vrácení zpět na předchozí verzi.

Argumenty

Argument Popis
--application-id [Povinné] Identita aplikace. Obvykle se jedná o úplný název aplikace bez schématu identifikátoru URI fabric:. Od verze 6.0 jsou hierarchické názvy oddělené znakem "~". Pokud je například název aplikace "fabric:/myapp/app1", bude identita aplikace ve verzi 6.0 nebo novější myapp~app1 a v předchozích verzích myapp/app1.
--timeout -t Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochoten čekat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60.

Globální argumenty

Argument Popis
--Ladění Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h Zobrazte tuto zprávu nápovědy a ukončete ji.
--output -o Výstupní formát. Povolené hodnoty: json, jsonc, table, tsv. Výchozí: json.
--Dotazu Řetězec dotazu JMESPath. Další informace a příklady najdete v tématu http://jmespath.org/ .
--Podrobné Zvyšte úroveň podrobností protokolování. Pro úplné protokoly ladění použijte příkaz --debug.

sfctl application upgrade-status

Získá podrobnosti o nejnovějším upgradu provedeném v této aplikaci.

Vrátí informace o stavu nejnovějšího upgradu aplikace spolu s podrobnostmi, které vám pomůžou s laděním problémů se stavem aplikace.

Argumenty

Argument Popis
--application-id [Povinné] Identita aplikace. Obvykle se jedná o úplný název aplikace bez schématu identifikátoru URI fabric:. Od verze 6.0 jsou hierarchické názvy oddělené znakem ~. Pokud je například název aplikace "fabric:/myapp/app1", identita aplikace bude ve verzi 6.0 nebo novější "myapp~app1" a v předchozích verzích "myapp/app1".
--timeout -t Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochoten počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60.

Globální argumenty

Argument Popis
--Ladění Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h Zobrazit tuto zprávu nápovědy a ukončit ji.
--output -o Formát výstupu. Povolené hodnoty: json, jsonc, table, tsv. Výchozí: json.
--Dotazu Řetězec dotazu JMESPath Další informace a příklady najdete v tématu http://jmespath.org/ .
--Podrobné Zvyšte úroveň podrobností protokolování. Pro úplné protokoly ladění použijte příkaz --debug.

sfctl application upload

Zkopírujte balíček aplikace Service Fabric do úložiště imagí.

Volitelně můžete zobrazit průběh nahrávání pro každý soubor v balíčku. Průběh nahrávání se odesílá na stderradresu .

Argumenty

Argument Popis
--path [Povinné] Cesta k místnímu balíčku aplikace
--Komprimovat Platí jenom pro balíčky aplikací Service Fabric. Vytvořte novou složku obsahující komprimovaný balíček aplikace do výchozího umístění nebo do umístění určeného parametrem compressed-location a nahrajte nově vytvořenou složku.

Pokud už sfctl vygeneroval komprimovaný soubor, bude při nastavení tohoto příznaku přepsán. Pokud adresář není balíček aplikace, vrátí se chyba. Pokud už se jedná o komprimovaný balíček aplikace, složka se zkopíruje tak, jak je. Ve výchozím nastavení se nově vytvořený balíček komprimované aplikace po úspěšném nahrání odstraní. Pokud se nahrání nepovedlo, podle potřeby komprimovaný balíček vyčistěte ručně. Odstranění neodebere žádné prázdné adresáře, které mohly být vytvořeny, pokud komprimovaný parametr umístění odkazuje na neexistující adresáře.
--compressed-location Umístění pro umístění komprimovaného balíčku aplikace.

Pokud není zadáno žádné umístění, bude komprimovaný balíček umístěn do nově vytvořené složky s názvem sfctl_compressed_temp pod nadřazený adresář zadaný v argumentu cesta. Pokud má například argument cesta hodnotu C:/FolderA/AppPkg, pak se komprimovaný balíček přidá do složky C:/FolderA/sfctl_compressed_temp/AppPkg.
--imagestore-string Cílové úložiště imagí, do které se má nahrát balíček aplikace. Výchozí: prostředky infrastruktury:ImageStore.

Pokud chcete soubor nahrát do umístění souboru, začněte tento parametr parametrem file:. V opačném případě by hodnota měla být připojovací řetězec úložiště imagí, například výchozí hodnota.
--keep-compressed Jestli se má vygenerovaný komprimovaný balíček zachovat i po úspěšném dokončení nahrávání.

Pokud není nastaveno, po úspěšném dokončení se komprimované balíčky aplikací odstraní. Pokud nebylo nahrání úspěšné, balíček aplikace se vždy uloží do výstupního adresáře pro opětovné nahrání.
--show-progress Zobrazení průběhu nahrávání souborů u velkých balíčků
--timeout -t Celkový časový limit v sekundách Nahrávání selže a po uplynutí časového limitu nahrávání se vrátí chyba. Tento časový limit platí pro celý balíček aplikace a jednotlivé časové limity souborů se budou rovnat zbývající době časového limitu. Časový limit nezahrnuje čas potřebný ke komprimaci balíčku aplikace. Výchozí hodnota: 300.

Globální argumenty

Argument Popis
--Ladění Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
--help -h Zobrazit tuto zprávu nápovědy a ukončit ji.
--output -o Formát výstupu. Povolené hodnoty: json, jsonc, table, tsv. Výchozí: json.
--Dotazu Řetězec dotazu JMESPath Další informace a příklady najdete v tématu http://jmespath.org/ .
--Podrobné Zvyšte úroveň podrobností protokolování. Pro úplné protokoly ladění použijte příkaz --debug.

Další kroky