Partager via

az sf managed-application

Gérer les applications s’exécutant sur un cluster managé Azure Service Fabric. Prend uniquement en charge les applications déployées par ARM.

Commandes

Nom Description Type État
az sf managed-application create

Créez une application managée sur un cluster managé Azure Service Fabric.

 Core GA
az sf managed-application delete

Supprimez une application managée.

 Core GA
az sf managed-application list

Répertorier les applications managées d’un cluster managé donné.

 Core GA
az sf managed-application show

Afficher les propriétés d’une application managée sur un cluster managé Azure Service Fabric.

 Core GA
az sf managed-application update

Mettez à jour une application managée Azure Service Fabric.

 Core GA

az sf managed-application create

Créez une application managée sur un cluster managé Azure Service Fabric.

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

Exemples

Créez une application managée « testApp » avec des paramètres. Le type d’application « TestAppType » version « v1 » doit déjà exister dans le cluster, et les paramètres de l’application doivent être définis dans le manifeste de l’application.

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

Créez l’application « testApp » et la version de type d’application à l’aide de l’URL du package fournie.

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

Paramètres obligatoires

--application-name --name

Spécifiez le nom de l’application.

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

Spécifiez le nom du type d’application.

--application-type-version --version

Spécifiez la version du type d’application.

--cluster-name -c

Spécifiez le nom du cluster, s’il n’est pas donné qu’il sera identique au nom du groupe de ressources.

--resource-group -g

Spécifiez le nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--application-parameters --parameters

Spécifiez les paramètres d’application en tant que paires clé/valeur. Ces paramètres doivent exister dans le manifeste de l’application. par exemple : --application-parameters param1=value1 param2=value2.

--package-url

Spécifiez l’URL du fichier sfpkg du package d’application.

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sf managed-application delete

Supprimez une application managée.

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

Exemples

Supprimez l’application managée.

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

Paramètres obligatoires

--application-name --name

Spécifiez le nom de l’application.

--cluster-name -c

Spécifiez le nom du cluster, s’il n’est pas donné qu’il sera identique au nom du groupe de ressources.

--resource-group -g

Spécifiez le nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sf managed-application list

Répertorier les applications managées d’un cluster managé donné.

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

Exemples

Répertorier les applications managées pour un cluster managé donné.

az sf managed-application list -g testRG -c testCluster

Paramètres obligatoires

--cluster-name -c

Spécifiez le nom du cluster, s’il n’est pas donné qu’il sera identique au nom du groupe de ressources.

--resource-group -g

Spécifiez le nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sf managed-application show

Afficher les propriétés d’une application managée sur un cluster managé Azure Service Fabric.

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

Exemples

Obtenir une application managée.

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

Paramètres obligatoires

--application-name --name

Spécifiez le nom de l’application.

--cluster-name -c

Spécifiez le nom du cluster, s’il n’est pas donné qu’il sera identique au nom du groupe de ressources.

--resource-group -g

Spécifiez le nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sf managed-application update

Changement cassant

La liste des options a changé, exécutez la commande d’aide pour afficher les options autorisées

Mettez à jour une application managée Azure Service Fabric.

Cela permet de mettre à jour les balises, les paramètres d’application, l’application UpgradePolicy et/ou la mise à niveau de la version de type d’application, ce qui déclenche une mise à niveau d’application.

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

Exemples

Mettez à jour les paramètres de l’application et mettez à niveau les valeurs de stratégie et la version de type d’application vers 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 --replica-check-timeout 300 --force-restart

Mettez à jour le mappage de stratégie d’intégrité de type de service d’application managée.

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"

Paramètres obligatoires

--application-name --name

Spécifiez le nom de l’application.

--cluster-name -c

Spécifiez le nom du cluster, s’il n’est pas donné qu’il sera identique au nom du groupe de ressources.

--resource-group -g

Spécifiez le nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--application-parameters --parameters

Spécifiez les paramètres d’application en tant que paires clé/valeur. Ces paramètres doivent exister dans le manifeste de l’application. par exemple : --application-parameters param1=value1 param2=value2.

--application-type-version --version

Spécifiez la version du type d’application.

--failure-action

Spécifiez l’action à entreprendre si la mise à niveau surveillée échoue. Les valeurs acceptables pour ce paramètre sont Rollback ou Manual.

Propriété Valeur
Groupe de paramètres: Upgrade description Arguments
Valeurs acceptées: Manual, Rollback
--force-restart

Indique que l’hôte de service redémarre même si la mise à niveau est une modification de configuration uniquement.

Propriété Valeur
Groupe de paramètres: Upgrade description Arguments
Valeur par défaut: False
Valeurs acceptées: false, true
--hc-retry-timeout --health-check-retry-timeout

Spécifiez la durée, en secondes, après laquelle Service Fabric réessaye la vérification d’intégrité si la vérification d’intégrité précédente échoue.

