Feedback

az sf managed-application

  • Referenz

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

Befehle

az sf managed-application create

Erstellen Sie eine neue verwaltete Anwendung in einem verwalteten Azure Service Fabric-Cluster.
az sf managed-application delete

Löschen einer verwalteten Anwendung.
az sf managed-application list

Listet verwaltete Anwendungen eines bestimmten verwalteten Clusters auf.
az sf managed-application show

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

Aktualisieren einer verwalteten Azure Service Fabric-Anwendung.

az sf managed-application create

Erstellen Sie eine neue verwaltete Anwendung in einem verwalteten Azure Service Fabric-Cluster.

az sf managed-application create --application-name
                                 --application-type-name
                                 --application-type-version
                                 --cluster-name
                                 --resource-group
                                 [--application-parameters]
                                 [--package-url]
                                 [--tags]

Beispiele

Erstellen Sie verwaltete 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 managed-application create -g testRG -c testCluster --application-name testApp --application-type-name TestAppType \
  --application-type-version v1 --application-parameters key0=value0 --tags key1=value1

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

az sf managed-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.

--package-url

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

--tags

Leerzeichentrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

az sf managed-application delete

Löschen einer verwalteten Anwendung.

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

Beispiele

Gelöschte Anwendung.

az sf managed-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 managed-application list

Listet verwaltete Anwendungen eines bestimmten verwalteten Clusters auf.

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

Beispiele

Listet verwaltete Anwendungen für einen bestimmten verwalteten Cluster auf.

az sf managed-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 managed-application show

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

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

Beispiele

Abrufen der verwalteten Anwendung.

az sf managed-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 managed-application update

Aktualisieren einer verwalteten Azure Service Fabric-Anwendung.

Auf diese Weise können Die Tags, die Anwendungsparameter, der Wert ist die Anwendung UpgradePolicy und/oder das Upgrade der Anwendungstypversion, die ein Anwendungsupgrade auslöst.

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

Beispiele

Aktualisieren von Anwendungsparametern und Upgreade-Richtlinienwerten und App-Typversion auf v2.

az sf managed-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 der Richtlinienzuordnung für verwalteten Anwendungsdiensttyp.

az sf managed-application update -g testRG -c testCluster --application-name testApp --service-type-health-policy-map  "ServiceTypeName01"="5,10,5" "ServiceTypeName02"="5,5,5"

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.

--close-duration --instance-close-delay-duration --instance-close-duration

Geben Sie die Dauer in Sekunden an, um zu warten, bevor eine zustandslose Instanz geschlossen wird, damit die aktiven Anforderungen ordnungsgemäß abgelassen werden können. Dies wäre wirksam, wenn die Instanz während des Anwendungs-/Clusterupgrades geschlossen wird, nur für diese Instanzen, die eine in der Dienstbeschreibung konfigurierte Nicht-Null-Verzögerungsdauer aufweisen.

--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-percent-unhealthy-apps --max-percent-unhealthy-deployed-applications --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-percent-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 liegen zwischen 0 und 100.

--max-percent-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 liegen zwischen 0 und 100.

--max-percent-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 liegen zwischen 0 und 100.

--recreate-application

Bestimmt, ob die Anwendung auf dem Update neu erstellt werden soll. Wenn wert=true, sind die restlichen Upgraderichtlinienparameter nicht zulässig.

Zulässige Werte: false, true
--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 unterschiedliche Diensttypen als Schlüssel-Wert-Paare im folgenden Format verwendet werden soll: "ServiceTypeName"="MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices". Beispiel: --service-type-health-policy-map "ServiceTypeName01"="5,10,5" "ServiceTypeName02"="5,5;5".

--tags

Leerzeichentrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--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-mode

Geben Sie den Modus an, der zum Überwachen der Integrität während eines Rollupgrades verwendet wird. Die Werte sind überwacht und nicht überwachtAuto.

Zulässige Werte: Monitored, UnmonitoredAuto
--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.