sfctl replica
Beheer de replica's die deel uitmaken van servicepartities.
Opdracht
| Opdracht | Beschrijving |
|---|---|
| Ingezet | Hiermee haalt u de details op van de replica die is geïmplementeerd op een Service Fabric-knooppunt. |
| geïmplementeerde lijst | Hiermee haalt u de lijst met replica's op die zijn geïmplementeerd op een Service Fabric-knooppunt. |
| gezondheidszorg | Hiermee haalt u de status van een stateful servicereplica of stateless service-exemplaar van Service Fabric op. |
| Info | Haalt de informatie op over een replica van een Service Fabric-partitie. |
| lijst | Haalt de informatie op over replica's van een Service Fabric-servicepartitie. |
| remove | Hiermee verwijdert u een servicereplica die wordt uitgevoerd op een knooppunt. |
| rapportstatus | Hiermee wordt een statusrapport verzonden op de Service Fabric-replica. |
| restart | Start een servicereplica opnieuw van een persistente service die wordt uitgevoerd op een knooppunt. |
geïmplementeerde sfctl-replica
Hiermee haalt u de details op van de replica die is geïmplementeerd op een Service Fabric-knooppunt.
Hiermee haalt u de details op van de replica die is geïmplementeerd op een Service Fabric-knooppunt. De informatie bevat servicetype, servicenaam, huidige servicebewerking, begindatum van de huidige servicebewerking, partitie-id, replica-/exemplaar-id, gerapporteerde belasting en andere informatie.
Argumenten
| Argument | Beschrijving |
|---|---|
| --node-name [vereist] | De naam van het knooppunt. |
| --partition-id [vereist] | De identiteit van de partitie. |
| --replica-id [vereist] | De id van de replica. |
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
geïmplementeerde sfctl-replicalijst
Hiermee haalt u de lijst met replica's op die zijn geïmplementeerd op een Service Fabric-knooppunt.
Hiermee haalt u de lijst op met de informatie over replica's die zijn geïmplementeerd op een Service Fabric-knooppunt. De informatie bevat partitie-id, replica-id, status van de replica, de naam van de service, de naam van het servicetype en andere informatie. Gebruik de queryparameters PartitionId of ServiceManifestName om informatie te retourneren over de geïmplementeerde replica's die overeenkomen met de opgegeven waarden voor deze parameters.
Argumenten
| Argument | Beschrijving |
|---|---|
| --application-id [vereist] | De identiteit van de toepassing. Dit is doorgaans de volledige naam van de toepassing zonder het URI-schema 'fabric:'. Vanaf versie 6.0 worden hiërarchische namen gescheiden door het teken ~. Als de naam van de toepassing bijvoorbeeld 'fabric:/myapp/app1' is, is de toepassingsidentiteit 'myapp~app1' in 6.0+ en 'myapp/app1' in eerdere versies. |
| --node-name [vereist] | De naam van het knooppunt. |
| --partition-id | De identiteit van de partitie. |
| --service-manifest-name | De naam van een servicemanifest dat is geregistreerd als onderdeel van een toepassingstype in een Service Fabric-cluster. |
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
sfctl-replicastatus
Hiermee haalt u de status van een stateful servicereplica of stateless service-exemplaar van Service Fabric op.
Hiermee haalt u de status van een Service Fabric-replica op. Gebruik EventsHealthStateFilter om de verzameling statusgebeurtenissen te filteren die zijn gerapporteerd op de replica op basis van de status.
Argumenten
| Argument | Beschrijving |
|---|---|
| --partition-id [vereist] | De identiteit van de partitie. |
| --replica-id [vereist] | De id van de replica. |
| --events-health-state-filter | Hiermee kunt u filteren op de verzameling HealthEvent-objecten die worden geretourneerd op basis van de status. De mogelijke waarden voor deze parameter bevatten een geheel getal van een van de volgende statussen. Alleen gebeurtenissen die overeenkomen met het filter worden geretourneerd. Alle gebeurtenissen worden gebruikt om de geaggregeerde status te evalueren. Als dit niet is opgegeven, worden alle vermeldingen geretourneerd. De statuswaarden zijn opsomming op basis van vlaggen, dus de waarde kan een combinatie van deze waarden zijn, verkregen met behulp van de bitsgewijze OR-operator. Als de opgegeven waarde bijvoorbeeld 6 is, worden alle gebeurtenissen met de HealthState-waarde OK (2) en Waarschuwing (4) geretourneerd. - Standaardwaarde- Standaardwaarde. Komt overeen met elke HealthState. De waarde is nul. - Geen - Filter dat niet overeenkomt met een HealthState-waarde. Wordt gebruikt om geen resultaten te retourneren voor een bepaalde verzameling statussen. De waarde is 1. - OK- Filter dat overeenkomt met invoer met HealthState-waarde OK. De waarde is 2. - Waarschuwing: filter dat overeenkomt met invoer met HealthState-waardewaarschuwing. De waarde is 4. - Fout: filter dat overeenkomt met invoer met HealthState-waardeFout. De waarde is 8. - Alle - Filter dat overeenkomt met invoer met een HealthState-waarde. De waarde is 65535. |
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
sfctl replica info
Haalt de informatie op over een replica van een Service Fabric-partitie.
Het antwoord bevat de id, rol, status, status, knooppuntnaam, uptime en andere details over de replica.
Argumenten
| Argument | Beschrijving |
|---|---|
| --partition-id [vereist] | De identiteit van de partitie. |
| --replica-id [vereist] | De id van de replica. |
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
sfctl replica list
Haalt de informatie op over replica's van een Service Fabric-servicepartitie.
Het Eindpunt GetReplicas retourneert informatie over de replica's van de opgegeven partitie. Het antwoord bevat de id, rol, status, status, knooppuntnaam, uptime en andere details over de replica.
Argumenten
| Argument | Beschrijving |
|---|---|
| --partition-id [vereist] | De identiteit van de partitie. |
| --vervolgtoken | De vervolgtokenparameter wordt gebruikt om de volgende set resultaten te verkrijgen. Een vervolgtoken met een niet-lege waarde wordt opgenomen in het antwoord van de API wanneer de resultaten van het systeem niet in één antwoord passen. Wanneer deze waarde wordt doorgegeven aan de volgende API-aanroep, retourneert de API de volgende set resultaten. Als er geen verdere resultaten zijn, bevat het vervolgtoken geen waarde. De waarde van deze parameter mag niet url-gecodeerd zijn. |
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
sfctl replica verwijderen
Hiermee verwijdert u een servicereplica die wordt uitgevoerd op een knooppunt.
Met deze API wordt een Service Fabric-replicafout gesimuleerd door een replica uit een Service Fabric-cluster te verwijderen. De verwijdering sluit de replica, zet de replica over op de rol None en verwijdert vervolgens alle statusinformatie van de replica uit het cluster. Met deze API wordt het verwijderingspad voor de replicastatus getest en wordt het permanente pad naar de fout van het rapport gesimuleerd via client-API's. Waarschuwing: er worden geen veiligheidscontroles uitgevoerd wanneer deze API wordt gebruikt. Onjuist gebruik van deze API kan leiden tot gegevensverlies voor stateful services. Bovendien heeft de vlag forceRemove invloed op alle andere replica's die in hetzelfde proces worden gehost.
Argumenten
| Argument | Beschrijving |
|---|---|
| --node-name [vereist] | De naam van het knooppunt. |
| --partition-id [vereist] | De identiteit van de partitie. |
| --replica-id [vereist] | De id van de replica. |
| --force-remove | Verwijder een Service Fabric-toepassing of -service geforceerd zonder de juiste afsluitvolgorde te doorlopen. Deze parameter kan worden gebruikt voor het geforceerd verwijderen van een toepassing of service waarvoor een time-out optreedt vanwege problemen in de servicecode die voorkomen dat replica's correct worden gesloten. |
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
sfctl replica report-health
Hiermee wordt een statusrapport verzonden op de Service Fabric-replica.
Rapporteert de status van de opgegeven Service Fabric-replica. Het rapport moet de informatie bevatten over de bron van het statusrapport en de eigenschap waarop het wordt gerapporteerd. Het rapport wordt verzonden naar een Service Fabric-gatewayreplica, die wordt doorgestuurd naar het statusarchief. Het rapport kan worden geaccepteerd door de gateway, maar geweigerd door het statusarchief na extra validatie. Het statusarchief kan bijvoorbeeld het rapport weigeren vanwege een ongeldige parameter, zoals een verlopen volgnummer. Als u wilt zien of het rapport is toegepast in het statusarchief, voert u de status van de replica uit en controleert u of het rapport wordt weergegeven in de sectie HealthEvents.
Argumenten
| Argument | Beschrijving |
|---|---|
| --health-property [Vereist] | De eigenschap van de statusinformatie. Een entiteit kan statusrapporten hebben voor verschillende eigenschappen. De eigenschap is een tekenreeks en geen vaste opsomming om de flexibiliteit van de rapportrapporteur te bieden om de statusvoorwaarde te categoriseren die het rapport activeert. Een reporter met SourceId LocalWatchdog kan bijvoorbeeld de status van de beschikbare schijf op een knooppunt controleren, zodat de eigenschap AvailableDisk op dat knooppunt kan worden weergegeven. Dezelfde journalist kan de connectiviteit van het knooppunt bewaken, zodat deze een eigenschap Connectiviteit op hetzelfde knooppunt kan rapporteren. In het statusarchief worden deze rapporten behandeld als afzonderlijke status gebeurtenissen voor het opgegeven knooppunt. Samen met de SourceId identificeert de eigenschap de statusgegevens op unieke wijze. |
| --status [vereist] | Mogelijke waarden zijn: 'Ongeldig', 'OK', 'Waarschuwing', 'Fout', 'Onbekend'. |
| --partition-id [vereist] | De identiteit van de partitie. |
| --replica-id [vereist] | De identiteit van de partitie. |
| --source-id [vereist] | De bronnaam die de client-/watchdog-/systeemcomponent identificeert die de statusgegevens heeft gegenereerd. |
| --beschrijving | De beschrijving van de statusinformatie. Het vertegenwoordigt vrije tekst die wordt gebruikt om leesbare informatie over het rapport toe te voegen. De maximale tekenreekslengte voor de beschrijving is 4096 tekens. Als de opgegeven tekenreeks langer is, wordt deze automatisch afgekapt. Wanneer de beschrijving wordt afgekapt, bevatten de laatste tekens van de beschrijving de markering [Afgekapt], en de totale tekenreeksgrootte is 4096 tekens. De aanwezigheid van de markering geeft aan gebruikers aan dat afkapping is opgetreden. Houd er rekening mee dat wanneer de beschrijving wordt afgekapt, minder dan 4096 tekens uit de oorspronkelijke tekenreeks bevat. |
| --onmiddellijk | Een vlag die aangeeft of het rapport onmiddellijk moet worden verzonden. Er wordt een statusrapport verzonden naar een Service Fabric-gatewaytoepassing, die wordt doorgestuurd naar het statusarchief. Als Direct is ingesteld op true, wordt het rapport onmiddellijk van HTTP Gateway naar het statusarchief verzonden, ongeacht de clientinstellingen voor infrastructuur die de HTTP Gateway-toepassing gebruikt. Dit is handig voor kritieke rapporten die zo snel mogelijk moeten worden verzonden. Afhankelijk van de timing en andere omstandigheden kan het verzenden van het rapport nog steeds mislukken, bijvoorbeeld als de HTTP-gateway is gesloten of het bericht de gateway niet bereikt. Als Direct is ingesteld op False, wordt het rapport verzonden op basis van de statusclientinstellingen van de HTTP-gateway. Daarom wordt deze batched volgens de HealthReportSendInterval-configuratie. Dit is de aanbevolen instelling omdat de statusclient berichten voor statusrapportage kan optimaliseren in het statusarchief en de verwerking van statusrapporten. Rapporten worden standaard niet onmiddellijk verzonden. |
| --remove-when-expired | Waarde die aangeeft of het rapport wordt verwijderd uit het statusarchief wanneer het verloopt. Als dit is ingesteld op true, wordt het rapport verwijderd uit het statusarchief nadat het is verlopen. Als dit is ingesteld op onwaar, wordt het rapport behandeld als een fout wanneer deze is verlopen. De waarde van deze eigenschap is standaard onwaar. Wanneer clients periodiek rapporteren, moeten ze RemoveWhenExpired false (standaard) instellen. Op deze manier heeft de journalist problemen (bijvoorbeeld een impasse) en kan deze niet rapporteren. De entiteit wordt als fout geëvalueerd wanneer het statusrapport verloopt. Hiermee wordt de entiteit als foutstatus opgegeven. |
| --reeksnummer | Het volgnummer voor dit statusrapport als een numerieke tekenreeks. Het volgnummer van het rapport wordt door het statusarchief gebruikt om verlopen rapporten te detecteren. Als dit niet is opgegeven, wordt een volgnummer automatisch gegenereerd door de statusclient wanneer een rapport wordt toegevoegd. |
| --service-soort | Het type servicereplica (staatloos of stateful) waarvoor de status wordt gerapporteerd. Hier volgen de mogelijke waarden: 'Stateless', 'Stateful'. Standaard: Stateful. |
| --time-out -t | Standaard: 60. |
| --Ttl | De duur waarvoor dit statusrapport geldig is. In dit veld wordt ISO8601 indeling gebruikt voor het opgeven van de duur. Wanneer clients periodiek rapporteren, moeten ze rapporten met een hogere frequentie verzenden dan time to live. Als clients rapporteren over de overgang, kunnen ze de time to live instellen op oneindig. Wanneer time-to-live verloopt, wordt de statusgebeurtenis die de statusgegevens bevat verwijderd uit het statusarchief, als RemoveWhenExpired waar is of wordt geëvalueerd als RemoveWhenExpired false is. Als dit niet is opgegeven, wordt time-to-live standaard ingesteld op oneindige waarde. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
opnieuw opstarten van sfctl-replica
Start een servicereplica opnieuw van een persistente service die wordt uitgevoerd op een knooppunt.
Start een servicereplica opnieuw van een persistente service die wordt uitgevoerd op een knooppunt. Waarschuwing: er worden geen veiligheidscontroles uitgevoerd wanneer deze API wordt gebruikt. Onjuist gebruik van deze API kan leiden tot beschikbaarheidsverlies voor stateful services.
Argumenten
| Argument | Beschrijving |
|---|---|
| --node-name [vereist] | De naam van het knooppunt. |
| --partition-id [vereist] | De identiteit van de partitie. |
| --replica-id [vereist] | De id van de replica. |
| --time-out -t | De servertime-out voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client wil wachten tot de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden. Standaard: 60. |
Globale argumenten
| Argument | Beschrijving |
|---|---|
| --debug | Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. |
| --help -h | Dit Help-bericht weergeven en afsluiten. |
| --output -o | Uitvoerindeling. Toegestane waarden: json, jsonc, tabel, tsv. Standaard: json. |
| --vraag | JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden. |
| --verbose | Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken. |
Volgende stappen
- De Service Fabric CLI instellen .
- Meer informatie over het gebruik van de Service Fabric CLI met behulp van de voorbeeldscripts.