Dela via


sfctl cluster

Välj, hantera och använda Service Fabric-kluster.

Kommandon

Kommando beskrivning
kodversioner Hämtar en lista över infrastrukturkodversioner som etableras i ett Service Fabric-kluster.
konfigurationsversioner Hämtar en lista över infrastrukturkonfigurationsversioner som etableras i ett Service Fabric-kluster.
hälsa Hämtar hälsotillståndet för ett Service Fabric-kluster.
manifest Hämta Service Fabric-klustermanifestet.
operation-cancel Avbryter en användarinducerad felåtgärd.
åtgärdslista Hämtar en lista över användarinducerade felåtgärder som filtreras efter angivna indata.
bestämmelse Etablera kod- eller konfigurationspaketen för ett Service Fabric-kluster.
recover-system Anger för Service Fabric-klustret att det ska försöka återställa de systemtjänster som för närvarande har fastnat i kvorumförlust.
report-health Skickar en hälsorapport i Service Fabric-klustret.
välj Ansluter till en Service Fabric-klusterslutpunkt.
show-connection Visa vilket Service Fabric-kluster den här sfctl-instansen är ansluten till.
avetablering Avetablera kod- eller konfigurationspaketen för ett Service Fabric-kluster.
uppgradera Börja uppgradera koden eller konfigurationsversionen av ett Service Fabric-kluster.
upgrade-resume Gör så att klusteruppgradering går vidare till nästa uppgraderingsdomän.
upgrade-rollback Återställ uppgraderingen av ett Service Fabric-kluster.
upgrade-status Hämtar förloppet för den aktuella klusteruppgraderingen.
upgrade-update Uppdatera uppgraderingsparametrarna för en Service Fabric-klusteruppgradering.

sfctl-klusterkodversioner

Hämtar en lista över infrastrukturkodversioner som etableras i ett Service Fabric-kluster.

Hämtar en lista med information om infrastrukturkodversioner som etableras i klustret. Parametern CodeVersion kan användas för att filtrera utdata till endast den specifika versionen.

Argument

Argument beskrivning
--code-version Produktversionen av Service Fabric.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

Argument beskrivning
--felsöka Öka loggningsverositeten för att visa alla felsökningsloggar.
--help -h Visa det här hjälpmeddelandet och avsluta.
--output -o Utdataformat. Tillåtna värden: json, jsonc, table, tsv. Standard: json.
--fråga JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
--mångordig Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

sfctl-klusterkonfigurationsversioner

Hämtar en lista över infrastrukturkonfigurationsversioner som etableras i ett Service Fabric-kluster.

Hämtar en lista med information om infrastrukturkonfigurationsversioner som etableras i klustret. Parametern ConfigVersion kan användas för att filtrera utdata till endast den specifika versionen.

Argument

Argument beskrivning
--config-version Konfigurationsversionen av Service Fabric.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

Argument beskrivning
--felsöka Öka loggningsverositeten för att visa alla felsökningsloggar.
--help -h Visa det här hjälpmeddelandet och avsluta.
--output -o Utdataformat. Tillåtna värden: json, jsonc, table, tsv. Standard: json.
--fråga JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
--mångordig Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

sfctl-klusterhälsa

Hämtar hälsotillståndet för ett Service Fabric-kluster.

Använd EventsHealthStateFilter för att filtrera samlingen av hälsohändelser som rapporterats i klustret baserat på hälsotillståndet. På samma sätt kan du använda NodesHealthStateFilter och ApplicationsHealthStateFilter för att filtrera samlingen av noder och program som returneras baserat på deras aggregerade hälsotillstånd.

Argument

