Dela via


sfctl application

Skapa, ta bort och hantera program och programtyper.

Kommandon

Kommando beskrivning
skapa Skapar ett Service Fabric-program med den angivna beskrivningen.
delete Tar bort ett befintligt Service Fabric-program.
Distribuerat Hämtar information om ett program som distribueras på en Service Fabric-nod.
deployed-health Hämtar information om hälsotillståndet för ett program som distribueras på en Service Fabric-nod.
deployed-list Hämtar listan över program som distribueras på en Service Fabric-nod.
hälsa Hämtar hälsotillståndet för service fabric-programmet.
information Hämtar information om ett Service Fabric-program.
lista Hämtar listan över program som skapats i Service Fabric-klustret som matchar de angivna filtren.
läser in Hämtar information om ett Service Fabric-program.
manifest Hämtar manifestet som beskriver en programtyp.
bestämmelse Etablerar eller registrerar en Service Fabric-programtyp med klustret med hjälp av paketet '.sfpkg' i det externa arkivet eller med hjälp av programpaketet i avbildningsarkivet.
report-health Skickar en hälsorapport i Service Fabric-programmet.
type Hämtar listan över programtyper i Service Fabric-klustret som matchar exakt det angivna namnet.
type-list Hämtar listan över programtyper i Service Fabric-klustret.
avetablering Tar bort eller avregistrerar en Service Fabric-programtyp från klustret.
uppgradera Börjar uppgradera ett program i Service Fabric-klustret.
upgrade-resume Återupptar uppgraderingen av ett program i Service Fabric-klustret.
upgrade-rollback Börjar återställa den pågående uppgraderingen av ett program i Service Fabric-klustret.
upgrade-status Hämtar information om den senaste uppgraderingen som utförts i det här programmet.
ladda upp Kopiera ett Service Fabric-programpaket till avbildningsarkivet.

skapa sfctl-program

Skapar ett Service Fabric-program med den angivna beskrivningen.

Argument

Argument beskrivning
--app-name [Krävs] Namnet på programmet, inklusive URI-schemat "fabric:".
--app-type [Krävs] Namnet på programtypen som finns i programmanifestet.
--app-version [Krävs] Den version av programtypen som definierats i programmanifestet.
--max-node-count Det maximala antalet noder där Service Fabric reserverar kapacitet för det här programmet. Observera att detta inte innebär att tjänsterna i det här programmet placeras på alla dessa noder.
--metrik En JSON-kodad lista över beskrivningar av programkapacitetsmått. Ett mått definieras som ett namn som är associerat med en uppsättning kapaciteter för varje nod som programmet finns på.
--min-node-count Det minsta antalet noder där Service Fabric reserverar kapacitet för det här programmet. Observera att detta inte innebär att tjänsterna i det här programmet placeras på alla dessa noder.
--Parametrar En JSON-kodad lista över åsidosättningar av programparametrar som ska tillämpas när programmet skapas.
--timeout -t Standard: 60.

Globala argument

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

sfctl-programborttagning

Tar bort ett befintligt Service Fabric-program.

Ett program måste skapas innan det kan tas bort. Om du tar bort ett program tas alla tjänster som ingår i programmet bort. Som standard försöker Service Fabric stänga tjänstrepliker på ett korrekt sätt och sedan ta bort tjänsten. Men om en tjänst har problem med att stänga repliken korrekt kan borttagningsåtgärden ta lång tid eller fastna. Använd den valfria ForceRemove-flaggan för att hoppa över den graciösa stängningssekvensen och ta bort programmet och alla dess tjänster med kraft.

Argument

Argument beskrivning
--application-id [Krävs] Programmets identitet. Detta är vanligtvis det fullständiga namnet på programmet utan URI-schemat "fabric:". Från och med version 6.0 avgränsas hierarkiska namn med tecknet "~". Om programnamnet till exempel är "fabric:/myapp/app1" skulle programidentiteten vara "myapp~app1" i 6.0+ och "myapp/app1" i tidigare versioner.
--force-remove Ta bort ett Service Fabric-program eller en tjänst med kraft utan att gå igenom den graciösa avstängningssekvensen. Den här parametern kan användas för att ta bort ett program eller en tjänst som borttagningen tar tid för på grund av problem i tjänstkoden som förhindrar att repliker stängs korrekt.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

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

sfctl-program distribuerat

Hämtar information om ett program som distribueras på en Service Fabric-nod.

Den här frågan returnerar systemprograminformation om det angivna program-ID:t är för systemprogram. Resultaten omfattar distribuerade program i aktiva tillstånd, aktivering och nedladdning. Den här frågan kräver att nodnamnet motsvarar en nod i klustret. Frågan misslyckas om det angivna nodnamnet inte pekar på några aktiva Service Fabric-noder i klustret.

