Sdílet prostřednictvím

az sf application

  • Reference

Správa aplikací spuštěných v clusteru Azure Service Fabric Podporují pouze nasazené aplikace ARM.

Příkazy

Name Description Typ Stav
az sf application certificate

Správa certifikátu aplikace

 Základ GA
az sf application certificate add

Přidejte do škálovacích sad virtuálních počítačů nový certifikát, který tvoří cluster používaný hostovanými aplikacemi.

 Základ GA
az sf application create

Vytvořte novou aplikaci v clusteru Azure Service Fabric.

 Základ GA
az sf application delete

Odstraňte aplikaci.

 Základ GA
az sf application list

Zobrazí seznam aplikací daného clusteru.

 Základ GA
az sf application show

Zobrazí vlastnosti aplikace v clusteru Azure Service Fabric.

 Základ GA
az sf application update

Aktualizace aplikace Azure Service Fabric To umožňuje aktualizovat parametry aplikace nebo upgradovat verzi typu aplikace, která aktivuje upgrade aplikace.

 Základ GA

az sf application create

Vytvořte novou aplikaci v clusteru Azure Service Fabric.

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

Příklady

Vytvořte aplikaci testApp s parametry. Typ aplikace "TestAppType" verze "v1" by již měl existovat v clusteru a parametry aplikace by měly být definovány v manifestu aplikace.

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

Pomocí zadané adresy URL balíčku vytvořte aplikaci testApp a verzi typu aplikace.

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

Povinné parametry

--application-name --name

Zadejte název aplikace.

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

Zadejte název typu aplikace.

--application-type-version --version

Zadejte verzi typu aplikace.

--cluster-name -c

Zadejte název clusteru, pokud ho nezadáte, bude stejný jako název skupiny prostředků.

--resource-group -g

Zadejte název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

--application-parameters --parameters

Zadejte parametry aplikace jako páry klíč/hodnota. Tyto parametry musí existovat v manifestu aplikace. Například: --application-parameters param1=value1 param2=value2=value2.

--max-nodes --maximum-nodes

Zadejte maximální počet uzlů, na kterých se má aplikace umístit. Hodnota tohoto parametru musí být nezáporné celé číslo. Výchozí hodnota je 0, což označuje, že aplikaci lze umístit na libovolný počet uzlů v clusteru.

--min-nodes --minimum-nodes

Zadejte minimální počet uzlů, ve kterých bude Service Fabric pro tuto aplikaci rezervovat kapacitu, neznamená to, že je zaručeno, že aplikace bude mít repliky na všech těchto uzlech. Hodnota tohoto parametru musí být nezáporné celé číslo. Výchozí hodnota pro tuto hodnotu je nula, což znamená, že pro aplikaci není vyhrazena žádná kapacita.

--package-url

Zadejte adresu URL souboru balíčku aplikace sfpkg.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az sf application delete

Odstraňte aplikaci.

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

Příklady

Odstraňte aplikaci.

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

Povinné parametry

--application-name --name

Zadejte název aplikace.

--cluster-name -c

Zadejte název clusteru, pokud ho nezadáte, bude stejný jako název skupiny prostředků.

--resource-group -g

Zadejte název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az sf application list

Zobrazí seznam aplikací daného clusteru.

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

Příklady

Zobrazení seznamu aplikací pro daný cluster

az sf application list -g testRG -c testCluster

Povinné parametry

--cluster-name -c

Zadejte název clusteru, pokud ho nezadáte, bude stejný jako název skupiny prostředků.

--resource-group -g

Zadejte název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az sf application show

Zobrazí vlastnosti aplikace v clusteru Azure Service Fabric.

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

Příklady

Získejte aplikaci.

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

Povinné parametry

--application-name --name

Zadejte název aplikace.

--cluster-name -c

Zadejte název clusteru, pokud ho nezadáte, bude stejný jako název skupiny prostředků.

--resource-group -g

Zadejte název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az sf application update

Aktualizace aplikace Azure Service Fabric To umožňuje aktualizovat parametry aplikace nebo upgradovat verzi typu aplikace, která aktivuje upgrade aplikace.

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]

Příklady

Aktualizujte parametry aplikace a hodnoty zásad upgradu a verzi aplikace na verzi 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