Argument beskrivning
--applications-health-state-filter Tillåter filtrering av programhälsotillståndsobjekt som returneras i resultatet av klusterhälsofrågan baserat på deras hälsotillstånd. Möjliga värden för den här parametern inkluderar heltalsvärde som hämtats från medlemmar eller bitvis åtgärder på medlemmar i HealthStateFilter-uppräkning. Endast program som matchar filtret returneras. Alla program används för att utvärdera det aggregerade hälsotillståndet. Om det inte anges returneras alla poster. Tillståndsvärdena är flaggbaserad uppräkning, så värdet kan vara en kombination av dessa värden som hämtas med hjälp av bitvis "OR"-operator. Om det angivna värdet till exempel är 6 returneras hälsotillståndet för program med HealthState-värdet OK (2) och Varning (4).
– Standard – standardvärde. Matchar alla HealthState. Värdet är noll.
– Ingen – Filter som inte matchar något HealthState-värde. Används för att inte returnera några resultat för en viss samling tillstånd. Värdet är 1.
- Ok – Filter som matchar indata med HealthState-värdet Ok. Värdet är 2.
– Varning – Filter som matchar indata med HealthState-värdet Varning. Värdet är 4.
– Fel – Filter som matchar indata med HealthState-värdet Fel. Värdet är 8.
– Alla – Filter som matchar indata med alla HealthState-värden. Värdet är 65535.
--events-health-state-filter Tillåter filtrering av samlingen med HealthEvent-objekt som returneras baserat på hälsotillståndet. Möjliga värden för den här parametern inkluderar heltalsvärdet för något av följande hälsotillstånd. Endast händelser som matchar filtret returneras. Alla händelser används för att utvärdera det aggregerade hälsotillståndet. Om det inte anges returneras alla poster. Tillståndsvärdena är flaggbaserad uppräkning, så värdet kan vara en kombination av dessa värden, som erhålls med hjälp av operatorn OR på bitvis. Om det angivna värdet till exempel är 6 returneras alla händelser med HealthState-värdet OK (2) och Varning (4).
– Standard – standardvärde. Matchar alla HealthState. Värdet är noll.
– Ingen – Filter som inte matchar något HealthState-värde. Används för att inte returnera några resultat för en viss samling tillstånd. Värdet är 1.
- Ok – Filter som matchar indata med HealthState-värdet Ok. Värdet är 2.
– Varning – Filter som matchar indata med HealthState-värdet Varning. Värdet är 4.
– Fel – Filter som matchar indata med HealthState-värdet Fel. Värdet är 8.
– Alla – Filter som matchar indata med alla HealthState-värden. Värdet är 65535.
--exclude-health-statistics Anger om hälsostatistiken ska returneras som en del av frågeresultatet. Falskt som standard. Statistiken visar antalet underordnade entiteter i hälsotillståndet Ok, Varning och Fel.
--include-system-application-health-statistics Anger om hälsostatistiken ska innehålla hälsostatistik för infrastrukturresurser:/Systemprogram. Falskt som standard. Om IncludeSystemApplicationHealthStatistics har angetts till true innehåller hälsostatistiken de entiteter som tillhör infrastrukturresursen:/systemprogrammet. Annars innehåller frågeresultatet endast hälsostatistik för användarprogram. Hälsostatistiken måste ingå i frågeresultatet för att den här parametern ska tillämpas.
--nodes-health-state-filter Tillåter filtrering av nodhälsotillståndsobjekt som returneras i resultatet av klusterhälsofrågan baserat på deras hälsotillstånd. Möjliga värden för den här parametern inkluderar heltalsvärdet för något av följande hälsotillstånd. Endast noder som matchar filtret returneras. Alla noder används för att utvärdera det aggregerade hälsotillståndet. Om det inte anges returneras alla poster. Tillståndsvärdena är flaggbaserad uppräkning, så värdet kan vara en kombination av dessa värden som hämtas med hjälp av bitvis "OR"-operator. Om det angivna värdet till exempel är 6 returneras hälsotillståndet för noder med HealthState-värdet OK (2) och Varning (4).
– Standard – standardvärde. Matchar alla HealthState. Värdet är noll.
– Ingen – Filter som inte matchar något HealthState-värde. Används för att inte returnera några resultat för en viss samling tillstånd. Värdet är 1.
- Ok – Filter som matchar indata med HealthState-värdet Ok. Värdet är 2.
– Varning – Filter som matchar indata med HealthState-värdet Varning. Värdet är 4.
– Fel – Filter som matchar indata med HealthState-värdet Fel. Värdet är 8.
– Alla – Filter som matchar indata med alla HealthState-värden. Värdet är 65535.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

Argument beskrivning
--felsöka Öka loggningsverositeten för att visa alla felsökningsloggar.
--help -h Visa det här hjälpmeddelandet och avsluta.
--output -o Utdataformat. Tillåtna värden: json, jsonc, table, tsv. Standard: json.
--fråga JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
--mångordig Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

sfctl-klustermanifest

Hämta Service Fabric-klustermanifestet.

Hämta Service Fabric-klustermanifestet. Klustermanifestet innehåller egenskaper för klustret som innehåller olika nodtyper i klustret, säkerhetskonfigurationer, fel och uppgradering av domäntopologier osv. Dessa egenskaper anges som en del av ClusterConfig.JSON-filen när du distribuerar ett fristående kluster. Den mesta informationen i klustermanifestet genereras dock internt av Service Fabric under klusterdistribution i andra distributionsscenarier (t.ex. när du använder Azure-portalen). Innehållet i klustermanifestet är endast i informationssyfte och användarna förväntas inte vara beroende av filinnehållets format eller tolkning.

