sfctl replica
Hantera replikerna som tillhör tjänstpartitioner.
Kommandon
| Kommando | beskrivning |
|---|---|
| Distribuerat | Hämtar information om repliken som distribueras på en Service Fabric-nod. |
| deployed-list | Hämtar listan över repliker som distribuerats på en Service Fabric-nod. |
| hälsa | Hämtar hälsotillståndet för en tillståndskänslig Service Fabric-tjänstreplik eller tillståndslös tjänstinstans. |
| information | Hämtar information om en replik av en Service Fabric-partition. |
| lista | Hämtar information om repliker av en Service Fabric-tjänstpartition. |
| ta bort | Tar bort en tjänstreplik som körs på en nod. |
| report-health | Skickar en hälsorapport på Service Fabric-repliken. |
| restart | Startar om en tjänstreplik av en beständiga tjänst som körs på en nod. |
sfctl-replik distribuerad
Hämtar information om repliken som distribueras på en Service Fabric-nod.
Hämtar information om repliken som distribueras på en Service Fabric-nod. Informationen omfattar tjänsttyp, tjänstnamn, aktuell tjänståtgärd, startdatum för aktuell tjänståtgärd, partitions-ID, replik-/instans-ID, rapporterad belastning och annan information.
Argument
| Argument | beskrivning |
|---|---|
| --node-name [Krävs] | Namnet på noden. |
| --partition-id [Krävs] | Partitionens identitet. |
| --replica-id [Krävs] | Replikens identifierare. |
| --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 replica deployed-list
Hämtar listan över repliker som distribuerats på en Service Fabric-nod.
Hämtar listan med information om repliker som distribuerats på en Service Fabric-nod. Informationen omfattar partitions-ID, replik-ID, status för repliken, namnet på tjänsten, namnet på tjänsttypen och annan information. Använd Frågeparametrarna PartitionId eller ServiceManifestName för att returnera information om de distribuerade replikerna som matchar de angivna värdena för dessa parametrar.
Argument
| Argument | beskrivning |
|---|---|
| --application-id [Krävs] | Programmets identitet. Detta är vanligtvis det fullständiga namnet på programmet utan URI-schemat "fabric:". Från och med version 6.0 avgränsas hierarkiska namn med tecknet "~". Om programnamnet till exempel är "fabric:/myapp/app1" skulle programidentiteten vara "myapp~app1" i 6.0+ och "myapp/app1" i tidigare versioner. |
| --node-name [Krävs] | Namnet på noden. |
| --partition-id | Partitionens identitet. |
| --service-manifest-name | Namnet på ett tjänstmanifest som registrerats som en del av en programtyp i ett Service Fabric-kluster. |
| --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-replikhälsa
Hämtar hälsotillståndet för en tillståndskänslig Service Fabric-tjänstreplik eller tillståndslös tjänstinstans.
Hämtar hälsotillståndet för en Service Fabric-replik. Använd EventsHealthStateFilter för att filtrera samlingen av hälsohändelser som rapporterats på repliken baserat på hälsotillståndet.
Argument
| Argument | beskrivning |
|---|---|
| --partition-id [Krävs] | Partitionens identitet. |
| --replica-id [Krävs] | Replikens identifierare. |
| --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. |
| --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-replikinformation
Hämtar information om en replik av en Service Fabric-partition.
Svaret innehåller ID, roll, status, hälsa, nodnamn, drifttid och annan information om repliken.
Argument
| Argument | beskrivning |
|---|---|
| --partition-id [Krävs] | Partitionens identitet. |
| --replica-id [Krävs] | Replikens identifierare. |
| --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-repliklista
Hämtar information om repliker av en Service Fabric-tjänstpartition.
GetReplicas-slutpunkten returnerar information om replikerna för den angivna partitionen. Svaret innehåller ID, roll, status, hälsa, nodnamn, drifttid och annan information om repliken.
Argument
| Argument | beskrivning |
|---|---|
| --partition-id [Krävs] | Partitionens identitet. |
| --continuation-token | Parametern fortsättningstoken används för att hämta nästa uppsättning resultat. En fortsättningstoken med ett värde som inte är tomt ingår i API:ets svar när resultatet från systemet inte får plats i ett enda svar. När det här värdet skickas till nästa API-anrop returnerar API:et nästa uppsättning resultat. Om det inte finns några ytterligare resultat innehåller fortsättningstoken inget värde. Värdet för den här parametern ska inte vara URL-kodat. |
| --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 replica remove
Tar bort en tjänstreplik som körs på en nod.
Det här API:et simulerar ett Service Fabric-replikfel genom att ta bort en replik från ett Service Fabric-kluster. Borttagningen stänger repliken, överför repliken till rollen Ingen och tar sedan bort all tillståndsinformation för repliken från klustret. Det här API:et testar sökvägen för borttagning av repliktillstånd och simulerar rapportens permanenta sökväg via klient-API:er. Varning – Inga säkerhetskontroller utförs när det här API:et används. Felaktig användning av det här API:et kan leda till dataförlust för tillståndskänsliga tjänster. Dessutom påverkar forceRemove-flaggan alla andra repliker som finns i samma process.
Argument
| Argument | beskrivning |
|---|---|
| --node-name [Krävs] | Namnet på noden. |
| --partition-id [Krävs] | Partitionens identitet. |
| --replica-id [Krävs] | Replikens identifierare. |
| --force-remove | Ta bort ett Service Fabric-program eller en tjänst med kraft utan att gå igenom den graciösa avstängningssekvensen. Den här parametern kan användas för att ta bort ett program eller en tjänst som borttagningen tar tid för på grund av problem i tjänstkoden som förhindrar att repliker stängs korrekt. |
| --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 replica report-health
Skickar en hälsorapport på Service Fabric-repliken.
Rapporterar hälsotillståndet för den angivna Service Fabric-repliken. 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-gatewayreplik 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 hämta replikhälsa 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". |
| --partition-id [Krävs] | Partitionens identitet. |
| --replica-id [Krävs] | Partitionens identitet. |
| --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. |
| --service-kind | Den typ av tjänstreplik (tillståndslös eller tillståndskänslig) som hälsotillståndet rapporteras för. Följande är möjliga värden: "Stateless", "Stateful". Standard: Tillståndskänslig. |
| --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. |
omstart av sfctl-replik
Startar om en tjänstreplik av en beständiga tjänst som körs på en nod.
Startar om en tjänstreplik av en beständiga tjänst som körs på en nod. Varning – Inga säkerhetskontroller utförs när det här API:et används. Felaktig användning av det här API:et kan leda till tillgänglighetsförlust för tillståndskänsliga tjänster.
Argument
| Argument | beskrivning |
|---|---|
| --node-name [Krävs] | Namnet på noden. |
| --partition-id [Krävs] | Partitionens identitet. |
| --replica-id [Krävs] | Replikens identifierare. |
| --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. |
Nästa steg
- Konfigurera Service Fabric CLI.
- Lär dig hur du använder Service Fabric CLI med hjälp av exempelskripten.