Freigeben über


az sf application

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.

Kernspeicher Allgemein verfügbar
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.

Kernspeicher Allgemein verfügbar
az sf application create

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

Kernspeicher Allgemein verfügbar
az sf application delete

Löschen einer Anwendung.

Kernspeicher Allgemein verfügbar
az sf application list

Auflisten von Anwendungen eines bestimmten Clusters.

Kernspeicher Allgemein verfügbar
az sf application show

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

Kernspeicher Allgemein verfügbar
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.

Kernspeicher Allgemein verfügbar

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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sf application delete

Löschen einer 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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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 zu überprüfen, ob die Anwendung stabil ist, bevor Sie zum nächsten Upgrade wechseln Standard 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 das Upgrade abgeschlossen wurde Standard.

--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 ein einzelnes Upgrade durchzuführen Standard. 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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.