Argument

Argument beskrivning
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

Argument beskrivning
--felsöka Öka loggningsverositeten för att visa alla felsökningsloggar.
--help -h Visa det här hjälpmeddelandet och avsluta.
--output -o Utdataformat. Tillåtna värden: json, jsonc, table, tsv. Standard: json.
--fråga JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
--mångordig Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

sfctl cluster operation-cancel

Avbryter en användarinducerad felåtgärd.

Följande API:er startar felåtgärder som kan avbrytas med hjälp av CancelOperation: StartDataLoss, StartQuorumLoss, StartPartitionRestart, StartNodeTransition. Om force är false stoppas och rensas den angivna användarinducerade åtgärden korrekt. Om force är sant avbryts kommandot och ett internt tillstånd kan lämnas kvar. Att ange force som true ska användas med försiktighet. Att anropa det här API:et med force set till true tillåts inte förrän det här API:et redan har anropats på samma testkommando med force inställd på false först, eller såvida inte testkommandot redan har en OperationState av OperationState.RollingBack. Förtydligande: OperationState.RollingBack innebär att systemet rensar det interna systemtillståndet som orsakas av att kommandot körs. Det återställer inte data om testkommandot skulle orsaka dataförlust. Om du till exempel anropar StartDataLoss och sedan anropar det här API:et rensar systemet endast det interna tillståndet från att köra kommandot. Den återställer inte målpartitionens data om kommandot har förlopp tillräckligt långt för att orsaka dataförlust. Viktigt: om det här API:et anropas med force==true kan det interna tillståndet lämnas kvar.

Argument

Argument beskrivning
--operation-id [Krävs] Ett GUID som identifierar ett anrop för det här API:et. Detta skickas till motsvarande GetProgress API.
--kraft Anger om du korrekt ska återställa och rensa det interna systemtillståndet som ändrats genom att köra den användarinducerade åtgärden.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

Argument beskrivning
--felsöka Öka loggningsverositeten för att visa alla felsökningsloggar.
--help -h Visa det här hjälpmeddelandet och avsluta.
--output -o Utdataformat. Tillåtna värden: json, jsonc, table, tsv. Standard: json.
--fråga JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
--mångordig Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

åtgärdslista för sfctl-kluster

Hämtar en lista över användarinducerade felåtgärder som filtreras efter angivna indata.

Hämtar listan över användarinducerade felåtgärder filtrerade efter angivna indata.

Argument

Argument beskrivning
--state-filter Används för att filtrera på OperationStates för användarinducerade åtgärder. - 65535 - välj Alla - 1 - välj Running - 2 - select RollingBack - 8 - select Completed - 16 - select Faulted - 32 - select Cancelled - 64 - select ForceCancelled. Standard: 65535.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.
--type-filter Används för att filtrera på OperationType för användarinducerade åtgärder. – 65535 – välj alla – 1 – välj PartitionDataLoss. – 2 – välj PartitionQuorumLoss. – 4 – välj PartitionRestart. – 8 – välj NodeTransition. Standard: 65535.

Globala argument

Argument beskrivning
--felsöka Öka loggningsverositeten för att visa alla felsökningsloggar.
--help -h Visa det här hjälpmeddelandet och avsluta.
--output -o Utdataformat. Tillåtna värden: json, jsonc, table, tsv. Standard: json.
--fråga JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
--mångordig Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

sfctl-klusteretablering

Etablera kod- eller konfigurationspaketen för ett Service Fabric-kluster.

Verifiera och etablera kod- eller konfigurationspaketen för ett Service Fabric-kluster.

Argument

Argument beskrivning
--cluster-manifest-file-path Filsökvägen för klustermanifestet.
--code-file-path Filsökvägen för klusterkodpaketet.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

Argument beskrivning
--felsöka Öka loggningsverositeten för att visa alla felsökningsloggar.
--help -h Visa det här hjälpmeddelandet och avsluta.
--output -o Utdataformat. Tillåtna värden: json, jsonc, table, tsv. Standard: json.
--fråga JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
--mångordig Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

sfctl cluster recover-system

Anger för Service Fabric-klustret att det ska försöka återställa de systemtjänster som för närvarande har fastnat i kvorumförlust.

Anger för Service Fabric-klustret att det ska försöka återställa de systemtjänster som för närvarande har fastnat i kvorumförlust. Den här åtgärden bör endast utföras om det är känt att replikerna som är nere inte kan återställas. Felaktig användning av det här API:et kan orsaka potentiell dataförlust.

Argument

Argument beskrivning
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