Propriété Valeur
Groupe de paramètres: Upgrade description Arguments
--hc-stable-duration --health-check-stable-duration

Spécifiez la durée, en secondes, que Service Fabric attend pour vérifier que l’application est stable avant de passer au domaine de mise à niveau suivant ou de terminer la mise à niveau. Cette durée d’attente empêche les modifications non détectées de l’intégrité juste après l’exécution du contrôle d’intégrité.

Propriété Valeur
Groupe de paramètres: Upgrade description Arguments
--hc-wait-duration --health-check-wait-duration

Spécifiez la durée, en secondes, que Service Fabric attend avant d’effectuer le contrôle d’intégrité initial une fois la mise à niveau terminée sur le domaine de mise à niveau.

Propriété Valeur
Groupe de paramètres: Upgrade description Arguments
--instance-close-delay-duration

Spécifiez la durée en secondes, à attendre avant la fermeture d’une instance sans état, pour permettre aux requêtes actives de vider correctement. Cela serait effectif lorsque l’instance se ferme pendant la mise à niveau de l’application/du cluster, uniquement pour les instances qui ont une durée de retard non nulle configurée dans la description du service.

Propriété Valeur
Groupe de paramètres: Upgrade description Arguments
--max-unhealthy-apps

Spécifiez le pourcentage maximal d’instances d’application déployées sur les nœuds du cluster qui ont un état d’intégrité d’erreur avant l’état d’intégrité de l’application pour le cluster. Les valeurs autorisées sont comprises entre 0 et 100.

Propriété Valeur
Groupe de paramètres: Upgrade description Arguments
--max-unhealthy-parts

Spécifiez le pourcentage maximal de partitions non saines par service autorisé par la stratégie d’intégrité pour le type de service par défaut à utiliser pour la mise à niveau surveillée. Les valeurs autorisées sont comprises entre 0 et 100.

Propriété Valeur
Groupe de paramètres: Upgrade description Arguments
--max-unhealthy-reps

Spécifiez le pourcentage maximal de réplicas non sains par service autorisé par la stratégie d’intégrité pour le type de service par défaut à utiliser pour la mise à niveau surveillée. Les valeurs autorisées sont comprises entre 0 et 100.

Propriété Valeur
Groupe de paramètres: Upgrade description Arguments
--max-unhealthy-servs

Spécifiez le pourcentage maximal de services non sains autorisés par la stratégie d’intégrité pour le type de service par défaut à utiliser pour la mise à niveau surveillée. Les valeurs autorisées sont comprises entre 0 et 100.

Propriété Valeur
Groupe de paramètres: Upgrade description Arguments
--recreate-application

Détermine si l’application doit être recréée lors de la mise à jour. Si value=true, le reste des paramètres de stratégie de mise à niveau ne sont pas autorisés.

Propriété Valeur
Groupe de paramètres: Upgrade description Arguments
Valeur par défaut: False
Valeurs acceptées: false, true
--rep-check-timeout --replica-check-timeout

Spécifiez la durée maximale, en secondes, que Service Fabric attend qu’un service reconfigure dans un état sûr, s’il n’est pas déjà dans un état sûr, avant que Service Fabric continue la mise à niveau.

Propriété Valeur
Groupe de paramètres: Upgrade description Arguments
--service-type-health-policy-map

Spécifiez la carte de la stratégie d’intégrité à utiliser pour différents types de service en tant que paires clé/valeur au format suivant : « ServiceTypeName »="MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices ». par exemple : --service-type-health-policy-map « ServiceTypeName01"="5,10,5 » « ServiceTypeName02"="5,5,5 ».

Propriété Valeur
Groupe de paramètres: Upgrade description Arguments
--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

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

Spécifiez la durée maximale, en secondes, que Service Fabric prend pour mettre à niveau un domaine de mise à niveau unique. Après cette période, la mise à niveau échoue.

Propriété Valeur
Groupe de paramètres: Upgrade description Arguments
--upgrade-mode

Spécifiez le mode utilisé pour surveiller l’intégrité pendant une mise à niveau propagée. Les valeurs sont Monitor et UnmonitoredAuto.

Propriété Valeur
Groupe de paramètres: Upgrade description Arguments
Valeurs acceptées: Monitored, UnmonitoredAuto
--upgrade-timeout

Spécifiez la durée maximale, en secondes, que Service Fabric prend pour toute la mise à niveau. Après cette période, la mise à niveau échoue.

Propriété Valeur
Groupe de paramètres: Upgrade description Arguments
--warning-as-error

Indique s’il faut traiter un événement d’intégrité d’avertissement comme un événement d’erreur pendant l’évaluation de l’intégrité.

Propriété Valeur
Groupe de paramètres: Upgrade description Arguments
Valeur par défaut: False
Valeurs acceptées: false, true
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False