sfctl application
Toepassingen en toepassingstypen maken, verwijderen en beheren.
Opdracht
| Opdracht | Beschrijving |
|---|---|
| maken | Hiermee maakt u een Service Fabric-toepassing met behulp van de opgegeven beschrijving. |
| delete | Hiermee verwijdert u een bestaande Service Fabric-toepassing. |
| Ingezet | Haalt de informatie op over een toepassing die is geïmplementeerd op een Service Fabric-knooppunt. |
| geïmplementeerde status | Haalt de informatie op over de status van een toepassing die is geïmplementeerd op een Service Fabric-knooppunt. |
| geïmplementeerde lijst | Hiermee haalt u de lijst met toepassingen op die zijn geïmplementeerd op een Service Fabric-knooppunt. |
| gezondheidszorg | Hiermee haalt u de status van de Service Fabric-toepassing op. |
| Info | Hiermee haalt u informatie op over een Service Fabric-toepassing. |
| lijst | Hiermee haalt u de lijst op met toepassingen die zijn gemaakt in het Service Fabric-cluster die overeenkomen met de opgegeven filters. |
| laden | Hiermee wordt informatie over het laden van een Service Fabric-toepassing opgehaald. |
| manifest | Hiermee haalt u het manifest op waarin een toepassingstype wordt beschreven. |
| bepaling | Richt een Service Fabric-toepassingstype in of registreert dit met het cluster met behulp van het pakket '.sfpkg' in de externe opslag of met behulp van het toepassingspakket in het installatiekopiearchief. |
| rapportstatus | Hiermee wordt een statusrapport verzonden over de Service Fabric-toepassing. |
| type | Hiermee haalt u de lijst met toepassingstypen in het Service Fabric-cluster op die exact overeenkomen met de opgegeven naam. |
| typelijst | Hiermee haalt u de lijst met toepassingstypen op in het Service Fabric-cluster. |
| inrichting ongedaan maken | Hiermee verwijdert of verwijdert u de registratie van een Service Fabric-toepassingstype uit het cluster. |
| upgrade | Hiermee start u een upgrade van een toepassing in het Service Fabric-cluster. |
| upgrade hervatten | Hiermee wordt een upgrade van een toepassing in het Service Fabric-cluster hervat. |
| upgrade-terugdraaien | Hiermee wordt de huidige upgrade van een toepassing in het Service Fabric-cluster teruggezet. |
| upgradestatus | Hiermee haalt u details op voor de meest recente upgrade die op deze toepassing is uitgevoerd. |
| uploaden | Kopieer een Service Fabric-toepassingspakket naar het installatiekopiearchief. |
sfctl-toepassing maken
Hiermee maakt u een Service Fabric-toepassing met behulp van de opgegeven beschrijving.
Argumenten
| Argument | Beschrijving |
|---|---|
| --app-name [vereist] | De naam van de toepassing, inclusief het URI-schema 'fabric:'. |
| --app-type [vereist] | De naam van het toepassingstype in het toepassingsmanifest. |
| --app-versie [vereist] | De versie van het toepassingstype zoals gedefinieerd in het toepassingsmanifest. |
| --max-node-count | Het maximum aantal knooppunten waar Service Fabric capaciteit voor deze toepassing reserveert. Dit betekent niet dat de services van deze toepassing op al deze knooppunten worden geplaatst. |
| --Statistieken | Een met JSON gecodeerde lijst met metrische beschrijvingen van toepassingscapaciteit. Een metrische waarde wordt gedefinieerd als een naam, gekoppeld aan een set capaciteiten voor elk knooppunt waarop de toepassing bestaat. |
| --min-node-count | Het minimale aantal knooppunten waar Service Fabric capaciteit voor deze toepassing reserveert. Dit betekent niet dat de services van deze toepassing op al deze knooppunten worden geplaatst. |
| --Parameters | Een door JSON gecodeerde lijst met toepassingsparameteroverschrijvingen die moeten worden toegepast bij het maken van de toepassing. |
| --time-out -t | 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-toepassing verwijderen
Hiermee verwijdert u een bestaande Service Fabric-toepassing.
Er moet een toepassing worden gemaakt voordat deze kan worden verwijderd. Als u een toepassing verwijdert, worden alle services verwijderd die deel uitmaken van die toepassing. Service Fabric probeert standaard servicereplica's op een correcte manier te sluiten en vervolgens de service te verwijderen. Als een service echter problemen ondervindt met het sluiten van de replica, kan het lang duren voordat de verwijderingsbewerking is vastgelopen. Gebruik de optionele ForceRemove-vlag om de respijtvolle sluitvolgorde over te slaan en de toepassing en alle bijbehorende services geforceerd te verwijderen.
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. |
| --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-toepassing geïmplementeerd
Haalt de informatie op over een toepassing die is geïmplementeerd op een Service Fabric-knooppunt.
Deze query retourneert systeemtoepassingsgegevens als de opgegeven toepassings-id voor de systeemtoepassing is. Resultaten omvatten geïmplementeerde toepassingen in actieve, activerende en downloadstatussen. Voor deze query moet de naam van het knooppunt overeenkomen met een knooppunt in het cluster. De query mislukt als de opgegeven knooppuntnaam niet verwijst naar actieve Service Fabric-knooppunten in het cluster.
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. |
| --include-health-state | Neem de status van een entiteit op. Als deze parameter onwaar is of niet is opgegeven, is de geretourneerde status Onbekend. Als deze is ingesteld op true, wordt de query parallel uitgevoerd met het knooppunt en de statussysteemservice voordat de resultaten worden samengevoegd. Als gevolg hiervan is de query duurder en kan het langer duren. |
| --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-toepassing geïmplementeerde status
Haalt de informatie op over de status van een toepassing die is geïmplementeerd op een Service Fabric-knooppunt.
Haalt de informatie op over de status van een toepassing die is geïmplementeerd op een Service Fabric-knooppunt. Gebruik EventsHealthStateFilter om optioneel te filteren op de verzameling HealthEvent-objecten die zijn gerapporteerd op de geïmplementeerde toepassing op basis van de status. Gebruik DeployedServicePackagesHealthStateFilter om optioneel te filteren op kinderen van DeployedServicePackageHealth op basis van de status.
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. |
| --deployed-service-packages-health-state-filter | Hiermee kunt u filteren van de geïmplementeerde statusobjecten voor servicepakketten die worden geretourneerd in het resultaat van de geïmplementeerde toepassingsstatusquery op basis van hun status. De mogelijke waarden voor deze parameter bevatten een geheel getal van een van de volgende statussen. Alleen geïmplementeerde servicepakketten die overeenkomen met het filter worden geretourneerd. Alle geïmplementeerde servicepakketten worden gebruikt om de geaggregeerde status van de geïmplementeerde toepassing 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, verkregen met behulp van de bitsgewijze OR-operator. Als de opgegeven waarde bijvoorbeeld 6 is, wordt de status van servicepakketten 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. |
| --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-toepassing
Hiermee haalt u de lijst met toepassingen op die zijn geïmplementeerd op een Service Fabric-knooppunt.
Hiermee haalt u de lijst met toepassingen op die zijn geïmplementeerd op een Service Fabric-knooppunt. De resultaten bevatten geen informatie over geïmplementeerde systeemtoepassingen, tenzij er expliciet een query wordt uitgevoerd op id. Resultaten omvatten geïmplementeerde toepassingen in actieve, activerende en downloadstatussen. Voor deze query moet de naam van het knooppunt overeenkomen met een knooppunt in het cluster. De query mislukt als de opgegeven knooppuntnaam niet verwijst naar actieve Service Fabric-knooppunten in het cluster.
Argumenten
| Argument | Beschrijving |
|---|---|
| --node-name [vereist] | De naam van het knooppunt. |
| --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. |
| --include-health-state | Neem de status van een entiteit op. Als deze parameter onwaar is of niet is opgegeven, is de geretourneerde status Onbekend. Als deze is ingesteld op true, wordt de query parallel uitgevoerd met het knooppunt en de statussysteemservice voordat de resultaten worden samengevoegd. Als gevolg hiervan is de query duurder en kan het langer duren. |
| --max-results | Het maximum aantal resultaten dat moet worden geretourneerd als onderdeel van de paginaquery's. Deze parameter definieert de bovengrens voor het aantal geretourneerde resultaten. De geretourneerde resultaten kunnen kleiner zijn dan de opgegeven maximumresultaten als ze niet in het bericht passen volgens de beperkingen voor maximale berichtgrootte die zijn gedefinieerd in de configuratie. Als deze parameter nul is of niet is opgegeven, bevat de gepaginade query zoveel mogelijk resultaten die in het retourbericht passen. |
| --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-toepassingsstatus
Hiermee haalt u de status van de Service Fabric-toepassing op.
Retourneert de status van de service fabric-toepassing. Het antwoord rapporteert de status OK, Fout of Waarschuwing. Als de entiteit niet wordt gevonden in het statusarchief, wordt fout geretourneerd.
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. |
| --deployed-applications-health-state-filter | Hiermee kunt u filteren van de geïmplementeerde statusobjecten voor toepassingen die worden geretourneerd in het resultaat van de toepassingsstatusquery op basis van hun status. De mogelijke waarden voor deze parameter bevatten een geheel getal van een van de volgende statussen. Alleen geïmplementeerde toepassingen die overeenkomen met het filter, worden geretourneerd. Alle geïmplementeerde 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, dus de waarde kan een combinatie van deze waarden zijn, verkregen met bitwise 'OR'-operator. Als de opgegeven waarde bijvoorbeeld 6 is, wordt de status van geïmplementeerde 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. |
| --services-health-state-filter | Hiermee kunt u filteren van de servicesstatusobjecten die worden geretourneerd in het resultaat van de servicesstatusquery op basis van hun statusstatus. De mogelijke waarden voor deze parameter bevatten een geheel getal van een van de volgende statussen. Alleen services die overeenkomen met het filter worden geretourneerd. Alle services 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 bitwise 'OR'-operator. Als de opgegeven waarde bijvoorbeeld 6 is, wordt de status van services met de healthstatewaarde 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-toepassingsgegevens
Hiermee haalt u informatie op over een Service Fabric-toepassing.
Retourneert de informatie over de toepassing die is gemaakt of tijdens het maken in het Service Fabric-cluster en waarvan de naam overeenkomt met de toepassing die is opgegeven als de parameter. Het antwoord bevat de naam, het type, de status, de parameters en andere details over de toepassing.
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. |
| --exclude-application-parameters | De vlag die aangeeft of toepassingsparameters worden uitgesloten van het resultaat. |
| --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-toepassingslijst
Hiermee haalt u de lijst op met toepassingen die zijn gemaakt in het Service Fabric-cluster die overeenkomen met de opgegeven filters.
Haalt de informatie op over de toepassingen die zijn gemaakt of tijdens het maken in het Service Fabric-cluster en overeenkomen met de opgegeven filters. Het antwoord bevat de naam, het type, de status, de parameters en andere details over de toepassing. Als de toepassingen niet op een pagina passen, wordt één pagina met resultaten geretourneerd, evenals een vervolgtoken, dat kan worden gebruikt om de volgende pagina op te halen. Filters ApplicationTypeName en ApplicationDefinitionKindFilter kunnen niet tegelijkertijd worden opgegeven.
Argumenten
| Argument | Beschrijving |
|---|---|
| --application-definition-kind-filter | Wordt gebruikt om te filteren op ApplicationDefinitionKind. Dit is het mechanisme dat wordt gebruikt om een Service Fabric-toepassing te definiëren. - Standaardwaarde- Standaardwaarde, waarmee dezelfde functie wordt uitgevoerd als het selecteren van 'Alles'. De waarde is 0. - Alle - Filter dat overeenkomt met invoer met een ApplicationDefinitionKind-waarde. De waarde is 65535. - ServiceFabricApplicationDescription - Filter dat overeenkomt met invoer met applicationDefinitionKind-waarde ServiceFabricApplicationDescription. De waarde is 1. - Opstellen - Filter dat overeenkomt met invoer met applicationDefinitionKind-waarde Compose. De waarde is 2. |
| --application-type-name | De naam van het toepassingstype dat wordt gebruikt om de toepassingen te filteren waarvoor een query moet worden uitgevoerd. Deze waarde mag niet de versie van het toepassingstype bevatten. |
| --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. |
| --exclude-application-parameters | De vlag die aangeeft of toepassingsparameters worden uitgesloten van het resultaat. |
| --max-results | Het maximum aantal resultaten dat moet worden geretourneerd als onderdeel van de paginaquery's. Deze parameter definieert de bovengrens voor het aantal geretourneerde resultaten. De geretourneerde resultaten kunnen kleiner zijn dan de opgegeven maximumresultaten als ze niet in het bericht passen volgens de beperkingen voor maximale berichtgrootte die zijn gedefinieerd in de configuratie. Als deze parameter nul is of niet is opgegeven, bevat de gepaginade query zoveel mogelijk resultaten die in het retourbericht passen. |
| --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-toepassing laden
Hiermee wordt informatie over het laden van een Service Fabric-toepassing opgehaald.
Retourneert de laadgegevens over de toepassing die is gemaakt of tijdens het maken in het Service Fabric-cluster en waarvan de naam overeenkomt met de toepassing die is opgegeven als de parameter. Het antwoord bevat de naam, minimumknooppunten, maximumknooppunten, het aantal knooppunten dat de toepassing momenteel in beslag neemt en metrische gegevens over de toepassing laden.
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. |
| --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-toepassingsmanifest
Hiermee haalt u het manifest op waarin een toepassingstype wordt beschreven.
Het antwoord bevat de XML van het toepassingsmanifest als een tekenreeks.
Argumenten
| Argument | Beschrijving |
|---|---|
| --application-type-name [vereist] | De naam van het toepassingstype. |
| --application-type-version [vereist] | De versie van het toepassingstype. |
| --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-toepassing inrichten
Richt een Service Fabric-toepassingstype in of registreert dit met het cluster met behulp van het pakket '.sfpkg' in de externe opslag of met behulp van het toepassingspakket in het installatiekopiearchief.
Richt een Service Fabric-toepassingstype in met het cluster. De inrichting is vereist voordat nieuwe toepassingen kunnen worden geïnstantieerd. De inrichtingsbewerking kan worden uitgevoerd op het toepassingspakket dat is opgegeven door de relativePathInImageStore of met behulp van de URI van de externe '.sfpkg'. Tenzij --external-provision is ingesteld, verwacht deze opdracht de inrichting van het installatiekopieënarchief.
Argumenten
| Argument | Beschrijving |
|---|---|
| --application-package-download-uri | Het pad naar het toepassingspakket .sfpkg van waaruit het toepassingspakket kan worden gedownload met behulp van HTTP- of HTTPS-protocollen. Alleen voor het inrichten van een extern archief. Het toepassingspakket kan worden opgeslagen in een extern archief dat GET-bewerking biedt om het bestand te downloaden. Ondersteunde protocollen zijn HTTP en HTTPS en het pad moet leestoegang toestaan. |
| --application-type-build-path | Alleen voor het inrichten van het type installatiekopieënarchief. Het relatieve pad voor het toepassingspakket in het afbeeldingsarchief dat is opgegeven tijdens de vorige uploadbewerking. |
| --application-type-name | Alleen voor het inrichten van een extern archief. De naam van het toepassingstype vertegenwoordigt de naam van het toepassingstype dat in het toepassingsmanifest is gevonden. |
| --application-type-version | Alleen voor het inrichten van een extern archief. De versie van het toepassingstype vertegenwoordigt de versie van het toepassingstype in het toepassingsmanifest. |
| --extern inrichten | De locatie waar het toepassingspakket kan worden geregistreerd of ingericht. Geeft aan dat de inrichting is bedoeld voor een toepassingspakket dat eerder is geüpload naar een extern archief. Het toepassingspakket eindigt met de extensie *.sfpkg. |
| --no-wait | Hiermee wordt aangegeven of inrichting asynchroon moet plaatsvinden. Als deze is ingesteld op waar, wordt de inrichtingsbewerking geretourneerd wanneer de aanvraag wordt geaccepteerd door het systeem en wordt de inrichtingsbewerking zonder time-outlimiet voortgezet. De standaardwaarde is false. Voor grote toepassingspakketten wordt u aangeraden de waarde in te stellen op true. |
| --time-out -t | 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 application report-health
Hiermee wordt een statusrapport verzonden over de Service Fabric-toepassing.
Rapporteert de status van de opgegeven Service Fabric-toepassing. 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-gatewaytoepassing, 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, haalt u de status van de toepassing op en controleert u of het rapport wordt weergegeven.
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. |
| --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-toepassingstype
Hiermee haalt u de lijst met toepassingstypen in het Service Fabric-cluster op die exact overeenkomen met de opgegeven naam.
Retourneert de informatie over de toepassingstypen die zijn ingericht of die worden ingericht in het Service Fabric-cluster. Deze resultaten zijn van toepassingstypen waarvan de naam exact overeenkomt met de naam die is opgegeven als de parameter en die voldoen aan de opgegeven queryparameters. Alle versies van het toepassingstype die overeenkomen met de naam van het toepassingstype worden geretourneerd, waarbij elke versie wordt geretourneerd als één toepassingstype. Het antwoord bevat de naam, versie, status en andere details over het toepassingstype. Dit is een gepaginade query, wat betekent dat als niet alle toepassingstypen op een pagina passen, één pagina met resultaten wordt geretourneerd, evenals een vervolgtoken, dat kan worden gebruikt om de volgende pagina op te halen. Als er bijvoorbeeld 10 toepassingstypen zijn, maar een pagina alleen past bij de eerste drie toepassingstypen, of als het maximum aantal resultaten is ingesteld op 3, wordt er drie geretourneerd. Als u de rest van de resultaten wilt openen, haalt u de volgende pagina's op met behulp van het geretourneerde vervolgtoken in de volgende query. Er wordt een leeg vervolgtoken geretourneerd als er geen volgende pagina's zijn.
Argumenten
| Argument | Beschrijving |
|---|---|
| --application-type-name [vereist] | De naam van het toepassingstype. |
| --application-type-version | De versie van het toepassingstype. |
| --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. |
| --exclude-application-parameters | De vlag die aangeeft of toepassingsparameters worden uitgesloten van het resultaat. |
| --max-results | Het maximum aantal resultaten dat moet worden geretourneerd als onderdeel van de paginaquery's. Deze parameter definieert de bovengrens voor het aantal geretourneerde resultaten. De geretourneerde resultaten kunnen kleiner zijn dan de opgegeven maximumresultaten als ze niet in het bericht passen volgens de beperkingen voor maximale berichtgrootte die zijn gedefinieerd in de configuratie. Als deze parameter nul is of niet is opgegeven, bevat de gepaginade query zoveel mogelijk resultaten die in het retourbericht passen. |
| --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-toepassingstypelijst
Hiermee haalt u de lijst met toepassingstypen op in het Service Fabric-cluster.
Retourneert de informatie over de toepassingstypen die zijn ingericht of die worden ingericht in het Service Fabric-cluster. Elke versie van een toepassingstype wordt geretourneerd als één toepassingstype. Het antwoord bevat de naam, versie, status en andere details over het toepassingstype. Dit is een gepaginade query, wat betekent dat als niet alle toepassingstypen op een pagina passen, één pagina met resultaten wordt geretourneerd, evenals een vervolgtoken, dat kan worden gebruikt om de volgende pagina op te halen. Als er bijvoorbeeld 10 toepassingstypen zijn, maar een pagina alleen past bij de eerste drie toepassingstypen, of als het maximum aantal resultaten is ingesteld op 3, wordt er drie geretourneerd. Als u de rest van de resultaten wilt openen, haalt u de volgende pagina's op met behulp van het geretourneerde vervolgtoken in de volgende query. Er wordt een leeg vervolgtoken geretourneerd als er geen volgende pagina's zijn.
Argumenten
| Argument | Beschrijving |
|---|---|
| --application-type-definition-kind-filter | Wordt gebruikt om te filteren op ApplicationTypeDefinitionKind. Dit is het mechanisme dat wordt gebruikt om een Service Fabric-toepassingstype te definiëren. - Standaardwaarde- Standaardwaarde, waarmee dezelfde functie wordt uitgevoerd als het selecteren van 'Alles'. De waarde is 0. - Alle - Filter dat overeenkomt met invoer met een ApplicationTypeDefinitionKind-waarde. De waarde is 65535. - ServiceFabricApplicationPackage - Filter dat overeenkomt met invoer met applicationTypeDefinitionKind-waarde ServiceFabricApplicationPackage. De waarde is 1. - Opstellen - Filter dat overeenkomt met invoer met applicationTypeDefinitionKind-waarde Opstellen. De waarde is 2. |
| --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. |
| --exclude-application-parameters | De vlag die aangeeft of toepassingsparameters worden uitgesloten van het resultaat. |
| --max-results | Het maximum aantal resultaten dat moet worden geretourneerd als onderdeel van de paginaquery's. Deze parameter definieert de bovengrens voor het aantal geretourneerde resultaten. De geretourneerde resultaten kunnen kleiner zijn dan de opgegeven maximumresultaten als ze niet in het bericht passen volgens de beperkingen voor maximale berichtgrootte die zijn gedefinieerd in de configuratie. Als deze parameter nul is of niet is opgegeven, bevat de gepaginade query zoveel mogelijk resultaten die in het retourbericht passen. |
| --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. |
inrichting van sfctl-toepassing ongedaan maken
Hiermee verwijdert of verwijdert u de registratie van een Service Fabric-toepassingstype uit het cluster.
Deze bewerking kan alleen worden uitgevoerd als alle toepassingsexemplaren van het toepassingstype zijn verwijderd. Zodra de registratie van het toepassingstype ongedaan is gemaakt, kunnen er geen nieuwe toepassingsexemplaren worden gemaakt voor dit specifieke toepassingstype.
Argumenten
| Argument | Beschrijving |
|---|---|
| --application-type-name [vereist] | De naam van het toepassingstype. |
| --application-type-version [vereist] | De versie van het toepassingstype zoals gedefinieerd in het toepassingsmanifest. |
| --async-parameter | De vlag die aangeeft of de inrichting wel of niet ongedaan moet worden gemaakt, moet asynchroon plaatsvinden. Als deze is ingesteld op true, wordt de inrichtingsbewerking geretourneerd wanneer de aanvraag wordt geaccepteerd door het systeem en blijft de inrichtingsbewerking ongedaan maken zonder een time-outlimiet. De standaardwaarde is false. We raden u echter aan dit in te stellen op waar voor grote toepassingspakketten die zijn ingericht. |
| --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-toepassing
Hiermee start u een upgrade van een toepassing in het Service Fabric-cluster.
Valideert de opgegeven parameters voor de toepassingsupgrade en start de upgrade van de toepassing als de parameters geldig zijn. De beschrijving van de upgrade vervangt de beschrijving van de bestaande toepassing. Dit betekent dat als de parameters niet zijn opgegeven, de bestaande parameters in de toepassingen worden overschreven met de lege parameterslijst. Dit zou ertoe leiden dat de toepassing de standaardwaarde van de parameters uit het toepassingsmanifest gebruikt.
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. |
| --application-version [vereist] | De versie van het doeltoepassingstype (gevonden in het toepassingsmanifest) voor de toepassingsupgrade. |
| --parameters [vereist] | Een door JSON gecodeerde lijst met toepassingsparameteroverschrijvingen die moeten worden toegepast bij het bijwerken van de toepassing. |
| --default-service-health-policy | In JSON gecodeerde specificatie van het statusbeleid dat standaard wordt gebruikt om de status van een servicetype te evalueren. |
| --failure-action | De actie die moet worden uitgevoerd wanneer een bewaakte upgrade te maken krijgt met het bewaken van beleid of schendingen van het statusbeleid. |
| --force-restart | Geforceerd opnieuw opstarten van processen tijdens de upgrade, zelfs wanneer de codeversie niet is gewijzigd. |
| --health-check-retry-time-out | De tijdsduur tussen pogingen om statuscontroles uit te voeren als de toepassing of het cluster niet in orde is. Standaard: PT0H10M0S. |
| --health-check-stable-duration | De hoeveelheid tijd die de toepassing of het cluster in orde moet blijven voordat de upgrade naar het volgende upgradedomein gaat. Standaard: PT0H2M0S. 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-duration | De tijd die moet worden gewacht na het voltooien van een upgradedomein voordat het statuscontrolesproces wordt gestart. Standaard: 0. |
| --max-beschadigde-apps | Het maximaal toegestane percentage geïmplementeerde toepassingen dat niet in orde is. Vertegenwoordigd als een getal tussen 0 en 100. |
| --wijze | De modus die wordt gebruikt om de status tijdens een rolling upgrade te bewaken. Standaard: UnmonitoredAuto. |
| --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. Gemeten in seconden. |
| --service-health-policy | JSON-gecodeerde toewijzing met servicetypestatusbeleid per servicetypenaam. De kaart is leeg. |
| --time-out -t | Standaard: 60. |
| --upgrade-domein-time-out | De hoeveelheid tijd die elk upgradedomein moet voltooien voordat FailureAction wordt uitgevoerd. Standaard: P10675199DT02H48M05.4775807S. 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. Standaard: P10675199DT02H48M05.4775807S. 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-toepassing
Hiermee wordt een upgrade van een toepassing in het Service Fabric-cluster hervat.
Hiermee wordt een niet-bewaakte handmatige Service Fabric-toepassingsupgrade hervat. Service Fabric werkt één upgradedomein tegelijk bij. Voor niet-bewaakte handmatige upgrades wacht Service Fabric nadat een upgradedomein is voltooid, totdat u deze API aanroept voordat u doorgaat naar het volgende upgradedomein.
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. |
| --upgrade-domeinnaam [vereist] | De naam van het upgradedomein waarin de upgrade moet worden hervat. |
| --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-toepassing upgrade-rollback
Hiermee wordt de huidige upgrade van een toepassing in het Service Fabric-cluster teruggezet.
Hiermee wordt de huidige toepassingsupgrade teruggezet naar de vorige versie. Deze API kan alleen worden gebruikt voor het terugdraaien van de huidige upgrade die wordt uitgevoerd naar een nieuwe versie. Als de toepassing momenteel niet wordt bijgewerkt, gebruikt u de StartApplicationUpgrade-API om deze te upgraden naar de gewenste versie, inclusief terugdraaien naar een vorige versie.
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. |
| --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-toepassing
Hiermee haalt u details op voor de meest recente upgrade die op deze toepassing is uitgevoerd.
Retourneert informatie over de status van de meest recente toepassingsupgrade, samen met details om foutopsporing van toepassingsstatusproblemen te helpen.
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. |
| --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-toepassing uploaden
Kopieer een Service Fabric-toepassingspakket naar het installatiekopiearchief.
Geef eventueel de voortgang van het uploaden weer voor elk bestand in het pakket. De voortgang van het uploaden wordt verzonden naar stderr.
Argumenten
| Argument | Beschrijving |
|---|---|
| --path [vereist] | Pad naar lokaal toepassingspakket. |
| --comprimeren | Alleen van toepassing op Service Fabric-toepassingspakketten. Maak een nieuwe map met het gecomprimeerde toepassingspakket naar de standaardlocatie of naar de locatie die is opgegeven door de parameter gecomprimeerde locatie en upload vervolgens de zojuist gemaakte map. Als er al een gecomprimeerd bestand is gegenereerd door sfctl, wordt het overschreven als deze vlag is ingesteld. Er wordt een fout geretourneerd als de map geen toepassingspakket is. Als het al een gecomprimeerd toepassingspakket is, wordt de map naar behoren gekopieerd. Standaard wordt het zojuist gemaakte gecomprimeerde toepassingspakket verwijderd na een geslaagde upload. Als het uploaden niet lukt, moet u het gecomprimeerde pakket indien nodig handmatig opschonen. De verwijdering verwijdert geen lege dirs die mogelijk zijn gemaakt als de gecomprimeerde locatieparameter verwijst naar niet-bestaande mappen. |
| --gecomprimeerde locatie | De locatie voor het plaatsen van het gecomprimeerde toepassingspakket. Als er geen locatie is opgegeven, wordt het gecomprimeerde pakket geplaatst onder een zojuist gemaakte map met de naam sfctl_compressed_temp onder de bovenliggende map die is opgegeven in het padargument. Als het padargument bijvoorbeeld de waarde C:/FolderA/AppPkg heeft, wordt het gecomprimeerde pakket toegevoegd aan C:/FolderA/sfctl_compressed_temp/AppPkg. |
| --imagestore-string | Doelinstallatiekopieënarchief om het toepassingspakket te uploaden naar. Standaard: fabric:ImageStore. Als u wilt uploaden naar een bestandslocatie, start u deze parameter met 'bestand:'. Anders moet de waarde het afbeeldingsarchief zijn verbindingsreeks, zoals de standaardwaarde. |
| --keep-compressed | Of u het gegenereerde gecomprimeerde pakket al dan niet wilt behouden bij een geslaagde voltooiing van het uploaden. Als dit niet is ingesteld, worden de gecomprimeerde app-pakketten na voltooiing verwijderd. Als het uploaden niet is gelukt, wordt het toepassingspakket altijd bewaard in de uitvoermap voor opnieuw uploaden. |
| --show-progress | De voortgang van het uploaden van bestanden voor grote pakketten weergeven. |
| --time-out -t | De totale time-out in seconden. Uploaden mislukt en retourneert een fout nadat de duur van de uploadtime-out is verstreken. Deze time-out is van toepassing op het hele toepassingspakket en afzonderlijke bestandstime-outs zijn gelijk aan de resterende time-outduur. Time-out omvat niet de tijd die nodig is om het toepassingspakket te comprimeren. Standaard: 300. |
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.