sfctl cluster
Service Fabric-clusters selecteren, beheren en gebruiken.
Opdracht
Opdracht | Beschrijving |
---|---|
codeversies | Hiermee haalt u een lijst op met fabric-codeversies die zijn ingericht in een Service Fabric-cluster. |
configuratieversies | Hiermee haalt u een lijst op met fabric-configuratieversies die zijn ingericht in een Service Fabric-cluster. |
gezondheidszorg | Hiermee haalt u de status van een Service Fabric-cluster op. |
manifest | Haal het Service Fabric-clustermanifest op. |
operation-cancel | Annuleert een door de gebruiker geïnduceerde foutbewerking. |
operation-list | Hiermee wordt een lijst opgehaald met door de gebruiker geïnduceerde foutbewerkingen gefilterd op opgegeven invoer. |
bepaling | Richt de code of configuratiepakketten van een Service Fabric-cluster in. |
recover-system | Geeft aan het Service Fabric-cluster aan dat moet worden geprobeerd de systeemservices te herstellen die momenteel vastzitten in quorumverlies. |
rapportstatus | Hiermee wordt een statusrapport verzonden op het Service Fabric-cluster. |
Selecteer | Maakt verbinding met een Service Fabric-clustereindpunt. |
show-connection | Weergeven met welk Service Fabric-cluster dit sfctl-exemplaar is verbonden. |
inrichting ongedaan maken | Maak de inrichting van de code of configuratiepakketten van een Service Fabric-cluster ongedaan. |
upgrade | Begin met het upgraden van de code of configuratieversie van een Service Fabric-cluster. |
upgrade hervatten | Breng de clusterupgrade door naar het volgende upgradedomein. |
upgrade-terugdraaien | De upgrade van een Service Fabric-cluster terugdraaien. |
upgradestatus | Hiermee wordt de voortgang van de huidige clusterupgrade opgehaald. |
upgrade-update | Werk de upgradeparameters van een Service Fabric-clusterupgrade bij. |
codeversies van sfctl-cluster
Hiermee haalt u een lijst op met fabric-codeversies die zijn ingericht in een Service Fabric-cluster.
Hiermee haalt u een lijst op met informatie over fabric-codeversies die zijn ingericht in het cluster. De parameter CodeVersion kan worden gebruikt om de uitvoer optioneel te filteren op alleen die specifieke versie.
Argumenten
Argument | Beschrijving |
---|---|
--code-version | De productversie van Service Fabric. |
--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. |
configuratieversies van sfctl-cluster
Hiermee haalt u een lijst op met fabric-configuratieversies die zijn ingericht in een Service Fabric-cluster.
Hiermee wordt een lijst met informatie opgehaald over fabric-configuratieversies die in het cluster zijn ingericht. De parameter ConfigVersion kan worden gebruikt om de uitvoer optioneel te filteren op alleen die specifieke versie.
Argumenten
Argument | Beschrijving |
---|---|
--config-version | De configuratieversie van Service Fabric. |
--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-clusterstatus
Hiermee haalt u de status van een Service Fabric-cluster op.
Gebruik EventsHealthStateFilter om de verzameling statusgebeurtenissen te filteren die zijn gerapporteerd op het cluster op basis van de status. Gebruik op dezelfde manier NodesHealthStateFilter en ApplicationsHealthStateFilter om de verzameling knooppunten en toepassingen te filteren die worden geretourneerd op basis van hun geaggregeerde status.
Argumenten
Argument | Beschrijving |
---|---|
--applications-health-state-filter | Hiermee kunt u filteren van de toepassingsstatusobjecten die worden geretourneerd in het resultaat van de clusterstatusquery op basis van hun statusstatus. De mogelijke waarden voor deze parameter omvatten gehele getallen die zijn verkregen van leden of bitgewijze bewerkingen voor leden van de opsomming HealthStateFilter. Alleen toepassingen die overeenkomen met het filter worden geretourneerd. Alle toepassingen 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, zodat de waarde een combinatie van deze waarden kan zijn die worden verkregen met behulp van de operator bitwise OR. Als de opgegeven waarde bijvoorbeeld 6 is, wordt de status van toepassingen 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. |
--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. |
--exclude-health-statistics | Hiermee wordt aangegeven of de statusstatistieken moeten worden geretourneerd als onderdeel van het queryresultaat. Standaard onwaar. De statistieken geven het aantal onderliggende entiteiten weer in de status OK, Waarschuwing en Fout. |
--include-system-application-health-statistics | Geeft aan of de statusstatistieken de statusstatistieken van de infrastructuur moeten bevatten:/Systeemtoepassingsstatusstatistieken. Standaard onwaar. Als IncludeSystemApplicationHealthStatistics is ingesteld op true, bevatten de statusstatistieken de entiteiten die deel uitmaken van de fabric:/System-toepassing. Anders bevat het queryresultaat alleen statusstatistieken voor gebruikerstoepassingen. De statusstatistieken moeten worden opgenomen in het queryresultaat om deze parameter toe te passen. |
--nodes-health-state-filter | Hiermee kunt u filteren van de statusobjecten van het knooppunt die worden geretourneerd in het resultaat van de clusterstatusquery op basis van hun statusstatus. De mogelijke waarden voor deze parameter bevatten een geheel getal van een van de volgende statussen. Alleen knooppunten die overeenkomen met het filter worden geretourneerd. Alle knooppunten 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, zodat de waarde een combinatie van deze waarden kan zijn die worden verkregen met behulp van de operator bitwise OR. Als de opgegeven waarde bijvoorbeeld 6 is, wordt de status van knooppunten 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-clustermanifest
Haal het Service Fabric-clustermanifest op.
Haal het Service Fabric-clustermanifest op. Het clustermanifest bevat eigenschappen van het cluster met verschillende knooppunttypen op het cluster, beveiligingsconfiguraties, fout- en upgradedomeintopologieën, enzovoort. Deze eigenschappen worden opgegeven als onderdeel van het ClusterConfig.JSON-bestand tijdens het implementeren van een zelfstandig cluster. De meeste informatie in het clustermanifest wordt echter intern gegenereerd door service fabric tijdens de clusterimplementatie in andere implementatiescenario's (bijvoorbeeld wanneer u Azure Portal gebruikt). De inhoud van het clustermanifest is alleen bedoeld voor informatieve doeleinden en gebruikers hoeven niet afhankelijk te zijn van de indeling van de bestandsinhoud of de interpretatie ervan.
Argumenten
Argument | Beschrijving |
---|---|
--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 cluster operation-cancel
Annuleert een door de gebruiker geïnduceerde foutbewerking.
De volgende API's starten foutbewerkingen die kunnen worden geannuleerd met Behulp van CancelOperation: StartDataLoss, StartQuorumLoss, StartPartitionRestart, StartNodeTransition. Als force onwaar is, wordt de opgegeven door de gebruiker geïnduceerde bewerking correct gestopt en opgeschoond. Als de kracht waar is, wordt de opdracht afgebroken en kan er een interne status achterblijven. Het opgeven van kracht als waar moet zorgvuldig worden gebruikt. Het aanroepen van deze API met force ingesteld op true is pas toegestaan als deze API al is aangeroepen op dezelfde testopdracht met geforceerd ingesteld op onwaar, of tenzij de testopdracht al een OperationState van OperationState.RollingBack heeft. Verduidelijking: OperationState.RollingBack betekent dat het systeem de interne systeemstatus zal opschonen die wordt veroorzaakt door het uitvoeren van de opdracht. Er worden geen gegevens hersteld als de testopdracht gegevensverlies zou veroorzaken. Als u bijvoorbeeld StartDataLoss aanroept, roept u deze API aan, dan wordt de interne status van het systeem alleen opgeschoond door de opdracht uit te voeren. De gegevens van de doelpartitie worden niet hersteld als de opdracht ver genoeg is om gegevensverlies te veroorzaken. Belangrijke opmerking: als deze API wordt aangeroepen met force==true, kan de interne status achterblijven.
Argumenten
Argument | Beschrijving |
---|---|
--operation-id [vereist] | Een GUID die een aanroep van deze API identificeert. Dit wordt doorgegeven aan de bijbehorende GetProgress-API. |
--kracht | Hiermee wordt aangegeven of de interne systeemstatus die is gewijzigd, correct moet worden teruggedraaid en opgeschoond door de door de gebruiker geïnduceerde bewerking uit te voeren. |
--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 cluster operation-list
Hiermee wordt een lijst opgehaald met door de gebruiker geïnduceerde foutbewerkingen gefilterd op opgegeven invoer.
Hiermee haalt u de lijst met door de gebruiker geïnduceerde foutbewerkingen op die zijn gefilterd op opgegeven invoer.
Argumenten
Argument | Beschrijving |
---|---|
--state-filter | Wordt gebruikt om te filteren op OperationState's voor door de gebruiker geïnduceerde bewerkingen. - 65535 - alles selecteren - 1 - Actief - 2 - RollingBack - 8 - selecteren - Voltooid - 16 - Fout selecteren - 32 - Geannuleerd - 64 - ForceCancelled selecteren. Standaard: 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. |
--type-filter | Wordt gebruikt om te filteren op OperationType voor door de gebruiker geïnduceerde bewerkingen. - 65535 - alles selecteren - 1 - PartitionDataLoss selecteren. - 2 - Selecteer PartitionQuorumLoss. - 4 - Selecteer PartitionRestart. - 8 - Selecteer NodeTransition. Standaard: 65535. |
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-cluster inrichten
Richt de code of configuratiepakketten van een Service Fabric-cluster in.
Valideer en richt de code of configuratiepakketten van een Service Fabric-cluster in.
Argumenten
Argument | Beschrijving |
---|---|
--cluster-manifest-file-path | Het pad naar het clustermanifestbestand. |
--code-file-path | Het bestandspad van het clustercodepakket. |
--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 cluster recover-system
Geeft aan het Service Fabric-cluster aan dat moet worden geprobeerd de systeemservices te herstellen die momenteel vastzitten in quorumverlies.
Geeft aan het Service Fabric-cluster aan dat moet worden geprobeerd de systeemservices te herstellen die momenteel vastzitten in quorumverlies. Deze bewerking moet alleen worden uitgevoerd als bekend is dat de replica's die niet kunnen worden hersteld. Onjuist gebruik van deze API kan mogelijk gegevensverlies veroorzaken.
Argumenten
Argument | Beschrijving |
---|---|
--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 cluster report-health
Hiermee wordt een statusrapport verzonden op het Service Fabric-cluster.
Hiermee wordt een statusrapport verzonden op een Service Fabric-cluster. 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-gatewayknooppunt, dat 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 GetClusterHealth 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'. |
--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. |
--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. |
sfctl-cluster selecteren
Maakt verbinding met een Service Fabric-clustereindpunt.
Als u verbinding maakt met een beveiligd cluster, geeft u een absoluut pad op naar een certificaat (.crt) en sleutelbestand (.key) of één bestand met beide (.pem). Geef niet beide op. Als u verbinding maakt met een beveiligd cluster, kunt u desgewenst ook een absoluut pad opgeven naar een CA-bundelbestand of map met vertrouwde CA-certificaten. Er is geen verbinding met een cluster zonder deze opdracht eerst uit te voeren, inclusief een verbinding met localhost. Er is echter geen expliciet eindpunt vereist om verbinding te maken met een lokaal cluster. Als u een zelfondertekend certificaat of een ander certificaat gebruikt dat niet is ondertekend door een bekende CERTIFICERINGsinstantie, geeft u de parameter --ca door om ervoor te zorgen dat de validatie is geslaagd. Gebruik de optie --no-verify als u de validatie aan de clientzijde wilt overslaan (handig voor zelfondertekende of niet-bekende CA-ondertekening) als u geen productiecluster wilt gebruiken. Hoewel dit mogelijk is, wordt het niet aanbevolen voor productieclusters. Een certificaatverificatiefout kan anders resulteren.
Argumenten
Argument | Beschrijving |
---|---|
--aad | Gebruik Microsoft Entra-id voor verificatie. |
--ca | Absoluut pad naar ca-certificaatmap die moet worden behandeld als geldig of CA-bundelbestand. Als u een map met CA-certificaten gebruikt, c_rehash <directory> moet openSSL eerst worden uitgevoerd om de certificaat-hashes te berekenen en de juiste symbolische koppelingen te maken. Dit wordt gebruikt om te controleren of het certificaat dat door het cluster wordt geretourneerd, geldig is. |
--Cert | Absoluut pad naar een clientcertificaatbestand. |
--Eindpunt | Url van clustereindpunt, inclusief poort en HTTP- of HTTPS-voorvoegsel. Normaal gesproken ziet het eindpunt er ongeveer als volgt uit https\://<your-url>\:19080 . Als er geen eindpunt is opgegeven, wordt het standaard ingesteld op http\://localhost\:19080 . |
--sleutel | Absoluut pad naar clientcertificaatsleutelbestand. |
--no-verify | Schakel verificatie voor certificaten uit wanneer u HTTPS gebruikt. Opmerking: dit is een onveilige optie en mag niet worden gebruikt voor productieomgevingen. |
--Pem | Absoluut pad naar clientcertificaat, als een PEM-bestand. |
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 cluster show-connection
Weergeven met welk Service Fabric-cluster dit sfctl-exemplaar is verbonden.
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. |
inrichting van sfctl-cluster ongedaan maken
Maak de inrichting van de code of configuratiepakketten van een Service Fabric-cluster ongedaan.
Het wordt ondersteund om de inrichting van code en configuratie afzonderlijk ongedaan te maken.
Argumenten
Argument | Beschrijving |
---|---|
--code-version | De versie van het clustercodepakket. |
--config-version | De versie van het clustermanifest. |
--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. |
upgrade van sfctl-cluster
Begin met het upgraden van de code of configuratieversie van een Service Fabric-cluster.
Valideer de opgegeven upgradeparameters en begin met het upgraden van de code of configuratieversie van een Service Fabric-cluster als de parameters geldig zijn.
Argumenten
Argument | Beschrijving |
---|---|
--app-health-map | JSON gecodeerde woordenlijst van paren van toepassingsnaam en maximumpercentage beschadigd voordat er een fout optreedt. |
--app-type-health-map | JSON gecodeerde woordenlijst van paren van naam van toepassingstype en maximumpercentage beschadigd voordat er een fout optreedt. |
--code-version | De versie van de clustercode. |
--config-version | De versie van de clusterconfiguratie. |
--delta-health-evaluation | Hiermee schakelt u deltastatusevaluatie in in plaats van absolute statusevaluatie na voltooiing van elk upgradedomein. |
--delta-beschadigde-knooppunten | Het maximaal toegestane percentage statusdegradatie van knooppunten dat is toegestaan tijdens clusterupgrades. Standaard: 10. De delta wordt gemeten tussen de status van de knooppunten aan het begin van de upgrade en de status van de knooppunten op het moment van de statusevaluatie. De controle wordt uitgevoerd nadat elke upgrade van het upgradedomein is voltooid om ervoor te zorgen dat de globale status van het cluster binnen getolereerde limieten valt. |
--failure-action | Mogelijke waarden zijn: 'Ongeldig', 'Terugdraaien', 'Handmatig'. |
--force-restart | Processen worden geforceerd opnieuw opgestart tijdens de upgrade, zelfs wanneer de codeversie niet is gewijzigd. De upgrade wijzigt alleen de configuratie of gegevens. |
--health-check-retry | De tijdsduur tussen pogingen om statuscontroles uit te voeren als de toepassing of het cluster niet in orde is. |
--health-check-stable | De hoeveelheid tijd die de toepassing of het cluster in orde moet blijven voordat de upgrade naar het volgende upgradedomein gaat. Het wordt eerst geïnterpreteerd als een tekenreeks die een ISO 8601-duur vertegenwoordigt. Als dat mislukt, wordt dit geïnterpreteerd als een getal dat het totale aantal milliseconden aangeeft. |
--health-check-wait | De tijd die moet worden gewacht na het voltooien van een upgradedomein voordat het statuscontrolesproces wordt gestart. |
--replica-set-check-time-out | De maximale hoeveelheid tijd om de verwerking van een upgradedomein te blokkeren en verlies van beschikbaarheid te voorkomen wanneer er onverwachte problemen zijn. Wanneer deze time-out verloopt, wordt de verwerking van het upgradedomein voortgezet, ongeacht problemen met beschikbaarheidsverlies. De time-out wordt opnieuw ingesteld aan het begin van elk upgradedomein. Geldige waarden liggen tussen 0 en 42949672925. |
--rolling-upgrademodus | Mogelijke waarden zijn: 'Invalid', 'UnmonitoredAuto', 'UnmonitoredManual', 'Monitored'. Standaard: UnmonitoredAuto. |
--time-out -t | Standaard: 60. |
--beschadigde toepassingen | Het maximaal toegestane percentage beschadigde toepassingen voordat er een fout wordt gerapporteerd. Als u bijvoorbeeld wilt toestaan dat 10% van de toepassingen niet in orde is, is deze waarde 10. Het percentage vertegenwoordigt het maximaal getolereerde percentage toepassingen dat niet in orde kan zijn voordat het cluster als fout wordt beschouwd. Als het percentage wordt gerespecteerd, maar er ten minste één beschadigde toepassing is, wordt de status geëvalueerd als Waarschuwing. Dit wordt berekend door het aantal beschadigde toepassingen te verdelen over het totale aantal toepassingsexemplaren in het cluster, met uitzondering van toepassingen van toepassingstypen die zijn opgenomen in de ApplicationTypeHealthPolicyMap. De berekening rondt af om één fout op kleine aantallen toepassingen te tolereren. |
--beschadigde knooppunten | Het maximaal toegestane percentage beschadigde knooppunten voordat er een fout wordt gerapporteerd. Als u bijvoorbeeld wilt dat 10% van de knooppunten beschadigd is, is deze waarde 10. Het percentage vertegenwoordigt het maximaal getolereerde percentage knooppunten dat niet in orde kan zijn voordat het cluster als fout wordt beschouwd. Als het percentage wordt gerespecteerd, maar er ten minste één beschadigd knooppunt is, wordt de status geëvalueerd als Waarschuwing. Het percentage wordt berekend door het aantal beschadigde knooppunten te delen over het totale aantal knooppunten in het cluster. De berekening wordt afgerond om één fout op kleine aantallen knooppunten te tolereren. In grote clusters zijn sommige knooppunten altijd niet beschikbaar voor reparaties, dus dit percentage moet worden geconfigureerd om dat te tolereren. |
--upgrade-domain-delta-beschadigde-knooppunten | Het maximaal toegestane percentage van de statusvermindering van domeinknooppunten die zijn toegestaan tijdens clusterupgrades. Standaard: 15. De delta wordt gemeten tussen de status van de upgradedomeinknooppunten aan het begin van de upgrade en de status van de upgradedomeinknooppunten op het moment van de statusevaluatie. De controle wordt uitgevoerd nadat elke upgrade van het upgradedomein is voltooid voor alle voltooide upgradedomeinen om ervoor te zorgen dat de status van de upgradedomeinen binnen getolereerde limieten valt. |
--upgrade-domein-time-out | De hoeveelheid tijd die elk upgradedomein moet voltooien voordat FailureAction wordt uitgevoerd. Het wordt eerst geïnterpreteerd als een tekenreeks die een ISO 8601-duur vertegenwoordigt. Als dat mislukt, wordt dit geïnterpreteerd als een getal dat het totale aantal milliseconden aangeeft. |
--upgrade-time-out | De hoeveelheid tijd die de algehele upgrade moet voltooien voordat FailureAction wordt uitgevoerd. Het wordt eerst geïnterpreteerd als een tekenreeks die een ISO 8601-duur vertegenwoordigt. Als dat mislukt, wordt dit geïnterpreteerd als een getal dat het totale aantal milliseconden aangeeft. |
--warning-as-error | Geeft aan of waarschuwingen worden behandeld met dezelfde ernst als fouten. |
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. |
upgrade-cv van sfctl-cluster
Breng de clusterupgrade door naar het volgende upgradedomein.
Zorg ervoor dat de clustercode of configuratie-upgrade naar het volgende upgradedomein gaat, indien van toepassing.
Argumenten
Argument | Beschrijving |
---|---|
--upgrade-domein [vereist] | Het volgende upgradedomein voor deze clusterupgrade. |
--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 cluster upgrade-rollback
De upgrade van een Service Fabric-cluster terugdraaien.
De code of configuratie-upgrade van een Service Fabric-cluster terugdraaien.
Argumenten
Argument | Beschrijving |
---|---|
--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. |
upgradestatus van sfctl-cluster
Hiermee wordt de voortgang van de huidige clusterupgrade opgehaald.
Hiermee haalt u de huidige voortgang van de lopende clusterupgrade op. Als er momenteel geen upgrade wordt uitgevoerd, haalt u de laatste status van de vorige clusterupgrade op.
Argumenten
Argument | Beschrijving |
---|---|
--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. |
upgrade-update van sfctl-cluster
Werk de upgradeparameters van een Service Fabric-clusterupgrade bij.
Argumenten
Argument | Beschrijving |
---|---|
--app-health-map | JSON gecodeerde woordenlijst van paren van toepassingsnaam en maximumpercentage beschadigd voordat er een fout optreedt. |
--app-type-health-map | JSON gecodeerde woordenlijst van paren van naam van toepassingstype en maximumpercentage beschadigd voordat er een fout optreedt. |
--delta-health-evaluation | Hiermee schakelt u deltastatusevaluatie in in plaats van absolute statusevaluatie na voltooiing van elk upgradedomein. |
--delta-beschadigde-knooppunten | Het maximaal toegestane percentage statusdegradatie van knooppunten dat is toegestaan tijdens clusterupgrades. Standaard: 10. De delta wordt gemeten tussen de status van de knooppunten aan het begin van de upgrade en de status van de knooppunten op het moment van de statusevaluatie. De controle wordt uitgevoerd nadat elke upgrade van het upgradedomein is voltooid om ervoor te zorgen dat de globale status van het cluster binnen getolereerde limieten valt. |
--failure-action | Mogelijke waarden zijn: 'Ongeldig', 'Terugdraaien', 'Handmatig'. |
--force-restart | Processen worden geforceerd opnieuw opgestart tijdens de upgrade, zelfs wanneer de codeversie niet is gewijzigd. De upgrade wijzigt alleen de configuratie of gegevens. |
--health-check-retry | De tijdsduur tussen pogingen om statuscontroles uit te voeren als de toepassing of het cluster niet in orde is. |
--health-check-stable | De hoeveelheid tijd die de toepassing of het cluster in orde moet blijven voordat de upgrade naar het volgende upgradedomein gaat. Het wordt eerst geïnterpreteerd als een tekenreeks die een ISO 8601-duur vertegenwoordigt. Als dat mislukt, wordt dit geïnterpreteerd als een getal dat het totale aantal milliseconden aangeeft. |
--health-check-wait | De tijd die moet worden gewacht na het voltooien van een upgradedomein voordat het statuscontrolesproces wordt gestart. |
--replica-set-check-time-out | De maximale hoeveelheid tijd om de verwerking van een upgradedomein te blokkeren en verlies van beschikbaarheid te voorkomen wanneer er onverwachte problemen zijn. Wanneer deze time-out verloopt, wordt de verwerking van het upgradedomein voortgezet, ongeacht problemen met beschikbaarheidsverlies. De time-out wordt opnieuw ingesteld aan het begin van elk upgradedomein. Geldige waarden liggen tussen 0 en 42949672925. |
--rolling-upgrademodus | Mogelijke waarden zijn: 'Invalid', 'UnmonitoredAuto', 'UnmonitoredManual', 'Monitored'. Standaard: UnmonitoredAuto. |
--time-out -t | Standaard: 60. |
--beschadigde toepassingen | Het maximaal toegestane percentage beschadigde toepassingen voordat er een fout wordt gerapporteerd. Als u bijvoorbeeld wilt toestaan dat 10% van de toepassingen niet in orde is, is deze waarde 10. Het percentage vertegenwoordigt het maximaal getolereerde percentage toepassingen dat niet in orde kan zijn voordat het cluster als fout wordt beschouwd. Als het percentage wordt gerespecteerd, maar er ten minste één beschadigde toepassing is, wordt de status geëvalueerd als Waarschuwing. Dit wordt berekend door het aantal beschadigde toepassingen te verdelen over het totale aantal toepassingsexemplaren in het cluster, met uitzondering van toepassingen van toepassingstypen die zijn opgenomen in de ApplicationTypeHealthPolicyMap. De berekening rondt af om één fout op kleine aantallen toepassingen te tolereren. |
--beschadigde knooppunten | Het maximaal toegestane percentage beschadigde knooppunten voordat er een fout wordt gerapporteerd. Als u bijvoorbeeld wilt dat 10% van de knooppunten beschadigd is, is deze waarde 10. Het percentage vertegenwoordigt het maximaal getolereerde percentage knooppunten dat niet in orde kan zijn voordat het cluster als fout wordt beschouwd. Als het percentage wordt gerespecteerd, maar er ten minste één beschadigd knooppunt is, wordt de status geëvalueerd als Waarschuwing. Het percentage wordt berekend door het aantal beschadigde knooppunten te delen over het totale aantal knooppunten in het cluster. De berekening wordt afgerond om één fout op kleine aantallen knooppunten te tolereren. In grote clusters zijn sommige knooppunten altijd niet beschikbaar voor reparaties, dus dit percentage moet worden geconfigureerd om dat te tolereren. |
--upgrade-domain-delta-beschadigde-knooppunten | Het maximaal toegestane percentage van de statusvermindering van domeinknooppunten die zijn toegestaan tijdens clusterupgrades. Standaard: 15. De delta wordt gemeten tussen de status van de upgradedomeinknooppunten aan het begin van de upgrade en de status van de upgradedomeinknooppunten op het moment van de statusevaluatie. De controle wordt uitgevoerd nadat elke upgrade van het upgradedomein is voltooid voor alle voltooide upgradedomeinen om ervoor te zorgen dat de status van de upgradedomeinen binnen getolereerde limieten valt. |
--upgrade-domein-time-out | De hoeveelheid tijd die elk upgradedomein moet voltooien voordat FailureAction wordt uitgevoerd. Het wordt eerst geïnterpreteerd als een tekenreeks die een ISO 8601-duur vertegenwoordigt. Als dat mislukt, wordt dit geïnterpreteerd als een getal dat het totale aantal milliseconden aangeeft. |
--upgrade-soort | Mogelijke waarden zijn: 'Ongeldig', 'Rolling', 'Rolling_ForceRestart'. Standaard: Rolling. |
--upgrade-time-out | De hoeveelheid tijd die de algehele upgrade moet voltooien voordat FailureAction wordt uitgevoerd. Het wordt eerst geïnterpreteerd als een tekenreeks die een ISO 8601-duur vertegenwoordigt. Als dat mislukt, wordt dit geïnterpreteerd als een getal dat het totale aantal milliseconden aangeeft. |
--warning-as-error | Geeft aan of waarschuwingen worden behandeld met dezelfde ernst als fouten. |
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.