Argument

Argument beskrivning
--application-id [Krävs] Programmets identitet. Detta är vanligtvis det fullständiga namnet på programmet utan URI-schemat "fabric:". Från och med version 6.0 avgränsas hierarkiska namn med tecknet "~". Om programnamnet till exempel är "fabric:/myapp/app1" skulle programidentiteten vara "myapp~app1" i 6.0+ och "myapp/app1" i tidigare versioner.
--node-name [Krävs] Namnet på noden.
--include-health-state Inkludera hälsotillståndet för en entitet. Om den här parametern är falsk eller inte angiven är hälsotillståndet som returneras "Okänt". När den är inställd på true går frågan parallellt med noden och hälsosystemtjänsten innan resultatet slås samman. Därför är frågan dyrare och kan ta längre tid.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

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

sfctl-program distribuerat-hälsa

Hämtar information om hälsotillståndet för ett program som distribueras på en Service Fabric-nod.

Hämtar information om hälsotillståndet för ett program som distribueras på en Service Fabric-nod. Använd EventsHealthStateFilter för att eventuellt filtrera efter samlingen med HealthEvent-objekt som rapporterats i det distribuerade programmet baserat på hälsotillståndet. Använd DeployedServicePackagesHealthStateFilter för att eventuellt filtrera efter DeployedServicePackageHealth-barn baserat på hälsotillstånd.

Argument

Argument beskrivning
--application-id [Krävs] Programmets identitet. Detta är vanligtvis det fullständiga namnet på programmet utan URI-schemat "fabric:". Från och med version 6.0 avgränsas hierarkiska namn med tecknet "~". Om programnamnet till exempel är "fabric:/myapp/app1" skulle programidentiteten vara "myapp~app1" i 6.0+ och "myapp/app1" i tidigare versioner.
--node-name [Krävs] Namnet på noden.
--deployed-service-packages-health-state-filter Tillåter filtrering av de distribuerade hälsotillståndsobjekten för tjänstpaket som returneras i resultatet av distribuerad hälsofråga för program baserat på deras hälsotillstånd. Möjliga värden för den här parametern inkluderar heltalsvärdet för något av följande hälsotillstånd. Endast distribuerade tjänstpaket som matchar filtret returneras. Alla distribuerade tjänstpaket används för att utvärdera det distribuerade programmets aggregerade hälsotillstånd. Om det inte anges returneras alla poster. Tillståndsvärdena är flaggbaserad uppräkning, så värdet kan vara en kombination av dessa värden, som erhålls med hjälp av operatorn "OR" på bitvis. Om det angivna värdet till exempel är 6 returneras hälsotillståndet för tjänstpaket med HealthState-värdet OK (2) och Varning (4).
– Standard – standardvärde. Matchar alla HealthState. Värdet är noll.
– Ingen – Filter som inte matchar något HealthState-värde. Används för att inte returnera några resultat för en viss samling tillstånd. Värdet är 1.
- Ok – Filter som matchar indata med HealthState-värdet Ok. Värdet är 2.
– Varning – Filter som matchar indata med HealthState-värdet Varning. Värdet är 4.
– Fel – Filter som matchar indata med HealthState-värdet Fel. Värdet är 8.
– Alla – Filter som matchar indata med alla HealthState-värden. Värdet är 65535.
--events-health-state-filter Tillåter filtrering av samlingen med HealthEvent-objekt som returneras baserat på hälsotillståndet. Möjliga värden för den här parametern inkluderar heltalsvärdet för något av följande hälsotillstånd. Endast händelser som matchar filtret returneras. Alla händelser används för att utvärdera det aggregerade hälsotillståndet. Om det inte anges returneras alla poster. Tillståndsvärdena är flaggbaserad uppräkning, så värdet kan vara en kombination av dessa värden, som erhålls med hjälp av operatorn OR på bitvis. Om det angivna värdet till exempel är 6 returneras alla händelser med HealthState-värdet OK (2) och Varning (4).
– Standard – standardvärde. Matchar alla HealthState. Värdet är noll.
– Ingen – Filter som inte matchar något HealthState-värde. Används för att inte returnera några resultat för en viss samling tillstånd. Värdet är 1.
- Ok – Filter som matchar indata med HealthState-värdet Ok. Värdet är 2.
– Varning – Filter som matchar indata med HealthState-värdet Varning. Värdet är 4.
– Fel – Filter som matchar indata med HealthState-värdet Fel. Värdet är 8.
– Alla – Filter som matchar indata med alla HealthState-värden. Värdet är 65535.
--exclude-health-statistics Anger om hälsostatistiken ska returneras som en del av frågeresultatet. Falskt som standard. Statistiken visar antalet underordnade entiteter i hälsotillståndet Ok, Varning och Fel.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

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