Argument beskrivning
--felsöka Öka loggningsverositeten för att visa alla felsökningsloggar.
--help -h Visa det här hjälpmeddelandet och avsluta.
--output -o Utdataformat. Tillåtna värden: json, jsonc, table, tsv. Standard: json.
--fråga JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
--mångordig Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

sfctl cluster report-health

Skickar en hälsorapport i Service Fabric-klustret.

Skickar en hälsorapport i ett Service Fabric-kluster. Rapporten måste innehålla information om källan till hälsorapporten och egenskapen som den rapporteras för. Rapporten skickas till en Service Fabric-gatewaynod som vidarebefordras till hälsoarkivet. Rapporten kan godkännas av gatewayen, men avvisas av hälsoarkivet efter extra validering. Hälsoarkivet kan till exempel avvisa rapporten på grund av en ogiltig parameter, till exempel ett inaktuellt sekvensnummer. Om du vill se om rapporten har tillämpats i hälsoarkivet kör du GetClusterHealth och kontrollerar att rapporten visas i avsnittet HealthEvents.

Argument

Argument beskrivning
--health-property [Krävs] Egenskapen för hälsoinformationen.

En entitet kan ha hälsorapporter för olika egenskaper. Egenskapen är en sträng och inte en fast uppräkning så att reporterns flexibilitet kan kategorisera tillståndsvillkoret som utlöser rapporten. En reporter med SourceId "LocalWatchdog" kan till exempel övervaka tillståndet för den tillgängliga disken på en nod, så att den kan rapportera egenskapen "AvailableDisk" på noden. Samma reporter kan övervaka nodanslutningen så att den kan rapportera en egenskap "Anslutning" på samma nod. I hälsoarkivet behandlas dessa rapporter som separata hälsohändelser för den angivna noden. Tillsammans med SourceId identifierar egenskapen hälsoinformationen unikt.
--health-state [Krävs] Möjliga värden är: "Ogiltig", "Ok", "Varning", "Fel", "Okänd".
--source-id [Krävs] Källnamnet som identifierar komponenten client/watchdog/system som genererade hälsoinformationen.
--beskrivning Beskrivningen av hälsoinformationen.

Den representerar fritext som används för att lägga till läsbar information om rapporten. Den maximala stränglängden för beskrivningen är 4 096 tecken. Om den angivna strängen är längre trunkeras den automatiskt. När beskrivningen trunkeras innehåller de sista tecknen i beskrivningen en markör "[Trunkerad]", och den totala strängstorleken är 4 096 tecken. Markörens närvaro anger för användare att trunkeringen inträffade. Observera att beskrivningen har mindre än 4 096 tecken från den ursprungliga strängen när den trunkeras.
--omedelbar En flagga som anger om rapporten ska skickas omedelbart.

En hälsorapport skickas till ett Service Fabric-gatewayprogram som vidarebefordras till hälsoarkivet. Om Immediate är inställt på true skickas rapporten omedelbart från HTTP Gateway till hälsoarkivet, oavsett vilka inställningar för infrastrukturklienten som HTTP Gateway-programmet använder. Detta är användbart för kritiska rapporter som ska skickas så snart som möjligt. Beroende på tidsinställning och andra villkor kan sändningen av rapporten fortfarande misslyckas, till exempel om HTTP-gatewayen är stängd eller om meddelandet inte når gatewayen. Om Immediate är inställt på false skickas rapporten baserat på hälsoklientinställningarna från HTTP-gatewayen. Därför batchas den enligt konfigurationen HealthReportSendInterval. Det här är den rekommenderade inställningen eftersom den gör det möjligt för hälsoklienten att optimera hälsorapporteringsmeddelanden till hälsoarkivet samt bearbetning av hälsorapporter. Som standard skickas inte rapporter omedelbart.
--remove-when-expired Värde som anger om rapporten tas bort från hälsoarkivet när den upphör att gälla.

Om värdet är true tas rapporten bort från hälsoarkivet när den har upphört att gälla. Om värdet är falskt behandlas rapporten som ett fel när den har upphört att gälla. Värdet för den här egenskapen är falskt som standard. När klienter rapporterar regelbundet bör de ange RemoveWhenExpired false (standard). På så sätt har reportern problem (t.ex. dödläge) och kan inte rapportera, entiteten utvärderas vid fel när hälsorapporten upphör att gälla. Detta flaggar entiteten som i feltillstånd för hälsotillstånd.
--sequence-number Sekvensnumret för den här hälsorapporten som en numerisk sträng.

