Teilen über

az sf application

  • Referenz

Verwalten von Anwendungen, die auf einem Azure Service Fabric-Cluster ausgeführt werden. Nur ARM-bereitgestellte Anwendungen unterstützen.

Befehle

Name Beschreibung Typ Status
az sf application certificate

Verwalten des Zertifikats einer Anwendung.

 Kern GA
az sf application certificate add

Fügen Sie ein neues Zertifikat zu den Skalierungssätzen für virtuelle Computer hinzu, aus denen der Cluster besteht, der von gehosteten Anwendungen verwendet werden soll.

 Kern GA
az sf application create

Erstellen Sie eine neue Anwendung auf einem Azure Service Fabric-Cluster.

 Kern GA
az sf application delete

Löschen Sie eine Anwendung.

 Kern GA
az sf application list

Auflisten von Anwendungen eines bestimmten Clusters.

 Kern GA
az sf application show

Zeigen Sie die Eigenschaften einer Anwendung in einem Azure Service Fabric-Cluster an.

 Kern GA
az sf application update

Aktualisieren sie eine Azure Service Fabric-Anwendung. Dadurch können die Anwendungsparameter aktualisiert und/oder die Anwendungstypversion aktualisiert werden, wodurch ein Anwendungsupgrade ausgelöst wird.

 Kern GA

az sf application create

Erstellen Sie eine neue Anwendung auf einem Azure Service Fabric-Cluster.

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

Beispiele

Erstellen Sie die Anwendung "testApp" mit Parametern. Der Anwendungstyp "TestAppType" Version "v1" sollte bereits im Cluster vorhanden sein, und die Anwendungsparameter sollten im Anwendungsmanifest definiert werden.

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

Erstellen Sie die Anwendungsversion "testApp" und die App-Typversion mithilfe der bereitgestellten Paket-URL.

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

Erforderliche Parameter

--application-name --name

Geben Sie den Anwendungsnamen an.

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

Geben Sie den Anwendungstypnamen an.

--application-type-version --version

Geben Sie die Anwendungstypversion an.

--cluster-name -c

Geben Sie den Namen des Clusters an, wenn er nicht angegeben wird, mit dem Namen der Ressourcengruppe identisch.

--resource-group -g

Geben Sie den Ressourcengruppennamen an. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Optionale Parameter

--application-parameters --parameters

Geben Sie die Anwendungsparameter als Schlüssel-Wert-Paare an. Diese Parameter müssen im Anwendungsmanifest vorhanden sein. Beispiel: --application-parameters param1=value1 param2=value2.for example: --application-parameters param1=value2.for example: --application-parameters param1=value1 param2=value2.

--max-nodes --maximum-nodes

Geben Sie die maximale Anzahl von Knoten an, auf denen eine Anwendung platziert werden soll. Der Wert dieses Parameters muss eine nicht negative ganze Zahl sein. Der Standardwert ist 0, der angibt, dass die Anwendung auf einer beliebigen Anzahl von Knoten im Cluster platziert werden kann.

--min-nodes --minimum-nodes

Geben Sie die Mindestanzahl von Knoten an, bei denen Service Fabric die Kapazität für diese Anwendung reserviert, was nicht bedeutet, dass die Anwendung garantiert Replikate auf allen diesen Knoten aufweist. Der Wert dieses Parameters muss eine nicht negative ganze Zahl sein. Der Standardwert für diesen Wert ist Null, was bedeutet, dass keine Kapazität für die Anwendung reserviert ist.

--package-url

Geben Sie die URL der Sfpkg-Datei des Anwendungspakets an.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az sf application delete

Löschen Sie eine Anwendung.

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

Beispiele

Löschen einer Anwendung.

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

Erforderliche Parameter

--application-name --name

Geben Sie den Anwendungsnamen an.

--cluster-name -c

Geben Sie den Namen des Clusters an, wenn er nicht angegeben wird, mit dem Namen der Ressourcengruppe identisch.

--resource-group -g

Geben Sie den Ressourcengruppennamen an. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az sf application list

Auflisten von Anwendungen eines bestimmten Clusters.

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

Beispiele

Auflisten von Anwendungen für einen bestimmten Cluster.

az sf application list -g testRG -c testCluster

Erforderliche Parameter

--cluster-name -c

Geben Sie den Namen des Clusters an, wenn er nicht angegeben wird, mit dem Namen der Ressourcengruppe identisch.

--resource-group -g

Geben Sie den Ressourcengruppennamen an. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az sf application show

Zeigen Sie die Eigenschaften einer Anwendung in einem Azure Service Fabric-Cluster an.

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

Beispiele

Anwendung abrufen.

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

Erforderliche Parameter

--application-name --name

Geben Sie den Anwendungsnamen an.

--cluster-name -c

Geben Sie den Namen des Clusters an, wenn er nicht angegeben wird, mit dem Namen der Ressourcengruppe identisch.

--resource-group -g

Geben Sie den Ressourcengruppennamen an. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az sf application update

Aktualisieren sie eine Azure Service Fabric-Anwendung. Dadurch können die Anwendungsparameter aktualisiert und/oder die Anwendungstypversion aktualisiert werden, wodurch ein Anwendungsupgrade ausgelöst wird.

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]

Beispiele

