Feedback

az sf application

  • Referenz

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

Befehle

az sf application certificate

Verwalten des Zertifikats einer Anwendung.
az sf application certificate add

Fügen Sie dem Virtual Machine Scale Sets ein neues Zertifikat hinzu, das den Cluster darstellt, der von gehosteten Anwendungen verwendet werden soll.
az sf application create

Erstellen Sie eine neue Anwendung auf einem Azure Service Fabric-Cluster.
az sf application delete

Löschen einer Anwendung.
az sf application list

Listet Anwendungen eines bestimmten Clusters auf.
az sf application show

Zeigen Sie die Eigenschaften einer Anwendung in einem Azure Service Fabric-Cluster an.
az sf application update

Aktualisieren einer Azure Service Fabric-Anwendung. Dadurch können die Anwendungsparameter aktualisiert und/oder die Anwendungstypversion aktualisiert werden, die ein Anwendungsupgrade auslöst.

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 Namen des Anwendungstyps an.

--application-type-version --version

Geben Sie die Anwendungstypversion an.

--cluster-name -c

Geben Sie den Namen des Clusters an, wenn sie nicht angegeben wird, gleich dem Ressourcengruppennamen.

--resource-group -g

Geben Sie den Namen der Ressourcengruppe 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-/Wertpaare an. Diese Parameter müssen im Anwendungsmanifest vorhanden sein. Beispiel: --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 kapazität für diese Anwendung reserviert, bedeutet dies nicht, 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 dies 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.

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 sie nicht angegeben wird, gleich dem Ressourcengruppennamen.

--resource-group -g

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

az sf application list

Listet Anwendungen eines bestimmten Clusters auf.

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 sie nicht angegeben wird, gleich dem Ressourcengruppennamen.

--resource-group -g

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

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 sie nicht angegeben wird, gleich dem Ressourcengruppennamen.

--resource-group -g

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

az sf application update

Aktualisieren einer Azure Service Fabric-Anwendung. Dadurch können die Anwendungsparameter aktualisiert und/oder die Anwendungstypversion aktualisiert werden, die ein Anwendungsupgrade auslöst.

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 von Anwendungsparametern und Upgraderichtlinienwerten 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 Höchstknoten 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 sie nicht angegeben wird, gleich dem Ressourcengruppennamen.

--resource-group -g

Geben Sie den Namen der Ressourcengruppe 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-/Wertpaare an. Diese Parameter müssen im Anwendungsmanifest vorhanden sein. Beispiel: --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
--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 es sich bei dem Upgrade um eine konfigurationsgeschützte Änderung handelt.

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

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

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

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

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

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

--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 Fehlerstatus aufweisen, bevor der Anwendungsstatus für den Cluster fehler ist. Zulässige Werte sind form 0 bis 100.

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

Geben Sie den maximal zulässigen Prozentsatz der unhelfigen 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 form 0 bis 100.

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

Geben Sie den maximal zulässigen Prozentsatz von unhelthy Replikaten 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 form 0 bis 100.

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

Geben Sie den maximalen Prozentsatz der unhelfigen Dienste 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 form 0 bis 100.

--min-nodes --minimum-nodes

Geben Sie die Mindestanzahl von Knoten an, bei denen Service Fabric kapazität für diese Anwendung reserviert, bedeutet dies nicht, 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 dies 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, für die Service Fabric wartet, bis ein Dienst in einen sicheren Zustand neu konfiguriert wird, wenn nicht bereits in einem sicheren Zustand, 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.