Rapportsekvensnumret används av hälsoarkivet för att identifiera inaktuella rapporter. Om det inte anges genereras ett sekvensnummer automatiskt av hälsoklienten när en rapport läggs till.
--timeout -t Standard: 60.
--Ttl Den varaktighet som hälsorapporten är giltig för. Det här fältet använder ISO8601 format för att ange varaktigheten.

När klienter rapporterar regelbundet bör de skicka rapporter med högre frekvens än tid att leva. Om klienter rapporterar om övergången kan de ange att tiden ska leva till oändlig. När time to live upphör att gälla tas hälsohändelsen som innehåller hälsoinformationen antingen bort från hälsoarkivet, om RemoveWhenExpired är sant eller utvärderas vid fel, om RemoveWhenExpired false. Om det inte anges är time to live-standardvärdet oändligt.

Globala argument

Argument beskrivning
--felsöka Öka loggningsverositeten för att visa alla felsökningsloggar.
--help -h Visa det här hjälpmeddelandet och avsluta.
--output -o Utdataformat. Tillåtna värden: json, jsonc, table, tsv. Standard: json.
--fråga JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
--mångordig Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

välj sfctl-kluster

Ansluter till en Service Fabric-klusterslutpunkt.

Om du ansluter till ett säkert kluster anger du en absolut sökväg till ett certifikat (.crt) och en nyckelfil (.key) eller en enda fil med båda (.pem). Ange inte båda. Om du ansluter till ett säkert kluster kan du också ange en absolut sökväg till en CA-paketfil eller katalog med betrodda CA-certifikat. Det finns ingen anslutning till ett kluster utan att köra det här kommandot först, inklusive en anslutning till localhost. Ingen explicit slutpunkt krävs dock för att ansluta till ett lokalt kluster. Om du använder ett självsignerat certifikat eller ett annat certifikat som inte har signerats av en välkänd certifikatutfärdare skickar du parametern --ca för att säkerställa att verifieringen godkänns. Om det inte finns i ett produktionskluster använder du alternativet --no-verify för att kringgå verifiering på klientsidan (användbart för självsignerad eller inte välkänd CA-signerad). Även om det är möjligt rekommenderas det inte för produktionskluster. Ett certifikatverifieringsfel kan leda till något annat.

Argument

Argument beskrivning
--aad Använd Microsoft Entra-ID för autentisering.
--ca Absolut sökväg till CA-certifikatkatalogen som ska behandlas som giltig eller CA-paketfil. Om du använder en katalog med CA-certifikat måste den som tillhandahålls c_rehash <directory> av OpenSSL köras först för att beräkna certifikatshasherna och skapa lämpliga symboliska länkar. Detta används för att kontrollera att certifikatet som returneras av klustret är giltigt.
--Cert Absolut sökväg till en klientcertifikatfil.
--Slutpunkt Klusterslutpunkts-URL, inklusive port- och HTTP- eller HTTPS-prefix. Slutpunkten ser vanligtvis ut ungefär som https\://<your-url>\:19080. Om ingen slutpunkt anges kommer den som standard att http\://localhost\:19080vara .
--nyckel Absolut sökväg till nyckelfilen för klientcertifikatet.
--no-verify Inaktivera verifiering av certifikat när du använder HTTPS. Observera att det här är ett osäkert alternativ och bör inte användas för produktionsmiljöer.
--Pem Absolut sökväg till klientcertifikat, som en .pem-fil.

Globala argument

Argument beskrivning
--felsöka Öka loggningsverositeten för att visa alla felsökningsloggar.
--help -h Visa det här hjälpmeddelandet och avsluta.
--output -o Utdataformat. Tillåtna värden: json, jsonc, table, tsv. Standard: json.
--fråga JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
--mångordig Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

sfctl-kluster show-connection

Visa vilket Service Fabric-kluster den här sfctl-instansen är ansluten till.

Globala argument

Argument beskrivning
--felsöka Öka loggningsverositeten för att visa alla felsökningsloggar.
--help -h Visa det här hjälpmeddelandet och avsluta.
--output -o Utdataformat. Tillåtna värden: json, jsonc, table, tsv. Standard: json.
--fråga JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
--mångordig Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

avetablering av sfctl-kluster

Avetablera kod- eller konfigurationspaketen för ett Service Fabric-kluster.

Det stöds för att avetablera kod och konfiguration separat.

Argument

Argument beskrivning
--code-version Klustrets kodpaketversion.
--config-version Klustermanifestversionen.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

Argument beskrivning
--felsöka Öka loggningsverositeten för att visa alla felsökningsloggar.
--help -h Visa det här hjälpmeddelandet och avsluta.
--output -o Utdataformat. Tillåtna värden: json, jsonc, table, tsv. Standard: json.
--fråga JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
--mångordig Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

