Dela via

az sf application

  • Referens

Hantera program som körs på ett Azure Service Fabric-kluster. Stöder endast ARM-distribuerade program.

Kommandon

Name Description Typ Status
az sf application certificate

Hantera certifikatet för ett program.

 Kärna Allmän tillgänglighet
az sf application certificate add

Lägg till ett nytt certifikat i vm-skalningsuppsättningar som utgör klustret som ska användas av värdbaserade program.

 Kärna Allmän tillgänglighet
az sf application create

Skapa ett nytt program i ett Azure Service Fabric-kluster.

 Kärna Allmän tillgänglighet
az sf application delete

Ta bort ett program.

 Kärna Allmän tillgänglighet
az sf application list

Visa en lista över program för ett visst kluster.

 Kärna Allmän tillgänglighet
az sf application show

Visa egenskaperna för ett program i ett Azure Service Fabric-kluster.

 Kärna Allmän tillgänglighet
az sf application update

Uppdatera ett Azure Service Fabric-program. På så sätt kan du uppdatera programparametrarna och/eller uppgradera den version av programtypen som utlöser en programuppgradering.

 Kärna Allmän tillgänglighet

az sf application create

Skapa ett nytt program i ett Azure Service Fabric-kluster.

az sf application create --application-name
                         --application-type-name
                         --application-type-version
                         --cluster-name
                         --resource-group
                         [--application-parameters]
                         [--max-nodes]
                         [--min-nodes]
                         [--package-url]

Exempel

Skapa programmet "testApp" med parametrar. Programtypen "TestAppType" version "v1" bör redan finnas i klustret och programparametrarna ska definieras i programmanifestet.

az sf application create -g testRG -c testCluster --application-name testApp --application-type-name TestAppType \
  --application-type-version v1 --application-parameters key0=value0

Skapa programmet "testApp" och apptypsversion med hjälp av den tillhandahållna paket-URL:en.

az sf application create -g testRG -c testCluster --application-name testApp --application-type-name TestAppType \
  --application-type-version v1 --package-url "https://sftestapp.blob.core.windows.net/sftestapp/testApp_1.0.sfpkg" \
    --application-parameters key0=value0

Obligatoriska parametrar

--application-name --name

Ange programnamnet.

--application-type-name --type-name

Ange namnet på programtypen.

--application-type-version --version

Ange programtypsversionen.

--cluster-name -c

Ange namnet på klustret, om det inte anges kommer det att vara samma som resursgruppens namn.

--resource-group -g

Ange resursgruppens namn. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--application-parameters --parameters

Ange programparametrarna som nyckel/värde-par. Dessa parametrar måste finnas i programmanifestet. till exempel: --application-parameters param1=value1 param2=value2.

--max-nodes --maximum-nodes

Ange det maximala antalet noder som ett program ska placeras på. Värdet för den här parametern måste vara ett heltal som inte är negativt. Standardvärdet är 0, vilket anger att programmet kan placeras på valfritt antal noder i klustret.

--min-nodes --minimum-nodes

Ange det minsta antalet noder där Service Fabric reserverar kapacitet för det här programmet. Det innebär inte att programmet garanteras ha repliker på alla dessa noder. Värdet för den här parametern måste vara ett heltal som inte är negativt. Standardvärdet för detta är noll, vilket innebär att ingen kapacitet är reserverad för programmet.

--package-url

Ange url:en för programpaketets sfpkg-fil.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az sf application delete

Ta bort ett program.

az sf application delete --application-name
                         --cluster-name
                         --resource-group

Exempel

Ta bort programmet.

az sf application delete -g testRG -c testCluster --application-name testApp

Obligatoriska parametrar

--application-name --name

Ange programnamnet.

--cluster-name -c

Ange namnet på klustret, om det inte anges kommer det att vara samma som resursgruppens namn.

--resource-group -g

Ange resursgruppens namn. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az sf application list

Visa en lista över program för ett visst kluster.

az sf application list --cluster-name
                       --resource-group

Exempel

Lista program för ett visst kluster.

az sf application list -g testRG -c testCluster

Obligatoriska parametrar

--cluster-name -c

Ange namnet på klustret, om det inte anges kommer det att vara samma som resursgruppens namn.

--resource-group -g

Ange resursgruppens namn. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az sf application show

Visa egenskaperna för ett program i ett Azure Service Fabric-kluster.

az sf application show --application-name
                       --cluster-name
                       --resource-group

Exempel

Hämta program.

az sf application show -g testRG -c testCluster --application-name testApp

Obligatoriska parametrar

--application-name --name

Ange programnamnet.

--cluster-name -c

Ange namnet på klustret, om det inte anges kommer det att vara samma som resursgruppens namn.

--resource-group -g

Ange resursgruppens namn. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az sf application update

Uppdatera ett Azure Service Fabric-program. På så sätt kan du uppdatera programparametrarna och/eller uppgradera den version av programtypen som utlöser en programuppgradering.

az sf application update --application-name
                         --cluster-name
                         --resource-group
                         [--application-parameters]
                         [--application-type-version]
                         [--consider-warning-as-error {false, true}]
                         [--failure-action {Manual, Rollback}]
                         [--force-restart {false, true}]
                         [--hc-retry-timeout]
                         [--hc-stable-duration]
                         [--hc-wait-duration]
                         [--max-nodes]
                         [--max-porcent-unhealthy-apps]
                         [--max-porcent-unhealthy-partitions]
                         [--max-porcent-unhealthy-replicas]
                         [--max-porcent-unhealthy-services]
                         [--min-nodes]
                         [--rep-check-timeout]
                         [--service-type-health-policy-map]
                         [--ud-timeout]
                         [--upgrade-timeout]

