az sf application

  • Référence

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

Commandes

Nom Description Type Statut
az sf application certificate

Gérer le certificat d’une application.

 Core GA
az sf application certificate add

Ajoutez un nouveau certificat aux groupes de machines virtuelles identiques qui composent le cluster à utiliser par les applications hébergées.

 Core GA
az sf application create

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

 Core GA
az sf application delete

Supprimez une application.

 Core GA
az sf application list

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

 Core GA
az sf application show

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

 Core GA
az sf application update

Mettez à jour une application Azure Service Fabric. Cela permet de mettre à jour les paramètres de l’application et/ou de mettre à niveau la version du type d’application qui déclenchera une mise à niveau d’application.

 Core GA

az sf application create

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

az sf application create --application-name
                         --application-type-name
                         --application-type-version
                         --cluster-name
                         --resource-group
                         [--application-parameters]
                         [--max-nodes]
                         [--min-nodes]
                         [--package-url]

Exemples

Créez l’application « 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 application create -g testRG -c testCluster --application-name testApp --application-type-name TestAppType \
  --application-type-version v1 --application-parameters key0=value0

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

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

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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

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

--max-nodes --maximum-nodes

Spécifiez le nombre maximal de nœuds sur lesquels placer une application. La valeur de ce paramètre doit être un entier non négatif. La valeur par défaut est 0, ce qui indique que l’application peut être placée sur n’importe quel nombre de nœuds du cluster.

--min-nodes --minimum-nodes

Spécifiez le nombre minimal de nœuds où Service Fabric réserve la capacité pour cette application, cela ne signifie pas que l’application est garantie d’avoir des réplicas sur tous ces nœuds. La valeur de ce paramètre doit être un entier non négatif. La valeur par défaut est zéro, ce qui signifie qu’aucune capacité n’est réservée à l’application.

--package-url

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

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az sf application delete

Supprimez une application.

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

Exemples

Supprimez une application.

az sf 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 en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az sf application list

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

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

Exemples

Répertorier les applications pour un cluster donné.

az sf 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 en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az sf application show

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

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

Exemples

Obtenir l’application.

az sf 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 en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az sf application update

Mettez à jour une application Azure Service Fabric. Cela permet de mettre à jour les paramètres de l’application et/ou de mettre à niveau la version du type d’application qui déclenchera une mise à niveau d’application.

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]

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

Mettez à jour les nœuds minimum et maximal de l’application.

az sf application update -g testRG -c testCluster --application-name testApp --minimum-nodes 1 --maximum-nodes 3

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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

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

--consider-warning-as-error --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é.

valeurs acceptées: false, true
valeur par défaut: False
--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.

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.

valeurs acceptées: false, true
valeur par défaut: False
--hc-retry-timeout --health-check-retry-timeout

Spécifiez la durée, en secondes, après laquelle Service Fabric retente l’intégrité case activée si le case activée d’intégrité précédent échoue.

--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 case activée d’intégrité.

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

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

--max-nodes --maximum-nodes

Spécifiez le nombre maximal de nœuds sur lesquels placer une application. La valeur de ce paramètre doit être un entier non négatif. La valeur par défaut est 0, ce qui indique que l’application peut être placée sur n’importe quel nombre de nœuds du cluster.

--max-porcent-unhealthy-apps --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 au format 0 à 100.

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

Spécifiez le pourcentage maximal de partitions nonhelthy 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 au format 0 à 100.

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

Spécifiez le pourcentage maximal de réplicas nonhelthy 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 au format 0 à 100.

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

Spécifiez le pourcentage maximal de services nonhelthy 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 au format 0 à 100.

--min-nodes --minimum-nodes

Spécifiez le nombre minimal de nœuds où Service Fabric réserve la capacité pour cette application, cela ne signifie pas que l’application est garantie d’avoir des réplicas sur tous ces nœuds. La valeur de ce paramètre doit être un entier non négatif. La valeur par défaut est zéro, ce qui signifie qu’aucune capacité n’est réservée à l’application.

--rep-check-timeout --replica-check-timeout --upgrade-replica-set-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.

--service-type-health-policy-map --service-type-policy

Spécifiez la carte de la stratégie d’intégrité à utiliser pour différents types de service comme table de hachage au format suivant : {"ServiceTypeName » : « MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Par exemple : @{ « ServiceTypeName01 » = « 5,10,5 »; « ServiceTypeName02 » = « 5,5,5 » }.

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

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

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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