sfctl-klusteruppgradering

Börja uppgradera koden eller konfigurationsversionen av ett Service Fabric-kluster.

Verifiera de angivna uppgraderingsparametrarna och börja uppgradera koden eller konfigurationsversionen av ett Service Fabric-kluster om parametrarna är giltiga.

Argument

Argument beskrivning
--app-health-map JSON-kodad ordlista med par med programnamn och maximalt antal fel i procent innan fel uppstår.
--app-type-health-map JSON-kodad ordlista med par med programtypsnamn och maximal procentandel som inte är felfria innan fel uppstår.
--code-version Klusterkodversionen.
--config-version Klusterkonfigurationsversionen.
--delta-health-evaluation Aktiverar utvärdering av deltahälsa i stället för absolut hälsoutvärdering efter slutförande av varje uppgraderingsdomän.
--delta-unhealthy-nodes Den maximala tillåtna procentandelen noders hälsoförsämring tillåts under klusteruppgraderingar. Standard: 10.

Deltat mäts mellan nodernas tillstånd i början av uppgraderingen och nodernas tillstånd vid tidpunkten för hälsoutvärderingen. Kontrollen utförs efter varje uppgradering av domänuppgradering för att kontrollera att klustrets globala tillstånd ligger inom tillåtna gränser.
--failure-action Möjliga värden är: 'Invalid', 'Rollback', 'Manual'.
--force-restart Processer startas om kraftigt under uppgraderingen även när kodversionen inte har ändrats.

Uppgraderingen ändrar endast konfiguration eller data.
--health-check-retry Hur lång tid det tar mellan försök att utföra hälsokontroller om programmet eller klustret inte är felfritt.
--health-check-stable Hur lång tid programmet eller klustret måste vara felfria innan uppgraderingen fortsätter till nästa uppgraderingsdomän.

Den tolkas först som en sträng som representerar en ISO 8601-varaktighet. Om det misslyckas tolkas det som ett tal som representerar det totala antalet millisekunder.
--health-check-wait Hur lång tid det tar att vänta efter att ha slutfört en uppgraderingsdomän innan du påbörjar hälsokontrollprocessen.
--replica-set-check-timeout Den maximala tiden för att blockera bearbetning av en uppgraderingsdomän och förhindra förlust av tillgänglighet när det uppstår oväntade problem.

När tidsgränsen går ut fortsätter bearbetningen av uppgraderingsdomänen oavsett problem med tillgänglighetsförlust. Tidsgränsen återställs i början av varje uppgraderingsdomän. Giltiga värden är mellan 0 och 42949672925 inkluderande.
--rolling-upgrade-mode Möjliga värden är: 'Invalid', 'UnmonitoredAuto', 'UnmonitoredManual', 'Monitored'. Standard: UnmonitoredAuto.
--timeout -t Standard: 60.
--unhealthy-applications Den maximala tillåtna procentandelen program som inte är felfria innan ett fel rapporteras.

Om du till exempel vill tillåta att 10 % av programmen inte är felfria är det här värdet 10. Procentandelen representerar den maximala tillåtna procentandelen program som kan vara felfria innan klustret betraktas som ett fel. Om procentandelen respekteras men det finns minst ett program med feltillstånd utvärderas hälsotillståndet som Varning. Detta beräknas genom att dividera antalet program som inte är felfria jämfört med det totala antalet programinstanser i klustret, exklusive program av programtyper som ingår i ApplicationTypeHealthPolicyMap. Beräkningen avrundar uppåt för att tolerera ett fel i ett litet antal program.
--unhealthy-nodes Den maximala tillåtna procentandelen ej felfria noder innan du rapporterar ett fel.

Om du till exempel vill tillåta att 10 % av noderna inte är felfria är det här värdet 10. Procentandelen representerar den maximala tillåtna procentandelen noder som kan vara felfria innan klustret betraktas som ett fel. Om procentandelen respekteras men det finns minst en nod som inte är felfri utvärderas hälsotillståndet som Varning. Procentandelen beräknas genom att dividera antalet noder med feltillstånd över det totala antalet noder i klustret. Beräkningen avrundar uppåt för att tolerera ett fel på ett litet antal noder. I stora kluster är vissa noder alltid nere eller ute för reparationer, så den här procentandelen bör konfigureras för att tolerera det.
--upgrade-domain-delta-unhealthy-nodes Den maximala tillåtna procentandelen av uppgraderingsdomännodernas hälsoförsämring tillåts under klusteruppgraderingar. Standard: 15.