Exempel

Uppdatera programparametrar och uppgradera principvärden och apptypsversion till v2.

az sf application update -g testRG -c testCluster --application-name testApp --application-type-version v2 \
  --application-parameters key0=value0 --health-check-stable-duration 0 --health-check-wait-duration 0 --health-check-retry-timeout 0 \
    --upgrade-domain-timeout 5000 --upgrade-timeout 7000 --failure-action Rollback --upgrade-replica-set-check-timeout 300 --force-restart

Uppdatera programminimum och högsta noder.

az sf application update -g testRG -c testCluster --application-name testApp --minimum-nodes 1 --maximum-nodes 3

Obligatoriska parametrar

--application-name --name

Ange programnamnet.

--cluster-name -c

Ange namnet på klustret, om det inte anges kommer det att vara samma som resursgruppens namn.

--resource-group -g

Ange resursgruppens namn. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--application-parameters --parameters

Ange programparametrarna som nyckel/värde-par. Dessa parametrar måste finnas i programmanifestet. till exempel: --application-parameters param1=value1 param2=value2.

--application-type-version --version

Ange programtypsversionen.

--consider-warning-as-error --warning-as-error

Anger om en varningshälsohändelse ska behandlas som en felhändelse under hälsoutvärderingen.

Godkända värden: false, true
Standardvärde: False
--failure-action

Ange vilken åtgärd som ska vidtas om den övervakade uppgraderingen misslyckas. De acceptabla värdena för den här parametern är Återställning eller Manuell.

Godkända värden: Manual, Rollback
--force-restart

Anger att tjänstvärden startas om även om uppgraderingen är en konfigurationsändring.

Godkända värden: false, true
Standardvärde: False
--hc-retry-timeout --health-check-retry-timeout

Ange varaktigheten i sekunder, varefter Service Fabric försöker utföra hälsokontrollen igen om den föregående hälsokontrollen misslyckas.

--hc-stable-duration --health-check-stable-duration

Ange varaktigheten i sekunder som Service Fabric väntar för att kontrollera att programmet är stabilt innan du flyttar till nästa uppgraderingsdomän eller slutför uppgraderingen. Den här väntetiden förhindrar oupptäckta hälsoändringar direkt efter att hälsokontrollen har utförts.

--hc-wait-duration --health-check-wait-duration

Ange varaktigheten, i sekunder, som Service Fabric väntar innan den utför den första hälsokontrollen när uppgraderingen av uppgraderingsdomänen har slutförts.

--max-nodes --maximum-nodes

Ange det maximala antalet noder som ett program ska placeras på. Värdet för den här parametern måste vara ett heltal som inte är negativt. Standardvärdet är 0, vilket anger att programmet kan placeras på valfritt antal noder i klustret.

--max-porcent-unhealthy-apps --max-unhealthy-apps

Ange den maximala procentandelen av de programinstanser som distribueras på noderna i klustret som har ett feltillstånd innan programmets hälsotillstånd för klustret är fel. Tillåtna värden är formulär 0 till 100.

--max-porcent-unhealthy-partitions --max-unhealthy-parts

Ange den maximala procentandelen icke-hjälppartitioner per tjänst som tillåts av hälsoprincipen för den standardtjänsttyp som ska användas för den övervakade uppgraderingen. Tillåtna värden är formulär 0 till 100.

--max-porcent-unhealthy-replicas --max-unhealthy-reps

Ange den maximala procentandelen repliker per tjänst som tillåts av hälsoprincipen för den standardtjänsttyp som ska användas för den övervakade uppgraderingen. Tillåtna värden är formulär 0 till 100.

--max-porcent-unhealthy-services --max-unhealthy-servs

Ange den maximala procentandelen ohjälpstjänster som tillåts av hälsoprincipen för den standardtjänsttyp som ska användas för den övervakade uppgraderingen. Tillåtna värden är formulär 0 till 100.

--min-nodes --minimum-nodes

Ange det minsta antalet noder där Service Fabric reserverar kapacitet för det här programmet. Det innebär inte att programmet garanteras ha repliker på alla dessa noder. Värdet för den här parametern måste vara ett heltal som inte är negativt. Standardvärdet för detta är noll, vilket innebär att ingen kapacitet är reserverad för programmet.

--rep-check-timeout --replica-check-timeout --upgrade-replica-set-check-timeout

Ange den maximala tiden i sekunder som Service Fabric väntar på att en tjänst ska konfigureras om till ett säkert tillstånd, om inte redan i säkert tillstånd, innan Service Fabric fortsätter med uppgraderingen.

--service-type-health-policy-map --service-type-policy

Ange kartan över hälsoprincipen som ska användas för olika tjänsttyper som en hash-tabell i följande format: {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Till exempel: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }.

--ud-timeout --upgrade-domain-timeout

Ange den maximala tid i sekunder som Service Fabric tar att uppgradera en enda uppgraderingsdomän. Efter den här perioden misslyckas uppgraderingen.

--upgrade-timeout

Ange den maximala tid i sekunder som Service Fabric tar för hela uppgraderingen. Efter den här perioden misslyckas uppgraderingen.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.