sfctl application deployed-list

Hämtar listan över program som distribueras på en Service Fabric-nod.

Hämtar listan över program som distribueras på en Service Fabric-nod. Resultaten innehåller inte information om distribuerade systemprogram om de inte uttryckligen efterfrågas av ID. Resultaten omfattar distribuerade program i aktiva tillstånd, aktivering och nedladdning. Den här frågan kräver att nodnamnet motsvarar en nod i klustret. Frågan misslyckas om det angivna nodnamnet inte pekar på några aktiva Service Fabric-noder i klustret.

Argument

Argument beskrivning
--node-name [Krävs] Namnet på noden.
--continuation-token Parametern fortsättningstoken används för att hämta nästa uppsättning resultat. En fortsättningstoken med ett värde som inte är tomt ingår i API:ets svar när resultatet från systemet inte får plats i ett enda svar. När det här värdet skickas till nästa API-anrop returnerar API:et nästa uppsättning resultat. Om det inte finns några ytterligare resultat innehåller fortsättningstoken inget värde. Värdet för den här parametern ska inte vara URL-kodat.
--include-health-state Inkludera hälsotillståndet för en entitet. Om den här parametern är falsk eller inte angiven är hälsotillståndet som returneras "Okänt". När den är inställd på true går frågan parallellt med noden och hälsosystemtjänsten innan resultatet slås samman. Därför är frågan dyrare och kan ta längre tid.
--max-results Det maximala antalet resultat som ska returneras som en del av de sidiga frågorna. Den här parametern definierar den övre gränsen för det antal resultat som returneras. Resultatet som returneras kan vara mindre än det angivna maximala resultatet om de inte får plats i meddelandet enligt de maximala begränsningarna för meddelandestorlek som definierats i konfigurationen. Om den här parametern är noll eller inte har angetts innehåller den sidvända frågan så många resultat som möjligt som får plats i returmeddelandet.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

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

sfctl-programhälsa

Hämtar hälsotillståndet för service fabric-programmet.

Returnerar hälsotillståndet för service fabric-programmet. Svaret rapporterar antingen OK, Fel eller Varning hälsotillstånd. Om entiteten inte hittas i hälsoarkivet returneras Fel.

Argument

Argument beskrivning
--application-id [Krävs] Programmets identitet. Detta är vanligtvis det fullständiga namnet på programmet utan URI-schemat "fabric:". Från och med version 6.0 avgränsas hierarkiska namn med tecknet "~". Om programnamnet till exempel är "fabric:/myapp/app1" skulle programidentiteten vara "myapp~app1" i 6.0+ och "myapp/app1" i tidigare versioner.
--deployed-applications-health-state-filter Tillåter filtrering av de distribuerade programhälsotillståndsobjekt som returneras i resultatet av programhälsofrågan baserat på deras hälsotillstånd. Möjliga värden för den här parametern inkluderar heltalsvärdet för något av följande hälsotillstånd. Endast distribuerade program som matchar filtret returneras. Alla distribuerade program används för att utvärdera det aggregerade hälsotillståndet. Om det inte anges returneras alla poster. Tillståndsvärdena är flaggbaserad uppräkning, så värdet kan vara en kombination av dessa värden som erhålls med hjälp av bitvis "OR"-operator. Om det angivna värdet till exempel är 6 returneras hälsotillståndet för distribuerade program med HealthState-värdet OK (2) och Varning (4).
– Standard – standardvärde. Matchar alla HealthState. Värdet är noll.
– Ingen – Filter som inte matchar något HealthState-värde. Används för att inte returnera några resultat för en viss samling tillstånd. Värdet är 1.
- Ok – Filter som matchar indata med HealthState-värdet Ok. Värdet är 2.
– Varning – Filter som matchar indata med HealthState-värdet Varning. Värdet är 4.
– Fel – Filter som matchar indata med HealthState-värdet Fel. Värdet är 8.
– Alla – Filter som matchar indata med alla HealthState-värden. Värdet är 65535.
--events-health-state-filter Tillåter filtrering av samlingen med HealthEvent-objekt som returneras baserat på hälsotillståndet. Möjliga värden för den här parametern inkluderar heltalsvärdet för något av följande hälsotillstånd. Endast händelser som matchar filtret returneras. Alla händelser används för att utvärdera det aggregerade hälsotillståndet. Om det inte anges returneras alla poster. Tillståndsvärdena är flaggbaserad uppräkning, så värdet kan vara en kombination av dessa värden, som erhålls med hjälp av operatorn OR på bitvis. Om det angivna värdet till exempel är 6 returneras alla händelser med HealthState-värdet OK (2) och Varning (4).
– Standard – standardvärde. Matchar alla HealthState. Värdet är noll.
– Ingen – Filter som inte matchar något HealthState-värde. Används för att inte returnera några resultat för en viss samling tillstånd. Värdet är 1.
- Ok – Filter som matchar indata med HealthState-värdet Ok. Värdet är 2.
– Varning – Filter som matchar indata med HealthState-värdet Varning. Värdet är 4.
– Fel – Filter som matchar indata med HealthState-värdet Fel. Värdet är 8.
– Alla – Filter som matchar indata med alla HealthState-värden. Värdet är 65535.
--exclude-health-statistics Anger om hälsostatistiken ska returneras som en del av frågeresultatet. Falskt som standard. Statistiken visar antalet underordnade entiteter i hälsotillståndet Ok, Varning och Fel.
--services-health-state-filter Tillåter filtrering av hälsotillståndsobjekt för tjänster som returneras i resultatet av hälsofrågan för tjänster baserat på deras hälsotillstånd. Möjliga värden för den här parametern inkluderar heltalsvärdet för något av följande hälsotillstånd. Endast tjänster som matchar filtret returneras. Alla tjänster används för att utvärdera det aggregerade hälsotillståndet. Om det inte anges returneras alla poster. Tillståndsvärdena är flaggbaserad uppräkning, så värdet kan vara en kombination av dessa värden som erhålls med hjälp av bitvis "OR"-operator. Om det angivna värdet till exempel är 6 returneras hälsotillståndet för tjänster med HealthState-värdet OK (2) och Varning (4).
– Standard – standardvärde. Matchar alla HealthState. Värdet är noll.
– Ingen – Filter som inte matchar något HealthState-värde. Används för att inte returnera några resultat för en viss samling tillstånd. Värdet är 1.
- Ok – Filter som matchar indata med HealthState-värdet Ok. Värdet är 2.
– Varning – Filter som matchar indata med HealthState-värdet Varning. Värdet är 4.
– Fel – Filter som matchar indata med HealthState-värdet Fel. Värdet är 8.
– Alla – Filter som matchar indata med alla HealthState-värden. Värdet är 65535.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

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