Deltat mäts mellan tillståndet för uppgraderingsdomännoderna i början av uppgraderingen och tillståndet för uppgraderingsdomännoderna vid tidpunkten för hälsoutvärderingen. Kontrollen utförs efter varje uppgradering av domänuppgradering för alla slutförda uppgraderingsdomäner för att kontrollera att uppgraderingsdomänernas tillstånd ligger inom tillåtna gränser.
--upgrade-domain-timeout Hur lång tid varje uppgraderingsdomän måste slutföras innan FailureAction körs.

Den tolkas först som en sträng som representerar en ISO 8601-varaktighet. Om det misslyckas tolkas det som ett tal som representerar det totala antalet millisekunder.
--upgrade-timeout Hur lång tid den övergripande uppgraderingen måste slutföras innan FailureAction körs.

Den tolkas först som en sträng som representerar en ISO 8601-varaktighet. Om det misslyckas tolkas det som ett tal som representerar det totala antalet millisekunder.
--warning-as-error Anger om varningar behandlas med samma allvarlighetsgrad som fel.

Globala argument

Argument beskrivning
--felsöka Öka loggningsverositeten för att visa alla felsökningsloggar.
--help -h Visa det här hjälpmeddelandet och avsluta.
--output -o Utdataformat. Tillåtna värden: json, jsonc, table, tsv. Standard: json.
--fråga JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
--mångordig Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

sfctl cluster upgrade-resume

Gör så att klusteruppgradering går vidare till nästa uppgraderingsdomän.

Gör så att klusterkoden eller konfigurationsuppgraderingen går vidare till nästa uppgraderingsdomän om det är lämpligt.

Argument

Argument beskrivning
--upgrade-domain [Krävs] Nästa uppgraderingsdomän för den här klusteruppgradering.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

Argument beskrivning
--felsöka Öka loggningsverositeten för att visa alla felsökningsloggar.
--help -h Visa det här hjälpmeddelandet och avsluta.
--output -o Utdataformat. Tillåtna värden: json, jsonc, table, tsv. Standard: json.
--fråga JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
--mångordig Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

sfctl cluster upgrade-rollback

Återställ uppgraderingen av ett Service Fabric-kluster.

Återställa koden eller konfigurationsuppgraderingen av ett Service Fabric-kluster.

Argument

Argument beskrivning
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

Argument beskrivning
--felsöka Öka loggningsverositeten för att visa alla felsökningsloggar.
--help -h Visa det här hjälpmeddelandet och avsluta.
--output -o Utdataformat. Tillåtna värden: json, jsonc, table, tsv. Standard: json.
--fråga JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
--mångordig Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

uppgraderingsstatus för sfctl-kluster

Hämtar förloppet för den aktuella klusteruppgraderingen.

Hämtar den aktuella förloppet för den pågående klusteruppgraderingen. Om ingen uppgradering pågår för närvarande får du det sista tillståndet för den tidigare klusteruppgraderingen.

Argument

Argument beskrivning
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

Argument beskrivning
--felsöka Öka loggningsverositeten för att visa alla felsökningsloggar.
--help -h Visa det här hjälpmeddelandet och avsluta.
--output -o Utdataformat. Tillåtna värden: json, jsonc, table, tsv. Standard: json.
--fråga JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
--mångordig Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

uppgraderingsuppdatering för sfctl-kluster

Uppdatera uppgraderingsparametrarna för en Service Fabric-klusteruppgradering.

Argument

Argument beskrivning
--app-health-map JSON-kodad ordlista med par med programnamn och maximalt antal fel i procent innan fel uppstår.
--app-type-health-map JSON-kodad ordlista med par med programtypsnamn och maximal procentandel som inte är felfria innan fel uppstår.
--delta-health-evaluation Aktiverar utvärdering av deltahälsa i stället för absolut hälsoutvärdering efter slutförande av varje uppgraderingsdomän.
--delta-unhealthy-nodes Den maximala tillåtna procentandelen noders hälsoförsämring tillåts under klusteruppgraderingar. Standard: 10.

Deltat mäts mellan nodernas tillstånd i början av uppgraderingen och nodernas tillstånd vid tidpunkten för hälsoutvärderingen. Kontrollen utförs efter varje uppgradering av domänuppgradering för att kontrollera att klustrets globala tillstånd ligger inom tillåtna gränser.
--failure-action Möjliga värden är: 'Invalid', 'Rollback', 'Manual'.
--force-restart Processer startas om kraftigt under uppgraderingen även när kodversionen inte har ändrats.