Aktualizujte minimální a maximální počet uzlů aplikace.

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

Povinné parametry

--application-name --name

Zadejte název aplikace.

--cluster-name -c

Zadejte název clusteru, pokud ho nezadáte, bude stejný jako název skupiny prostředků.

--resource-group -g

Zadejte název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

--application-parameters --parameters

Zadejte parametry aplikace jako páry klíč/hodnota. Tyto parametry musí existovat v manifestu aplikace. Například: --application-parameters param1=value1 param2=value2=value2.

--application-type-version --version

Zadejte verzi typu aplikace.

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

Určuje, jestli se má událost stavu upozornění považovat za událost chyby během vyhodnocení stavu.

Přípustné hodnoty: false, true
Default value: False
--failure-action

Zadejte akci, která se má provést, pokud se monitorovaný upgrade nezdaří. Přijatelné hodnoty pro tento parametr jsou Vrácení zpět nebo Ruční.

Přípustné hodnoty: Manual, Rollback
--force-restart

Označuje, že hostitel služby se restartuje i v případě, že upgrade je změna pouze konfigurace.

Přípustné hodnoty: false, true
Default value: False
--hc-retry-timeout --health-check-retry-timeout

Zadejte dobu trvání v sekundách, po které Service Fabric opakuje kontrolu stavu, pokud předchozí kontrola stavu selže.

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

Zadejte dobu trvání v sekundách, po kterou Service Fabric čeká, aby se před přechodem na další doménu upgradu nebo dokončením upgradu ověřila, že je aplikace stabilní. Tato doba čekání zabraňuje nedetekovaným změnám stavu hned po provedení kontroly stavu.

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

Zadejte dobu trvání v sekundách, po které Service Fabric počká, než provede počáteční kontrolu stavu po dokončení upgradu v doméně upgradu.

--max-nodes --maximum-nodes

Zadejte maximální počet uzlů, na kterých se má aplikace umístit. Hodnota tohoto parametru musí být nezáporné celé číslo. Výchozí hodnota je 0, což označuje, že aplikaci lze umístit na libovolný počet uzlů v clusteru.

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

Zadejte maximální procento instancí aplikace nasazených na uzlech v clusteru, které mají stav chyby před chybou stavu aplikace pro cluster. Povolené hodnoty jsou ve formátu 0 až 100.

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

Zadejte maximální procento nehelthy oddílů na službu povolenou zásadami stavu pro výchozí typ služby, který se má použít pro monitorovaný upgrade. Povolené hodnoty jsou ve formátu 0 až 100.

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

Zadejte maximální procento nehelthy replik na službu povolenou zásadami stavu pro výchozí typ služby, který se má použít pro monitorovaný upgrade. Povolené hodnoty jsou ve formátu 0 až 100.

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

Zadejte maximální procento nehelthy služeb povolených zásadami stavu pro výchozí typ služby, které se mají použít pro monitorovaný upgrade. Povolené hodnoty jsou ve formátu 0 až 100.

--min-nodes --minimum-nodes

Zadejte minimální počet uzlů, ve kterých bude Service Fabric pro tuto aplikaci rezervovat kapacitu, neznamená to, že je zaručeno, že aplikace bude mít repliky na všech těchto uzlech. Hodnota tohoto parametru musí být nezáporné celé číslo. Výchozí hodnota pro tuto hodnotu je nula, což znamená, že pro aplikaci není vyhrazena žádná kapacita.

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

Zadejte maximální dobu v sekundách, po kterou Service Fabric čeká, až se služba překonfiguruje do bezpečného stavu, pokud ještě není v bezpečném stavu, a teprve potom Service Fabric provede upgrade.

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

Zadejte mapu zásad stavu, která se má použít pro různé typy služeb jako tabulku hash v následujícím formátu: {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Například: @{ "ServiceTypeName01" = "5,10;5"; "ServiceTypeName02" = "5,5;5" }.

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

Zadejte maximální dobu v sekundách, kterou Service Fabric trvá upgrade jedné domény upgradu. Po uplynutí této doby upgrade selže.

--upgrade-timeout

Zadejte maximální dobu v sekundách, kterou Service Fabric trvá pro celý upgrade. Po uplynutí této doby upgrade selže.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.