sfctl-programinformation

Hämtar information om ett Service Fabric-program.

Returnerar informationen om programmet som skapades eller håller på att skapas i Service Fabric-klustret och vars namn matchar det som anges som parametern. Svaret innehåller namn, typ, status, parametrar och annan information om programmet.

Argument

Argument beskrivning
--application-id [Krävs] Programmets identitet. Detta är vanligtvis det fullständiga namnet på programmet utan URI-schemat "fabric:". Från och med version 6.0 avgränsas hierarkiska namn med tecknet "~". Om programnamnet till exempel är "fabric:/myapp/app1" skulle programidentiteten vara "myapp~app1" i 6.0+ och "myapp/app1" i tidigare versioner.
--exclude-application-parameters Flaggan som anger om programparametrar ska undantas från resultatet.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

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

sfctl-programlista

Hämtar listan över program som skapats i Service Fabric-klustret som matchar de angivna filtren.

Hämtar information om de program som har skapats eller håller på att skapas i Service Fabric-klustret och matcha de angivna filtren. Svaret innehåller namn, typ, status, parametrar och annan information om programmet. Om programmen inte får plats på en sida returneras en sida med resultat samt en fortsättningstoken som kan användas för att hämta nästa sida. Filter ApplicationTypeName och ApplicationDefinitionKindFilter kan inte anges samtidigt.

Argument

Argument beskrivning
--application-definition-kind-filter Används för att filtrera på ApplicationDefinitionKind, vilket är den mekanism som används för att definiera ett Service Fabric-program.
– Standard – Standardvärde, som utför samma funktion som att välja "Alla". Värdet är 0.
– Alla – Filter som matchar indata med valfritt ApplicationDefinitionKind-värde. Värdet är 65535.
– ServiceFabricApplicationDescription – filter som matchar indata med ApplicationDefinitionKind-värdet ServiceFabricApplicationDescription. Värdet är 1.
– Skriv – Filter som matchar indata med ApplicationDefinitionKind-värdet Compose. Värdet är 2.
--application-type-name Namnet på programtypen som används för att filtrera de program som ska frågas efter. Det här värdet får inte innehålla programtypsversionen.
--continuation-token Parametern fortsättningstoken används för att hämta nästa uppsättning resultat. En fortsättningstoken med ett värde som inte är tomt ingår i API:ets svar när resultatet från systemet inte får plats i ett enda svar. När det här värdet skickas till nästa API-anrop returnerar API:et nästa uppsättning resultat. Om det inte finns några ytterligare resultat innehåller fortsättningstoken inget värde. Värdet för den här parametern ska inte vara URL-kodat.
--exclude-application-parameters Flaggan som anger om programparametrar ska undantas från resultatet.
--max-results Det maximala antalet resultat som ska returneras som en del av de sidiga frågorna. Den här parametern definierar den övre gränsen för det antal resultat som returneras. Resultatet som returneras kan vara mindre än det angivna maximala resultatet om de inte får plats i meddelandet enligt de maximala begränsningarna för meddelandestorlek som definierats i konfigurationen. Om den här parametern är noll eller inte har angetts innehåller den sidvända frågan så många resultat som möjligt som får plats i returmeddelandet.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

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