Uppgraderingen ändrar endast konfiguration eller data.
--health-check-retry Hur lång tid det tar mellan försök att utföra hälsokontroller om programmet eller klustret inte är felfritt.
--health-check-stable Hur lång tid programmet eller klustret måste vara felfria innan uppgraderingen fortsätter till nästa uppgraderingsdomän.

Den tolkas först som en sträng som representerar en ISO 8601-varaktighet. Om det misslyckas tolkas det som ett tal som representerar det totala antalet millisekunder.
--health-check-wait Hur lång tid det tar att vänta efter att ha slutfört en uppgraderingsdomän innan du påbörjar hälsokontrollprocessen.
--replica-set-check-timeout Den maximala tiden för att blockera bearbetning av en uppgraderingsdomän och förhindra förlust av tillgänglighet när det uppstår oväntade problem.

När tidsgränsen går ut fortsätter bearbetningen av uppgraderingsdomänen oavsett problem med tillgänglighetsförlust. Tidsgränsen återställs i början av varje uppgraderingsdomän. Giltiga värden är mellan 0 och 42949672925 inkluderande.
--rolling-upgrade-mode Möjliga värden är: 'Invalid', 'UnmonitoredAuto', 'UnmonitoredManual', 'Monitored'. Standard: UnmonitoredAuto.
--timeout -t Standard: 60.
--unhealthy-applications Den maximala tillåtna procentandelen program som inte är felfria innan ett fel rapporteras.

Om du till exempel vill tillåta att 10 % av programmen inte är felfria är det här värdet 10. Procentandelen representerar den maximala tillåtna procentandelen program som kan vara felfria innan klustret betraktas som ett fel. Om procentandelen respekteras men det finns minst ett program med feltillstånd utvärderas hälsotillståndet som Varning. Detta beräknas genom att dividera antalet program som inte är felfria jämfört med det totala antalet programinstanser i klustret, exklusive program av programtyper som ingår i ApplicationTypeHealthPolicyMap. Beräkningen avrundar uppåt för att tolerera ett fel i ett litet antal program.
--unhealthy-nodes Den maximala tillåtna procentandelen ej felfria noder innan du rapporterar ett fel.

Om du till exempel vill tillåta att 10 % av noderna inte är felfria är det här värdet 10. Procentandelen representerar den maximala tillåtna procentandelen noder som kan vara felfria innan klustret betraktas som ett fel. Om procentandelen respekteras men det finns minst en nod som inte är felfri utvärderas hälsotillståndet som Varning. Procentandelen beräknas genom att dividera antalet noder med feltillstånd över det totala antalet noder i klustret. Beräkningen avrundar uppåt för att tolerera ett fel på ett litet antal noder. I stora kluster är vissa noder alltid nere eller ute för reparationer, så den här procentandelen bör konfigureras för att tolerera det.
--upgrade-domain-delta-unhealthy-nodes Den maximala tillåtna procentandelen av uppgraderingsdomännodernas hälsoförsämring tillåts under klusteruppgraderingar. Standard: 15.

Deltat mäts mellan tillståndet för uppgraderingsdomännoderna i början av uppgraderingen och tillståndet för uppgraderingsdomännoderna vid tidpunkten för hälsoutvärderingen. Kontrollen utförs efter varje uppgradering av domänuppgradering för alla slutförda uppgraderingsdomäner för att kontrollera att uppgraderingsdomänernas tillstånd ligger inom tillåtna gränser.
--upgrade-domain-timeout Hur lång tid varje uppgraderingsdomän måste slutföras innan FailureAction körs.

Den tolkas först som en sträng som representerar en ISO 8601-varaktighet. Om det misslyckas tolkas det som ett tal som representerar det totala antalet millisekunder.
--upgrade-kind Möjliga värden är: "Ogiltig", "Rullande", "Rolling_ForceRestart". Standard: Rullande.
--upgrade-timeout Hur lång tid den övergripande uppgraderingen måste slutföras innan FailureAction körs.

Den tolkas först som en sträng som representerar en ISO 8601-varaktighet. Om det misslyckas tolkas det som ett tal som representerar det totala antalet millisekunder.
--warning-as-error Anger om varningar behandlas med samma allvarlighetsgrad som fel.

Globala argument

Argument beskrivning
--felsöka Öka loggningsverositeten för att visa alla felsökningsloggar.
--help -h Visa det här hjälpmeddelandet och avsluta.
--output -o Utdataformat. Tillåtna värden: json, jsonc, table, tsv. Standard: json.
--fråga JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
--mångordig Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Nästa steg

  • Konfigurera Service Fabric CLI.
  • Lär dig hur du använder Service Fabric CLI med hjälp av exempelskripten.