Freigeben über

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

Name Beschreibung Typ Status
az sf managed-application create

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

 Kern GA
az sf managed-application delete

Löschen sie eine verwaltete Anwendung.

 Kern GA
az sf managed-application list

Auflisten verwalteter Anwendungen eines bestimmten verwalteten Clusters.

 Kern GA
az sf managed-application show

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

 Kern GA
az sf managed-application update

Aktualisieren sie eine verwaltete Azure Service Fabric-Anwendung.

 Kern GA

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

--package-url

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

--tags

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

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 managed-application delete

Löschen sie eine verwaltete Anwendung.

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

Beispiele

Verwaltete Anwendung löschen.

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

Auflisten verwalteter Anwendungen eines bestimmten verwalteten Clusters.

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

Beispiele

Auflisten verwalteter Anwendungen für einen bestimmten verwalteten Cluster.

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

Zeigt 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

Verwaltete Anwendung abrufen.

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

Aktualisieren sie eine verwaltete Azure Service Fabric-Anwendung.

Dies ermöglicht das Aktualisieren der Tags, der Anwendungsparameter, des Werts der 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 Integritätsrichtlinienzuordnung des verwalteten Anwendungsdiensttyps.

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

--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 instanzen, für die in der Dienstbeschreibung eine Verzögerungsdauer ohne Null konfiguriert ist.

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

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

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

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

--recreate-application

Bestimmt, ob die Anwendung beim Update neu erstellt werden soll. If value=true, the rest of the upgrade policy parameters are not allowed.

Zulässige Werte: false, true
Standardwert: False
--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 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

Durch Leerzeichen getrennte 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 rollierenden Upgrades verwendet wird. Die Werte werden überwacht, und "UnmonitoredAuto".

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.

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.