Aktualisieren Sie Anwendungsparameter und Upgraderichtlinienwerte und App-Typversion auf 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

Aktualisieren Sie die Mindest- und Maximalknoten der Anwendung.

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

Erforderliche Parameter

--application-name --name

Geben Sie den Anwendungsnamen an.

--cluster-name -c

Geben Sie den Namen des Clusters an, wenn er nicht angegeben wird, mit dem Namen der Ressourcengruppe identisch.

--resource-group -g

Geben Sie den Ressourcengruppennamen an. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Optionale Parameter

--application-parameters --parameters

Geben Sie die Anwendungsparameter als Schlüssel-Wert-Paare an. Diese Parameter müssen im Anwendungsmanifest vorhanden sein. Beispiel: --application-parameters param1=value1 param2=value2.for example: --application-parameters param1=value2.for example: --application-parameters param1=value1 param2=value2.

--application-type-version --version

Geben Sie die Anwendungstypversion an.

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

Gibt an, ob ein Warnungsstatusereignis während der Integritätsauswertung als Fehlerereignis behandelt werden soll.

Zulässige Werte: false, true
Standardwert: False
--failure-action

Geben Sie die auszuführende Aktion an, wenn das überwachte Upgrade fehlschlägt. Die zulässigen Werte für diesen Parameter sind Rollback oder Manual.

Zulässige Werte: Manual, Rollback
--force-restart

Gibt an, dass der Diensthost neu gestartet wird, auch wenn das Upgrade eine konfigurationsgeschützte Änderung ist.

Zulässige Werte: false, true
Standardwert: False
--hc-retry-timeout --health-check-retry-timeout

Geben Sie die Dauer in Sekunden an, nach der Service Fabric die Integritätsprüfung erneut überprüft, wenn die vorherige Integritätsprüfung fehlschlägt.

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

Geben Sie die Dauer in Sekunden an, die Service Fabric wartet, um sicherzustellen, dass die Anwendung stabil ist, bevor Sie zur nächsten Upgradedomäne wechseln oder das Upgrade abschließen. Diese Wartezeit verhindert nicht erkannte Integritätsänderungen direkt nach der Ausführung der Integritätsprüfung.

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

Geben Sie die Dauer in Sekunden an, die Service Fabric wartet, bevor die anfängliche Integritätsprüfung ausgeführt wird, nachdem das Upgrade für die Upgradedomäne abgeschlossen wurde.

--max-nodes --maximum-nodes

Geben Sie die maximale Anzahl von Knoten an, auf denen eine Anwendung platziert werden soll. Der Wert dieses Parameters muss eine nicht negative ganze Zahl sein. Der Standardwert ist 0, der angibt, dass die Anwendung auf einer beliebigen Anzahl von Knoten im Cluster platziert werden kann.

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

Geben Sie den maximalen Prozentsatz der Anwendungsinstanzen an, die auf den Knoten im Cluster bereitgestellt werden, die einen Integritätsstatus aufweisen, bevor der Anwendungsstatus für den Cluster ein Fehler ist. Zulässige Werte sind 0 bis 100.

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

Geben Sie den maximalen Prozentsatz der nicht bezogenen Partitionen pro Dienst an, die von der Integritätsrichtlinie für den Standarddiensttyp zulässig sind, der für das überwachte Upgrade verwendet werden soll. Zulässige Werte sind 0 bis 100.

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

Geben Sie den maximalen Prozentsatz der nicht bezogenen Replikate pro Dienst an, die von der Integritätsrichtlinie für den Standarddiensttyp zulässig sind, der für das überwachte Upgrade verwendet werden soll. Zulässige Werte sind 0 bis 100.

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

Geben Sie den maximalen Prozentsatz der Nichthelfdienste an, die von der Integritätsrichtlinie für den Standarddiensttyp zulässig sind, der für das überwachte Upgrade verwendet werden soll. Zulässige Werte sind 0 bis 100.

--min-nodes --minimum-nodes

Geben Sie die Mindestanzahl von Knoten an, bei denen Service Fabric die Kapazität für diese Anwendung reserviert, was nicht bedeutet, dass die Anwendung garantiert Replikate auf allen diesen Knoten aufweist. Der Wert dieses Parameters muss eine nicht negative ganze Zahl sein. Der Standardwert für diesen Wert ist Null, was bedeutet, dass keine Kapazität für die Anwendung reserviert ist.

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

Geben Sie die maximale Zeit in Sekunden an, die Service Fabric wartet, bis ein Dienst in einen sicheren Zustand umkonfiguriert wird, wenn es sich nicht bereits in einem sicheren Zustand befindet, bevor Service Fabric mit dem Upgrade fortfährt.

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

Geben Sie die Zuordnung der Integritätsrichtlinie an, die für verschiedene Diensttypen als Hashtabelle im folgenden Format verwendet werden soll: {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Beispiel: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }.

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

Geben Sie die maximale Zeit in Sekunden an, die Service Fabric benötigt, um eine einzelne Upgradedomäne zu aktualisieren. Nach diesem Zeitraum schlägt das Upgrade fehl.

--upgrade-timeout

Geben Sie die maximale Zeit in Sekunden an, die Service Fabric für das gesamte Upgrade benötigt. Nach diesem Zeitraum schlägt das Upgrade fehl.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.