sfctl-programbelastning

Hämtar information om ett Service Fabric-program.

Returnerar inläsningsinformationen om programmet som skapades eller håller på att skapas i Service Fabric-klustret och vars namn matchar det som anges som parametern. Svaret innehåller namn, minsta noder, maximala noder, antalet noder som programmet upptar för närvarande och information om programmets inläsningsmått.

Argument

Argument beskrivning
--application-id [Krävs] Programmets identitet. Detta är vanligtvis det fullständiga namnet på programmet utan URI-schemat "fabric:". Från och med version 6.0 avgränsas hierarkiska namn med tecknet "~". Om programnamnet till exempel är "fabric:/myapp/app1" skulle programidentiteten vara "myapp~app1" i 6.0+ och "myapp/app1" i tidigare versioner.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

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

sfctl-programmanifest

Hämtar manifestet som beskriver en programtyp.

Svaret innehåller programmanifestets XML som en sträng.

Argument

Argument beskrivning
--application-type-name [Krävs] Namnet på programtypen.
--application-type-version [Krävs] Versionen av programtypen.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

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

sfctl-programetablering

Etablerar eller registrerar en Service Fabric-programtyp med klustret med hjälp av paketet '.sfpkg' i det externa arkivet eller med hjälp av programpaketet i avbildningsarkivet.

Etablerar en Service Fabric-programtyp med klustret. Etableringen krävs innan nya program kan instansieras. Etableringsåtgärden kan utföras antingen på det programpaket som anges av relativePathInImageStore eller med hjälp av URI:n för den externa '.sfpkg'. Om inte --external-provision har angetts förväntar sig det här kommandot etablering av avbildningsarkivet.

Argument

Argument beskrivning
--application-package-download-uri Sökvägen till programpaketet ".sfpkg" där programpaketet kan laddas ned med hjälp av HTTP- eller HTTPS-protokoll.

Endast för externt lager av etableringstyp. Programpaketet kan lagras i ett externt arkiv som tillhandahåller GET-åtgärd för att ladda ned filen. Protokoll som stöds är HTTP och HTTPS, och sökvägen måste tillåta LÄS-åtkomst.
--application-type-build-path Endast för avbildningsarkiv för etableringstyp. Den relativa sökvägen för programpaketet i avbildningsarkivet som angavs under den tidigare uppladdningsåtgärden.
--application-type-name Endast för externt lager av etableringstyp. Namnet på programtypen representerar namnet på programtypen som finns i programmanifestet.
--application-type-version Endast för externt lager av etableringstyp. Programtypens version representerar den version av programtypen som finns i programmanifestet.
--external-provision Platsen där programpaketet kan registreras eller etableras. Anger att etableringen gäller för ett programpaket som tidigare laddades upp till ett externt arkiv. Programpaketet avslutas med tillägget *.sfpkg.
--no-wait Anger om etableringen ska ske asynkront eller inte.

När värdet är true returneras etableringsåtgärden när begäran godkänns av systemet och etableringsåtgärden fortsätter utan någon tidsgräns. Standardvärdet är "false". För stora programpaket rekommenderar vi att du ställer in värdet på true.
--timeout -t Standard: 60.

Globala argument

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

sfctl application report-health

Skickar en hälsorapport i Service Fabric-programmet.

Rapporterar hälsotillståndet för det angivna Service Fabric-programmet. Rapporten måste innehålla information om källan till hälsorapporten och egenskapen som den rapporteras för. Rapporten skickas till ett Service Fabric-gatewayprogram som vidarebefordras till hälsoarkivet. Rapporten kan godkännas av gatewayen, men avvisas av hälsoarkivet efter extra validering. Hälsoarkivet kan till exempel avvisa rapporten på grund av en ogiltig parameter, till exempel ett inaktuellt sekvensnummer. Om du vill se om rapporten har tillämpats i hälsoarkivet hämtar du programmets hälsa och kontrollerar att rapporten visas.

Argument

Argument beskrivning
--application-id [Krävs] Programmets identitet.

Detta är vanligtvis det fullständiga namnet på programmet utan URI-schemat "fabric:". Från och med version 6.0 avgränsas hierarkiska namn med tecknet ~. Om programnamnet till exempel är "fabric:/myapp/app1" skulle programidentiteten vara "myapp~app1" i 6.0+ och "myapp/app1" i tidigare versioner.
--health-property [Krävs] Egenskapen för hälsoinformationen.

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

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

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

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

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

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

