sfctl cluster
Vyberte, spravujte a provoz clusterů Service Fabric.
Příkazy
| Příkaz | Popis |
|---|---|
| code-versions | Získá seznam verzí kódu infrastruktury, které jsou zřízené v clusteru Service Fabric. |
| config-versions | Získá seznam verzí konfigurace prostředků infrastruktury, které jsou zřízené v clusteru Service Fabric. |
| zdravotnictví | Získá stav clusteru Service Fabric. |
| manifest | Získejte manifest clusteru Service Fabric. |
| operation-cancel | Zruší operaci selhání vyvolanou uživatelem. |
| seznam operací | Získá seznam uživatelsky indukovaných chybových operací filtrovaných zadaným vstupem. |
| provision | Zřiďte kód nebo konfigurační balíčky clusteru Service Fabric. |
| recover-system | Označuje cluster Service Fabric, že by se měl pokusit obnovit systémové služby, které jsou aktuálně zablokované při ztrátě kvora. |
| stav sestavy | Odešle zprávu o stavu v clusteru Service Fabric. |
| Vyberte jednu z možností. | Připojí se ke koncovému bodu clusteru Service Fabric. |
| show-connection | Umožňuje zobrazit, ke kterému clusteru Service Fabric je tato instance sfctl připojena. |
| zrušení zřízení | Zrušte zřízení kódu nebo konfiguračních balíčků clusteru Service Fabric. |
| upgrade | Začněte upgradovat kód nebo verzi konfigurace clusteru Service Fabric. |
| upgrade-resume | Upgradujte cluster na další doménu upgradu. |
| upgrade a vrácení zpět | Vrácení upgradu clusteru Service Fabric zpět |
| stav upgradu | Získá průběh aktuálního upgradu clusteru. |
| upgrade-update | Aktualizujte parametry upgradu upgradu clusteru Service Fabric. |
sfctl cluster code-versions
Získá seznam verzí kódu infrastruktury, které jsou zřízené v clusteru Service Fabric.
Získá seznam informací o verzích kódu infrastruktury, které jsou zřízené v clusteru. Parametr CodeVersion lze použít k volitelnému filtrování výstupu pouze na danou konkrétní verzi.
Argumenty
| Argument | Popis |
|---|---|
| --code-version | Verze produktu Service Fabric. |
| --timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný 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 |
|---|---|
| --ladicí | 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í hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl cluster config-versions
Získá seznam verzí konfigurace prostředků infrastruktury, které jsou zřízené v clusteru Service Fabric.
Získá seznam informací o verzích konfigurace prostředků infrastruktury, které jsou zřízeny v clusteru. Parametr ConfigVersion lze použít k volitelnému filtrování výstupu pouze na konkrétní verzi.
Argumenty
| Argument | Popis |
|---|---|
| --config-version | Verze konfigurace Service Fabric. |
| --timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný 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 |
|---|---|
| --ladicí | 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í hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl cluster health
Získá stav clusteru Service Fabric.
Pomocí eventsHealthStateFilter můžete filtrovat kolekci událostí stavu hlášených v clusteru na základě stavu. Podobně použijte NodesHealthStateFilter a ApplicationsHealthStateFilter k filtrování kolekce uzlů a aplikací vrácených na základě jejich agregovaného stavu.
Argumenty
| Argument | Popis |
|---|---|
| --applications-health-state-filter | Umožňuje filtrovat objekty stavu aplikace vrácené v důsledku dotazu na stav clusteru na základě jejich stavu. Možné hodnoty pro tento parametr zahrnují celočíselnou hodnotu získanou ze členů nebo bitové operace u členů výčtu HealthStateFilter. Vrátí se jenom aplikace, které odpovídají filtru. Všechny aplikace se používají k vyhodnocení agregovaného stavu. Pokud není zadáno, 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 získaných pomocí bitového operátoru OR. Pokud je například zadaná hodnota 6, vrátí se stav aplikací s hodnotou HealthState OK (2) a Upozornění (4). - Výchozí – Výchozí hodnota. Odpovídá stavu. Hodnota je nula. – Žádné – Filtr, který neodpovídá žádné hodnotě HealthState. Slouží k vrácení žádných výsledků pro danou 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. - Chyba – 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 objektů HealthEvent vrácených na základě stavu. Možné hodnoty pro tento parametr 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. Pokud není zadáno, vrátí se všechny položky. Hodnoty stavu jsou výčty založené na příznaku, takže hodnota by mohla být kombinací těchto hodnot, získaná pomocí bitového operátoru OR. Pokud je zadaná hodnota například 6, vrátí se všechny události s hodnotou HealthState OK (2) a Warning (4). - Výchozí – Výchozí hodnota. Odpovídá stavu. Hodnota je nula. – Žádné – Filtr, který neodpovídá žádné hodnotě HealthState. Slouží k vrácení žádných výsledků pro danou 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. - Chyba – 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 má statistika stavu vrátit jako součást výsledku dotazu. Ve výchozím nastavení je false. Statistika zobrazuje počet podřízených entit ve stavu OK, Upozornění a Chyba. |
| --include-system-application-health-statistics | Určuje, jestli by statistika stavu měla obsahovat statistiky stavu infrastruktury:/Systémová statistika stavu aplikace. Ve výchozím nastavení je false. Pokud je vlastnost IncludeSystemApplicationHealthStatistics nastavená na hodnotu true, zahrnují statistiky stavu entity, které patří do aplikace fabric:/System. V opačném případě výsledek dotazu zahrnuje statistiky stavu pouze pro uživatelské aplikace. Statistika stavu musí být zahrnuta do výsledku dotazu, aby se tento parametr použil. |
| --nodes-health-state-filter | Umožňuje filtrovat objekty stavu uzlu vrácené v důsledku dotazu na stav clusteru na základě jejich stavu. Možné hodnoty pro tento parametr zahrnují celočíselnou hodnotu jednoho z následujících stavů. Vrátí se pouze uzly, které odpovídají filtru. Všechny uzly slouží k vyhodnocení agregovaného stavu. Pokud není zadáno, 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 získaných pomocí bitového operátoru OR. Pokud je zadaná hodnota například 6, vrátí se stav uzlů s hodnotou HealthState OK (2) a Upozornění (4). - Výchozí – Výchozí hodnota. Odpovídá stavu. Hodnota je nula. – Žádné – Filtr, který neodpovídá žádné hodnotě HealthState. Slouží k vrácení žádných výsledků pro danou 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. - Chyba – 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 ochotný 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 |
|---|---|
| --ladicí | 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í hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
manifest clusteru sfctl
Získejte manifest clusteru Service Fabric.
Získejte manifest clusteru Service Fabric. Manifest clusteru obsahuje vlastnosti clusteru, které zahrnují různé typy uzlů v clusteru, konfigurace zabezpečení, chyby a upgradování topologií domény atd. Tyto vlastnosti se zadají jako součást souboru ClusterConfig.JSON při nasazování samostatného clusteru. Většina informací v manifestu clusteru se ale interně generuje službou Service Fabric během nasazování clusteru v jiných scénářích nasazení (např. při použití webu Azure Portal). Obsah manifestu clusteru je určený pouze pro informační účely a uživatelé se neočekávají, že budou záviset na formátu obsahu souboru nebo jeho interpretaci.
Argumenty
| Argument | Popis |
|---|---|
| --timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný 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 |
|---|---|
| --ladicí | 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í hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl cluster operation-cancel
Zruší operaci selhání vyvolanou uživatelem.
Následující rozhraní API spouští operace selhání, které mohou být zrušeny pomocí CancelOperation: StartDataLoss, StartQuorumLoss, StartPartitionRestart, StartNodeTransition. Pokud je hodnota force false, bude zadaná operace indukovaná uživatelem řádně zastavena a vyčištěna. Pokud je hodnota force true, příkaz se přeruší a některé vnitřní stavy můžou zůstat za sebou. Zadání síly jako true by mělo být použito s opatrností. Volání tohoto rozhraní API s vynuceným nastavením na hodnotu true není povoleno, dokud toto rozhraní API již není volána na stejném testovacím příkazu s vynuceným nastavením na hodnotu false, nebo pokud testovací příkaz již nemá OperationState of OperationState.RollingBack. Vysvětlení: OperationState.RollingBack znamená, že systém bude nebo vyčistit vnitřní stav systému způsobený spuštěním příkazu. Pokud testovací příkaz způsobil ztrátu dat, data se neobnoví. Pokud například zavoláte StartDataLoss, zavolá toto rozhraní API, systém vyčistí pouze interní stav spuštěním příkazu. Pokud příkaz postupoval dostatečně daleko, aby způsobil ztrátu dat, neobnoví data cílového oddílu. Důležitá poznámka: Pokud je toto rozhraní API vyvoláno pomocí force==true, může zůstat vnitřní stav za sebou.
Argumenty
| Argument | Popis |
|---|---|
| --operation-id [Povinné] | Identifikátor GUID, který identifikuje volání tohoto rozhraní API. To se předá do odpovídajícího rozhraní GetProgress API. |
| --síla | Určuje, zda se má řádně vrátit zpět a vyčistit stav interního systému upravený spuštěním operace vyvolané uživatelem. |
| --timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný 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 |
|---|---|
| --ladicí | 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í hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl cluster operation-list
Získá seznam uživatelsky indukovaných chybových operací filtrovaných zadaným vstupem.
Získá seznam uživatelsky indukovaných chybových operací filtrovaných zadaným vstupem.
Argumenty
| Argument | Popis |
|---|---|
| --state-filter | Slouží k filtrování podle operationstate pro operace vyvolané uživatelem. - 65535 - vybrat Vše - 1 - vybrat Spuštěno - 2 - select RollingBack - 8 - select Completed - 16 - select Faulted - 32 - select Cancelled - 64 - select ForceCancelled. Výchozí hodnota: 65535. |
| --timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný počkat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund. Výchozí hodnota: 60. |
| --type-filter | Slouží k filtrování typu OperationType pro operace vyvolané uživatelem. - 65535 - vyberte vše - 1 - vyberte PartitionDataLoss. - 2 - vyberte PartitionQuorumLoss. - 4 – vyberte PartitionRestart. - 8 – vyberte NodeTransition. Výchozí hodnota: 65535. |
Globální argumenty
| Argument | Popis |
|---|---|
| --ladicí | 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í hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl cluster provision
Zřiďte kód nebo konfigurační balíčky clusteru Service Fabric.
Ověřte a zřiďte kód nebo konfigurační balíčky clusteru Service Fabric.
Argumenty
| Argument | Popis |
|---|---|
| --cluster-manifest-file-path | Cesta k souboru manifestu clusteru. |
| --code-file-path | Cesta k souboru balíčku kódu clusteru. |
| --timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný 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 |
|---|---|
| --ladicí | 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í hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl cluster recover-system
Označuje cluster Service Fabric, že by se měl pokusit obnovit systémové služby, které jsou aktuálně zablokované při ztrátě kvora.
Označuje cluster Service Fabric, že by se měl pokusit obnovit systémové služby, které jsou aktuálně zablokované při ztrátě kvora. Tato operace by se měla provést pouze v případě, že je známo, že repliky, které jsou vypnuté, nelze obnovit. Nesprávné použití tohoto rozhraní API může způsobit potenciální ztrátu dat.
Argumenty
| Argument | Popis |
|---|---|
| --timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný 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 |
|---|---|
| --ladicí | 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í hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl cluster report-health
Odešle zprávu o stavu v clusteru Service Fabric.
Odešle zprávu o stavu v clusteru Service Fabric. Sestava musí obsahovat informace o zdroji sestavy stavu a vlastnosti, na které je hlášena. Sestava se odešle do uzlu brány Service Fabric, který se přepošle do úložiště stavu. Sestavu může brána přijmout, ale po dodatečném ověření ji odmítne úložiště stavu. Úložiště stavu může například odmítnout sestavu kvůli neplatnému parametru, jako je zastaralé pořadové číslo. Pokud chcete zjistit, jestli se sestava použila v úložišti stavu, spusťte GetClusterHealth a zkontrolujte, jestli se sestava zobrazí v části HealthEvents.
Argumenty
| Argument | Popis |
|---|---|
| --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 flexibilitu reporteru zařadit do kategorií stavovou podmínku, která aktivuje sestavu. Například reportér s Id SourceId "LocalWatchdog" může monitorovat stav dostupného disku na uzlu, takže může na tomto uzlu hlásit vlastnost AvailableDisk. Stejný reportér může monitorovat připojení uzlu, takže může na stejném uzlu hlásit vlastnost Připojení. V úložišti stavu se tyto sestavy považují za samostatné události stavu pro zadaný uzel. Spolu s SourceId vlastnost jedinečně identifikuje informace o stavu. |
| --health-state [Povinné] | Mezi možné hodnoty patří: Invalid, Ok, Warning, Error, Unknown. |
| --source-id [Povinné] | Název zdroje identifikující komponentu client/watchdog/system, která vygenerovala informace o stavu. |
| --popis | Popis informací o stavu. Představuje bezplatný text, který slouží k přidání čitelných informací o sestavě. Maximální délka řetězce popisu je 4096 znaků. Pokud je zadaný řetězec delší, automaticky se zkrátí. Při zkrácení obsahují poslední znaky popisu značku [Zkrácené]" a celková velikost řetězce je 4096 znaků. Přítomnost značky značí uživatelům, že došlo ke zkrácení. Všimněte si, že po zkrácení má popis méně než 4096 znaků z původního řetězce. |
| --bezprostřední | Příznak, který označuje, jestli se má sestava odeslat okamžitě. Sestava stavu se odešle do aplikace služby Service Fabric Gateway, která se předá do úložiště stavu. Pokud je hodnota Immediate nastavená na hodnotu true, sestava se odešle okamžitě ze služby HTTP Gateway do úložiště stavu bez ohledu na nastavení klienta infrastruktury, které aplikace služby HTTP Gateway používá. To je užitečné pro kritické sestavy, které by se měly odesílat co nejdříve. V závislosti na načasování a dalších podmínkách může odesílání sestavy selhat, například pokud je brána HTTP zavřená nebo se zpráva nedosáhne k bráně. Pokud je hodnota Immediate nastavená na hodnotu false, sestava se odešle na základě nastavení klienta stavu z brány HTTP. Proto bude dávková podle konfigurace HealthReportSendInterval. Toto je doporučené nastavení, protože umožňuje klientovi stavu optimalizovat zprávy sestav o stavu do úložiště stavu a zpracování sestav stavu. Ve výchozím nastavení se sestavy neodesílají okamžitě. |
| --remove-when-expired | Hodnota, která označuje, jestli je sestava po vypršení platnosti odebrána z úložiště stavu. Pokud je nastavená hodnota true, sestava se po vypršení platnosti odebere z úložiště stavu. Pokud je nastavená hodnota false, sestava se při vypršení platnosti považuje za chybu. Hodnota této vlastnosti je ve výchozím nastavení false. Když klienti pravidelně hlásí, měli by nastavit hodnotu RemoveWhenExpired false (výchozí). To znamená, že reportér má problémy (např. zablokování) a nemůže hlásit, entita se vyhodnocuje při chybě, když vyprší platnost sestavy stavu. Tím se entita označí jako v chybovém stavu. |
| --sequence-number | Pořadové číslo pro tuto sestavu stavu jako číselný řetězec. Pořadové číslo sestavy používá úložiště stavu k detekci zastaralých sestav. Pokud není zadáno, klient stavu při přidání sestavy automaticky vygeneruje pořadové číslo. |
| --timeout -t | Výchozí hodnota: 60. |
| --hodnota ttl | Doba trvání, po kterou je tato zpráva o stavu platná. Toto pole používá pro zadání doby trvání formát ISO8601. Když klienti pravidelně hlásí, měli by odesílat sestavy s vyšší frekvencí, než je čas naživo. Pokud se klienti hlásí při přechodu, můžou nastavit dobu, po kterou se bude žít, na nekonečno. Když vyprší platnost časového limitu, událost stavu obsahující informace o stavu se buď odebere z úložiště stavu, pokud je RemoveWhenExpired true nebo vyhodnocena při chybě, pokud RemoveWhenExpired false. Pokud není zadaný, nastaví se výchozí hodnota času na nekonečnou hodnotu. |
Globální argumenty
| Argument | Popis |
|---|---|
| --ladicí | 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í hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl cluster select
Připojí se ke koncovému bodu clusteru Service Fabric.
Pokud se připojujete k zabezpečenému clusteru, zadejte absolutní cestu k certifikátu (.crt) a souboru klíče (.key) nebo jeden soubor s oběma soubory (.pem). Nezadávejte obojí. Volitelně platí, že pokud se připojujete k zabezpečenému clusteru, zadejte také absolutní cestu k souboru sady certifikační autority nebo adresáři důvěryhodných certifikátů certifikační autority. Bez spuštění tohoto příkazu není k clusteru žádné připojení, včetně připojení k localhostu. Pro připojení k místnímu clusteru se ale nevyžaduje žádný explicitní koncový bod. Pokud používáte certifikát podepsaný svým držitelem nebo jiný certifikát, který není podepsaný známou certifikační autoritou, předejte parametr --ca, abyste zajistili, že ověření projde. Pokud ne v produkčním clusteru, použijte možnost --no-verify pro ověření na straně klienta (užitečné pro podepsané svým držitelem nebo není známou certifikační autoritou). I když je to možné, nedoporučuje se pro produkční clustery. Jinak může dojít k chybě ověření certifikátu.
Argumenty
| Argument | Popis |
|---|---|
| --aad | Pro ověřování použijte ID Microsoft Entra. |
| --ca | Absolutní cesta k adresáři certifikátů certifikační autority, která má zacházet jako s platným souborem nebo souborem sady certifikační autority. Pokud používáte adresář certifikátů certifikační autority, který poskytuje OpenSSL, c_rehash <directory> musí být nejprve spuštěn, aby bylo možné vypočítat hodnoty hash certifikátů a vytvořit odpovídající symbolické odkazy. Slouží k ověření platnosti certifikátu vráceného clusterem. |
| --hotovka | Absolutní cesta k souboru klientského certifikátu. |
| --zakončení | Adresa URL koncového bodu clusteru, včetně portu a předpony HTTP nebo HTTPS Koncový bod obvykle bude vypadat nějak takto https\://<your-url>\:19080. Pokud žádný koncový bod není zadaný, použije se výchozí hodnota http\://localhost\:19080. |
| --klíč | Absolutní cesta k souboru klíče certifikátu klienta |
| --no-verify | Zakažte ověřování certifikátů při použití protokolu HTTPS. Poznámka: Jedná se o nezabezpečenou možnost a neměla by se používat pro produkční prostředí. |
| --Pem | Absolutní cesta k klientskému certifikátu jako souboru .pem. |
Globální argumenty
| Argument | Popis |
|---|---|
| --ladicí | 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í hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl cluster show-connection
Umožňuje zobrazit, ke kterému clusteru Service Fabric je tato instance sfctl připojena.
Globální argumenty
| Argument | Popis |
|---|---|
| --ladicí | 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í hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
Zrušení zřízení clusteru sfctl
Zrušte zřízení kódu nebo konfiguračních balíčků clusteru Service Fabric.
Podporuje se samostatné zřízení kódu a konfigurace.
Argumenty
| Argument | Popis |
|---|---|
| --code-version | Verze balíčku kódu clusteru. |
| --config-version | Verze manifestu clusteru. |
| --timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný 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 |
|---|---|
| --ladicí | 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í hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl cluster upgrade
Začněte upgradovat kód nebo verzi konfigurace clusteru Service Fabric.
Ověřte zadané parametry upgradu a spusťte upgrade kódu nebo verze konfigurace clusteru Service Fabric, pokud jsou parametry platné.
Argumenty
| Argument | Popis |
|---|---|
| --app-health-map | Před vyvolání chyby kódovaný slovník JSON párů názvu aplikace a maximální procento, které není v pořádku. |
| --app-type-health-map | Kódovaný slovník JSON párů názvu typu aplikace a maximální procento, které není v pořádku před vyvolání chyby |
| --code-version | Verze kódu clusteru. |
| --config-version | Verze konfigurace clusteru. |
| --delta-health-evaluation | Povolí po dokončení každé upgradovací domény rozdílové vyhodnocení stavu místo absolutního vyhodnocení stavu. |
| --delta-není v pořádku-uzly | Maximální povolené procento snížení stavu uzlů je povolené během upgradů clusteru. Výchozí hodnota: 10. Rozdíl se měří mezi stavem uzlů na začátku upgradu a stavem uzlů v době vyhodnocení stavu. Kontrola se provede po dokončení každého upgradu domény, aby se zajistilo, že globální stav clusteru je v rámci tolerovaných limitů. |
| --failure-action | Mezi možné hodnoty patří: Invalid, Rollback, Manual. |
| --force-restart | Procesy se během upgradu nutí restartovat, i když se verze kódu nezměnila. Upgrade změní pouze konfiguraci nebo data. |
| --health-check-retry | Doba mezi pokusy o provedení kontrol stavu, pokud aplikace nebo cluster nejsou v pořádku. |
| --health-check-stable | Doba, po kterou musí aplikace nebo cluster zůstat v pořádku, než upgrade přejde na další doménu upgradu. 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 | Doba čekání po dokončení upgradovací domény před spuštěním procesu kontroly stavu. |
| --replica-set-check-timeout | Maximální doba blokování zpracování domény upgradu a zabránění ztrátě dostupnosti, pokud dojde k neočekávaným problémům. Po vypršení tohoto časového limitu bude zpracování domény upgradu pokračovat bez ohledu na problémy se ztrátou dostupnosti. Časový limit se resetuje na začátku každé upgradování domény. Platné hodnoty jsou mezi 0 a 42949672925 včetně. |
| --rolling-upgrade-mode | Mezi možné hodnoty patří: Invalid, UnmonitoredAuto, UnmonitoredManual, Monitorované. Výchozí: NemonitorovanýAuto. |
| --timeout -t | Výchozí hodnota: 60. |
| --není v pořádku-aplikace | Maximální povolené procento aplikací, které nejsou v pořádku, před hlášením chyby Pokud například chcete umožnit, aby 10 % aplikací bylo v pořádku, bude tato hodnota 10. Procento představuje maximální tolerované procento aplikací, které mohou být v pořádku, než se cluster považuje za chybný. Pokud se procento respektuje, ale existuje alespoň jedna aplikace, která není v pořádku, vyhodnotí se stav jako Upozornění. Vypočítá se tak, že vydělíte počet aplikací, které nejsou v pořádku, na celkový počet instancí aplikace v clusteru, s výjimkou aplikací typů aplikací, které jsou zahrnuty v Objektu ApplicationTypeHealthPolicyMap. Výpočet zaokrouhlí nahoru tak, aby toleroval jedno selhání u malých čísel aplikací. |
| --není v pořádku-uzly | Maximální povolené procento uzlů, které nejsou v pořádku, před hlášením chyby. Pokud například chcete povolit, aby 10 % uzlů šlo v pořádku, bude tato hodnota 10. Procento představuje maximální tolerované procento uzlů, které může být v pořádku, než se cluster považuje za chybný. Pokud se procento respektuje, ale existuje alespoň jeden uzel, který není v pořádku, vyhodnotí se stav jako Upozornění. Procento se vypočítá tak, že vydělí počet uzlů, které nejsou v pořádku, nad celkovým počtem uzlů v clusteru. Výpočet zaokrouhlí nahoru tak, aby toleroval jedno selhání u malých čísel uzlů. Ve velkých clusterech budou některé uzly vždy mimo provoz pro opravy, takže toto procento by mělo být nakonfigurované tak, aby tolerovaly. |
| --upgrade-domain-delta-nezdravé-uzly | Maximální povolené procento snížení stavu uzlů domény upgradu je povolené během upgradů clusteru. Výchozí hodnota: 15. Rozdíl se měří mezi stavem uzlů domény upgradu na začátku upgradu a stavem uzlů domény upgradu v době vyhodnocení stavu. Kontrola se provede po dokončení upgradu všech dokončených upgradovaných domén pro všechny dokončené upgradovací domény, aby se zajistilo, že stav upgradovaných domén je v rámci tolerovaných limitů. |
| --upgrade-domain-timeout | Doba, po kterou se musí každá upgradovaná doména dokončit, než se provede FailureAction. 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 se musí celkový upgrade dokončit, než se provede FailureAction. 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, zda jsou upozornění zpracovávána se stejnou závažností jako chyby. |
Globální argumenty
| Argument | Popis |
|---|---|
| --ladicí | 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í hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl cluster upgrade-resume
Upgradujte cluster na další doménu upgradu.
V případě potřeby přejděte kód clusteru nebo upgrade konfigurace na další doménu upgradu.
Argumenty
| Argument | Popis |
|---|---|
| --upgrade-domain [Povinné] | Další upgrade domény pro tento upgrade clusteru. |
| --timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný 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 |
|---|---|
| --ladicí | 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í hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl cluster upgrade-rollback
Vrácení upgradu clusteru Service Fabric zpět
Vrácení kódu nebo upgradu konfigurace clusteru Service Fabric
Argumenty
| Argument | Popis |
|---|---|
| --timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný 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 |
|---|---|
| --ladicí | 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í hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl cluster upgrade-status
Získá průběh aktuálního upgradu clusteru.
Získá aktuální průběh probíhajícího upgradu clusteru. Pokud právě neprobíhá žádný upgrade, získejte poslední stav předchozího upgradu clusteru.
Argumenty
| Argument | Popis |
|---|---|
| --timeout -t | Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochotný 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 |
|---|---|
| --ladicí | 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í hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
sfctl cluster upgrade-update
Aktualizujte parametry upgradu upgradu clusteru Service Fabric.
Argumenty
| Argument | Popis |
|---|---|
| --app-health-map | Před vyvolání chyby kódovaný slovník JSON párů názvu aplikace a maximální procento, které není v pořádku. |
| --app-type-health-map | Kódovaný slovník JSON párů názvu typu aplikace a maximální procento, které není v pořádku před vyvolání chyby |
| --delta-health-evaluation | Povolí po dokončení každé upgradovací domény rozdílové vyhodnocení stavu místo absolutního vyhodnocení stavu. |
| --delta-není v pořádku-uzly | Maximální povolené procento snížení stavu uzlů je povolené během upgradů clusteru. Výchozí hodnota: 10. Rozdíl se měří mezi stavem uzlů na začátku upgradu a stavem uzlů v době vyhodnocení stavu. Kontrola se provede po dokončení každého upgradu domény, aby se zajistilo, že globální stav clusteru je v rámci tolerovaných limitů. |
| --failure-action | Mezi možné hodnoty patří: Invalid, Rollback, Manual. |
| --force-restart | Procesy se během upgradu nutí restartovat, i když se verze kódu nezměnila. Upgrade změní pouze konfiguraci nebo data. |
| --health-check-retry | Doba mezi pokusy o provedení kontrol stavu, pokud aplikace nebo cluster nejsou v pořádku. |
| --health-check-stable | Doba, po kterou musí aplikace nebo cluster zůstat v pořádku, než upgrade přejde na další doménu upgradu. 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 | Doba čekání po dokončení upgradovací domény před spuštěním procesu kontroly stavu. |
| --replica-set-check-timeout | Maximální doba blokování zpracování domény upgradu a zabránění ztrátě dostupnosti, pokud dojde k neočekávaným problémům. Po vypršení tohoto časového limitu bude zpracování domény upgradu pokračovat bez ohledu na problémy se ztrátou dostupnosti. Časový limit se resetuje na začátku každé upgradování domény. Platné hodnoty jsou mezi 0 a 42949672925 včetně. |
| --rolling-upgrade-mode | Mezi možné hodnoty patří: Invalid, UnmonitoredAuto, UnmonitoredManual, Monitorované. Výchozí: NemonitorovanýAuto. |
| --timeout -t | Výchozí hodnota: 60. |
| --není v pořádku-aplikace | Maximální povolené procento aplikací, které nejsou v pořádku, před hlášením chyby Pokud například chcete umožnit, aby 10 % aplikací bylo v pořádku, bude tato hodnota 10. Procento představuje maximální tolerované procento aplikací, které mohou být v pořádku, než se cluster považuje za chybný. Pokud se procento respektuje, ale existuje alespoň jedna aplikace, která není v pořádku, vyhodnotí se stav jako Upozornění. Vypočítá se tak, že vydělíte počet aplikací, které nejsou v pořádku, na celkový počet instancí aplikace v clusteru, s výjimkou aplikací typů aplikací, které jsou zahrnuty v Objektu ApplicationTypeHealthPolicyMap. Výpočet zaokrouhlí nahoru tak, aby toleroval jedno selhání u malých čísel aplikací. |
| --není v pořádku-uzly | Maximální povolené procento uzlů, které nejsou v pořádku, před hlášením chyby. Pokud například chcete povolit, aby 10 % uzlů šlo v pořádku, bude tato hodnota 10. Procento představuje maximální tolerované procento uzlů, které může být v pořádku, než se cluster považuje za chybný. Pokud se procento respektuje, ale existuje alespoň jeden uzel, který není v pořádku, vyhodnotí se stav jako Upozornění. Procento se vypočítá tak, že vydělí počet uzlů, které nejsou v pořádku, nad celkovým počtem uzlů v clusteru. Výpočet zaokrouhlí nahoru tak, aby toleroval jedno selhání u malých čísel uzlů. Ve velkých clusterech budou některé uzly vždy mimo provoz pro opravy, takže toto procento by mělo být nakonfigurované tak, aby tolerovaly. |
| --upgrade-domain-delta-nezdravé-uzly | Maximální povolené procento snížení stavu uzlů domény upgradu je povolené během upgradů clusteru. Výchozí hodnota: 15. Rozdíl se měří mezi stavem uzlů domény upgradu na začátku upgradu a stavem uzlů domény upgradu v době vyhodnocení stavu. Kontrola se provede po dokončení upgradu všech dokončených upgradovaných domén pro všechny dokončené upgradovací domény, aby se zajistilo, že stav upgradovaných domén je v rámci tolerovaných limitů. |
| --upgrade-domain-timeout | Doba, po kterou se musí každá upgradovaná doména dokončit, než se provede FailureAction. 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-kind | Mezi možné hodnoty patří: Invalid, Rolling, Rolling_ForceRestart. Výchozí hodnota: Postupné. |
| --upgrade-timeout | Doba, po kterou se musí celkový upgrade dokončit, než se provede FailureAction. 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, zda jsou upozornění zpracovávána se stejnou závažností jako chyby. |
Globální argumenty
| Argument | Popis |
|---|---|
| --ladicí | 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í hodnota: json. |
| --dotaz | Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu. |
| --užvaněný | Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug. |
Další kroky
- Nastavení rozhraní příkazového řádku Service Fabric
- Naučte se používat Service Fabric CLI pomocí ukázkových skriptů.