Globala argument

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

sfctl-programtyp

Hämtar listan över programtyper i Service Fabric-klustret som matchar exakt det angivna namnet.

Returnerar information om de programtyper som etableras eller håller på att etableras i Service Fabric-klustret. Dessa resultat är av programtyper vars namn matchar exakt den som anges som parametern och som överensstämmer med de angivna frågeparametrarna. Alla versioner av programtypen som matchar namnet på programtypen returneras, där varje version returneras som en programtyp. Svaret innehåller namn, version, status och annan information om programtypen. Det här är en växlingsfråga, vilket innebär att om inte alla programtyper får plats på en sida returneras en resultatsida samt en fortsättningstoken som kan användas för att hämta nästa sida. Om det till exempel finns 10 programtyper men en sida endast passar de tre första programtyperna, eller om maximalt resultat är inställt på 3, returneras tre. Om du vill komma åt resten av resultaten hämtar du efterföljande sidor med hjälp av den returnerade fortsättningstoken i nästa fråga. En tom fortsättningstoken returneras om det inte finns några efterföljande sidor.

Argument

Argument beskrivning
--application-type-name [Krävs] Namnet på programtypen.
--application-type-version Versionen av programtypen.
--continuation-token Parametern fortsättningstoken används för att hämta nästa uppsättning resultat. En fortsättningstoken med ett värde som inte är tomt ingår i API:ets svar när resultatet från systemet inte får plats i ett enda svar. När det här värdet skickas till nästa API-anrop returnerar API:et nästa uppsättning resultat. Om det inte finns några ytterligare resultat innehåller fortsättningstoken inget värde. Värdet för den här parametern ska inte vara URL-kodat.
--exclude-application-parameters Flaggan som anger om programparametrar ska undantas från resultatet.
--max-results Det maximala antalet resultat som ska returneras som en del av de sidiga frågorna. Den här parametern definierar den övre gränsen för det antal resultat som returneras. Resultatet som returneras kan vara mindre än det angivna maximala resultatet om de inte får plats i meddelandet enligt de maximala begränsningarna för meddelandestorlek som definierats i konfigurationen. Om den här parametern är noll eller inte har angetts innehåller den sidvända frågan så många resultat som möjligt som får plats i returmeddelandet.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

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

sfctl-programtyplista

Hämtar listan över programtyper i Service Fabric-klustret.

Returnerar information om de programtyper som etableras eller håller på att etableras i Service Fabric-klustret. Varje version av en programtyp returneras som en programtyp. Svaret innehåller namn, version, status och annan information om programtypen. Det här är en växlingsfråga, vilket innebär att om inte alla programtyper får plats på en sida returneras en resultatsida samt en fortsättningstoken som kan användas för att hämta nästa sida. Om det till exempel finns 10 programtyper men en sida endast passar de tre första programtyperna, eller om maximalt resultat är inställt på 3, returneras tre. Om du vill komma åt resten av resultaten hämtar du efterföljande sidor med hjälp av den returnerade fortsättningstoken i nästa fråga. En tom fortsättningstoken returneras om det inte finns några efterföljande sidor.

Argument

Argument beskrivning
--application-type-definition-kind-filter Används för att filtrera på ApplicationTypeDefinitionKind som är den mekanism som används för att definiera en Service Fabric-programtyp.
– Standard – Standardvärde, som utför samma funktion som att välja "Alla". Värdet är 0.
– Alla – Filter som matchar indata med valfritt ApplicationTypeDefinitionKind-värde. Värdet är 65535.
– ServiceFabricApplicationPackage – filter som matchar indata med ApplicationTypeDefinitionKind-värdet ServiceFabricApplicationPackage. Värdet är 1.
– Skriv – Filter som matchar indata med ApplicationTypeDefinitionKind-värdet Compose. Värdet är 2.
--continuation-token Parametern fortsättningstoken används för att hämta nästa uppsättning resultat. En fortsättningstoken med ett värde som inte är tomt ingår i API:ets svar när resultatet från systemet inte får plats i ett enda svar. När det här värdet skickas till nästa API-anrop returnerar API:et nästa uppsättning resultat. Om det inte finns några ytterligare resultat innehåller fortsättningstoken inget värde. Värdet för den här parametern ska inte vara URL-kodat.
--exclude-application-parameters Flaggan som anger om programparametrar ska undantas från resultatet.
--max-results Det maximala antalet resultat som ska returneras som en del av de sidiga frågorna. Den här parametern definierar den övre gränsen för det antal resultat som returneras. Resultatet som returneras kan vara mindre än det angivna maximala resultatet om de inte får plats i meddelandet enligt de maximala begränsningarna för meddelandestorlek som definierats i konfigurationen. Om den här parametern är noll eller inte har angetts innehåller den sidvända frågan så många resultat som möjligt som får plats i returmeddelandet.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

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

avetablering av sfctl-program

Tar bort eller avregistrerar en Service Fabric-programtyp från klustret.

Den här åtgärden kan bara utföras om alla programinstanser av programtypen har tagits bort. När programtypen har avregistrerats kan inga nya programinstanser skapas för just den här programtypen.

Argument

Argument beskrivning
--application-type-name [Krävs] Namnet på programtypen.
--application-type-version [Krävs] Den version av programtypen som definierats i programmanifestet.
--async-parameter Flaggan som anger om avetablering ska ske asynkront. När värdet är true returneras avetableringsåtgärden när begäran godkänns av systemet och avetableringsåtgärden fortsätter utan någon tidsgräns. Standardvärdet är "false". Vi rekommenderar dock att du ställer in det på sant för stora programpaket som har etablerats.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

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

sfctl-programuppgradering

Börjar uppgradera ett program i Service Fabric-klustret.

Validerar de angivna programuppgraderingsparametrarna och börjar uppgradera programmet om parametrarna är giltiga. Observera att uppgraderingsbeskrivningen ersätter den befintliga programbeskrivningen. Det innebär att om parametrarna inte anges skrivs de befintliga parametrarna i programmen över med listan med tomma parametrar. Detta skulle resultera i att programmet använder standardvärdet för parametrarna från programmanifestet.

Argument

Argument beskrivning
--application-id [Krävs] Programmets identitet.

Detta är vanligtvis det fullständiga namnet på programmet utan URI-schemat "fabric:". Från och med version 6.0 avgränsas hierarkiska namn med tecknet "~". Om programnamnet till exempel är "fabric:/myapp/app1" skulle programidentiteten vara "myapp~app1" i 6.0+ och "myapp/app1" i tidigare versioner.
--application-version [Krävs] Målprogrammets typversion (finns i programmanifestet) för programuppgradering.
--parameters [Krävs] En JSON-kodad lista över åsidosättningar av programparametrar som ska tillämpas vid uppgradering av programmet.
--default-service-health-policy JSON-kodad specifikation för hälsoprincipen som används som standard för att utvärdera hälsotillståndet för en tjänsttyp.
--failure-action Åtgärden som ska utföras när en övervakad uppgradering påträffar överträdelser av övervakningsprinciper eller hälsoprinciper.
--force-restart Starta om processer under uppgraderingen, även om kodversionen inte har ändrats.
--health-check-retry-timeout Hur lång tid det tar mellan försök att utföra hälsokontroller om programmet eller klustret inte är felfritt. Standard: PT0H10M0S.
--health-check-stable-duration Hur lång tid programmet eller klustret måste vara felfria innan uppgraderingen fortsätter till nästa uppgraderingsdomän. Standard: PT0H2M0S.

Den tolkas först som en sträng som representerar en ISO 8601-varaktighet. Om det misslyckas tolkas det som ett tal som representerar det totala antalet millisekunder.
--health-check-wait-duration Hur lång tid det tar att vänta efter att ha slutfört en uppgraderingsdomän innan du påbörjar hälsokontrollprocessen. Standard: 0.
--max-unhealthy-apps Den maximala tillåtna procentandelen ej distribuerade program som inte är felfria. Representeras som ett tal mellan 0 och 100.
--läge Det läge som används för att övervaka hälsotillståndet under en löpande uppgradering. Standard: UnmonitoredAuto.
--replica-set-check-timeout Den maximala tiden för att blockera bearbetning av en uppgraderingsdomän och förhindra förlust av tillgänglighet när det uppstår oväntade problem. Mätt i sekunder.
--service-health-policy JSON-kodad karta med hälsoprincip för tjänsttyp per namn på tjänsttyp. Kartan är tom som standard.
--timeout -t Standard: 60.
--upgrade-domain-timeout Hur lång tid varje uppgraderingsdomän måste slutföras innan FailureAction körs. Standard: P10675199DT02H48M05.4775807S.

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

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

Globala argument

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

sfctl application upgrade-resume

Återupptar uppgraderingen av ett program i Service Fabric-klustret.

Återupptar en oövervakad manuell Service Fabric-programuppgradering. Service Fabric uppgraderar en uppgraderingsdomän i taget. När Service Fabric har slutfört en uppgraderingsdomän väntar det på att du ska anropa det här API:et innan du fortsätter till nästa uppgraderingsdomän för oövervakade manuella uppgraderingar.

Argument

Argument beskrivning
--application-id [Krävs] Programmets identitet. Detta är vanligtvis det fullständiga namnet på programmet utan URI-schemat "fabric:". Från och med version 6.0 avgränsas hierarkiska namn med tecknet "~". Om programnamnet till exempel är "fabric:/myapp/app1" skulle programidentiteten vara "myapp~app1" i 6.0+ och "myapp/app1" i tidigare versioner.
--upgrade-domain-name [Krävs] Namnet på uppgraderingsdomänen där uppgraderingen ska återupptas.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

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

sfctl application upgrade-rollback

Börjar återställa den pågående uppgraderingen av ett program i Service Fabric-klustret.

Börjar återställa den aktuella programuppgraderingen till den tidigare versionen. Det här API:et kan bara användas för att återställa den pågående uppgraderingen som rullar vidare till den nya versionen. Om programmet för närvarande inte uppgraderas använder du StartApplicationUpgrade API för att uppgradera det till önskad version, inklusive att återställa till en tidigare version.

Argument

Argument beskrivning
--application-id [Krävs] Programmets identitet. Detta är vanligtvis det fullständiga namnet på programmet utan URI-schemat "fabric:". Från och med version 6.0 avgränsas hierarkiska namn med tecknet "~". Om programnamnet till exempel är "fabric:/myapp/app1" skulle programidentiteten vara "myapp~app1" i 6.0+ och "myapp/app1" i tidigare versioner.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

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

uppgraderingsstatus för sfctl-program

Hämtar information om den senaste uppgraderingen som utförts i det här programmet.

Returnerar information om tillståndet för den senaste programuppgradering tillsammans med information som hjälper dig att felsöka problem med programhälsa.

Argument

Argument beskrivning
--application-id [Krävs] Programmets identitet. Detta är vanligtvis det fullständiga namnet på programmet utan URI-schemat "fabric:". Från och med version 6.0 avgränsas hierarkiska namn med tecknet "~". Om programnamnet till exempel är "fabric:/myapp/app1" skulle programidentiteten vara "myapp~app1" i 6.0+ och "myapp/app1" i tidigare versioner.
--timeout -t Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta tills den begärda åtgärden har slutförts. Standardvärdet för den här parametern är 60 sekunder. Standard: 60.

Globala argument

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

sfctl-programuppladdning

Kopiera ett Service Fabric-programpaket till avbildningsarkivet.

Du kan också visa uppladdningsstatus för varje fil i paketet. Uppladdningens förlopp skickas till stderr.

Argument

Argument beskrivning
--path [Krävs] Sökväg till det lokala programpaketet.
--komprimera Gäller endast för Service Fabric-programpaket. Skapa en ny mapp som innehåller det komprimerade programpaketet till antingen standardplatsen eller till den plats som anges av parametern compressed-location och ladda sedan upp den nyligen skapade mappen.

Om det redan finns en komprimerad fil som genereras av sfctl skrivs den över om den här flaggan anges. Ett fel returneras om katalogen inte är ett programpaket. Om det redan är ett komprimerat programpaket kopieras mappen som den är. Som standard tas det nyligen skapade komprimerade programpaketet bort efter en lyckad uppladdning. Om uppladdningen inte lyckas rensar du det komprimerade paketet manuellt efter behov. Borttagningen tar inte bort några tomma dirs som kan ha skapats om den komprimerade platsparametern refererar till icke-befintliga kataloger.
--compressed-location Platsen där det komprimerade programpaketet ska placeras.

Om ingen plats anges placeras det komprimerade paketet under en nyligen skapad mapp med namnet sfctl_compressed_temp under den överordnade katalogen som anges i sökvägsargumentet. Om sökvägsargumentet till exempel har värdet C:/FolderA/AppPkg läggs det komprimerade paketet till i C:/FolderA/sfctl_compressed_temp/AppPkg.
--imagestore-string Målbildarkiv som programpaketet ska laddas upp till. Standard: fabric:ImageStore.

Om du vill ladda upp till en filplats startar du den här parametern med "file:". Annars ska värdet vara avbildningsarkivet niska veze, till exempel standardvärdet.
--keep-compressed Om det genererade komprimerade paketet ska behållas när uppladdningen har slutförts eller inte.

Om den inte har angetts tas de komprimerade apppaketen bort när de har slutförts. Om uppladdningen inte lyckades sparas programpaketet alltid i utdatakatalogen för återuppladdning.
--show-progress Visa förloppet för filuppladdning för stora paket.
--timeout -t Den totala tidsgränsen i sekunder. Uppladdningen misslyckas och returnerar fel när tidsgränsen för uppladdningen har passerat. Den här tidsgränsen gäller för hela programpaketet, och enskilda tidsgränser för filer är lika med den återstående tidsgränsen. Tidsgränsen inkluderar inte den tid som krävs för att komprimera programpaketet. Standard: 300.

Globala argument

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

Nästa steg

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