az sf managed-service

Gérer les services exécutés sur un cluster managé Azure Service Fabric. Prend uniquement en charge les services déployés par ARM.

Commandes

Nom	Description	Type	État
az sf managed-service correlation-scheme	Gérer les schémas de corrélation des services exécutés sur un cluster managé Azure Service Fabric. Prend uniquement en charge les services déployés par ARM.	Core	GA
az sf managed-service correlation-scheme create	Créez un schéma de corrélation de service managé sur un cluster managé Azure Service Fabric.	Core	GA
az sf managed-service correlation-scheme delete	Supprimez un schéma de corrélation de service managé.	Core	GA
az sf managed-service correlation-scheme update	Mettez à jour un schéma de corrélation de service managé.	Core	GA
az sf managed-service create	Créez un service managé sur un cluster managé Azure Service Fabric.	Core	GA
az sf managed-service delete	Supprimez un service managé.	Core	GA
az sf managed-service list	Répertorier les services managés d’une application managée donnée.	Core	GA
az sf managed-service load-metrics	Gérer les métriques de charge de service s’exécutant sur un cluster managé Azure Service Fabric. Prend uniquement en charge les services déployés par ARM.	Core	GA
az sf managed-service load-metrics create	Créez une métrique de chargement de service managée sur un cluster managé Azure Service Fabric.	Core	GA
az sf managed-service load-metrics delete	Supprimez un service managé.	Core	GA
az sf managed-service load-metrics update	Mettez à jour un service managé.	Core	GA
az sf managed-service show	Obtenez un service.	Core	GA
az sf managed-service update	Mettez à jour un service managé.	Core	GA

az sf managed-service create

Créez un service managé sur un cluster managé Azure Service Fabric.

az sf managed-service create --application
                             --cluster-name
                             --name
                             --resource-group
                             --service-type
                             --state {Stateful, Stateless}
                             [--activation-mode]
                             [--default-move-cost {High, Low, Medium, Zero}]
                             [--has-persisted-state {false, true}]
                             [--high-key]
                             [--instance-count]
                             [--keep-duration]
                             [--low-key]
                             [--min-inst-pct]
                             [--min-instance-count]
                             [--min-replica]
                             [--partition-count]
                             [--partition-names]
                             [--partition-scheme {Named, Singleton, UniformInt64Range}]
                             [--placement-constraints]
                             [--plcmt-time-limit]
                             [--quorum-loss-wait]
                             [--replica-restart-wait]
                             [--tags]
                             [--target-replica]

Exemples

Créez un service managé sans état « testService1 » avec le nombre d’instances -1 (sur tous les nœuds).

az sf managed-service create -g testRG -c testCluster --application-name testApp --state stateless --service-name testService \
  --service-type testStateless --instance-count -1 --partition-scheme singleton

Créez un service avec état « testService2 » avec une cible de 5 nœuds.

az sf managed-service create -g testRG -c testCluster --application-name testApp --state stateful --service-name testService2 --has-persisted-state \
  --service-type testStatefulType --min-replica-set-size 3 --target-replica-set-size 5 --partition-scheme uniformint64range --partition-count 1 --low-key 0 --high-key 25

Paramètres obligatoires

--application --application-name

Spécifiez le nom du service.

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

--name --service-name

Spécifiez le nom du service.

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

--service-type --type

Spécifiez le nom du type de service de l’application, il doit exister dans le manifeste de l’application.

--state

Spécifiez si le service est sans état ou avec état.

Valeurs acceptées: Stateful, Stateless

Paramètres facultatifs

--activation-mode --package-activation-mode --service-package-activation-mode

Spécifiez le mode d’activation du package de service.

--default-move-cost

Spécifiez le coût par défaut d’un déplacement. Les coûts plus élevés rendent moins probable que cluster Resource Manager déplace le réplica lors de la tentative d’équilibrage du cluster.

Valeurs acceptées: High, Low, Medium, Zero

--has-persisted-state

Détermine s’il s’agit d’un service persistant qui stocke les états sur le disque local. S’il s’agit alors de la valeur de cette propriété est true, si ce n’est pas faux.

Valeurs acceptées: false, true

--high-key

Spécifiez la limite supérieure de la plage de clés de partition qui doit être fractionnée entre la partition ' Count ' This is only used with UniformInt64 partition scheme.

--instance-count

Spécifiez le nombre d’instances pour le service sans état. Si -1 est utilisé, cela signifie qu’il s’exécute sur tous les nœuds.

--keep-duration --stand-by-keep-duration --stand-by-replica-keep-duration

Spécifiez la définition de la durée pendant laquelle les réplicas StandBy doivent être conservés avant d’être supprimés, représentés au format ISO 8601 « hh:mm:ss ».

--low-key

Spécifiez la limite inférieure de la plage de clés de partition qui doit être fractionnée entre la partition ' Count ' This is only used with UniformInt64 partition scheme.

--min-inst-pct --min-instance-percentage

Spécifiez le pourcentage minimal d’InstanceCount qui doit être à la hauteur de l’case activée de sécurité EnsureAvailability pendant les opérations telles que la mise à niveau ou la désactivation du nœud. Le nombre réel utilisé est max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Notez que si InstanceCount est défini sur -1, pendant le calcul MinInstancePercentage, -1 est d’abord converti en nombre de nœuds sur lesquels les instances sont autorisées à être placées en fonction des contraintes de placement sur le service. Les valeurs autorisées sont comprises entre 0 et 100.

--min-instance-count

Spécifiez le nombre minimal d’instances qui doivent être conformes aux case activée de sécurité EnsureAvailability pendant les opérations telles que la mise à niveau ou la désactivation du nœud. Le nombre réel utilisé est max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Notez que si InstanceCount est défini sur -1, pendant le calcul MinInstanceCount -1 est d’abord converti en nombre de nœuds sur lesquels les instances sont autorisées à être placées en fonction des contraintes de placement sur le service.

--min-replica --min-replica-set-size

Spécifiez la taille minimale du jeu de réplicas pour le service avec état.

--partition-count

Spécifiez le nombre de partitions. Cela est utilisé uniquement avec le schéma de partition UniformInt64.

--partition-names

Spécifiez le tableau pour les noms des partitions. Il s’agit uniquement d’un schéma de partition nommé.

--partition-scheme

Spécifiez le schéma de partition à utiliser. Les partitions singleton sont généralement utilisées lorsque le service ne requiert aucun routage supplémentaire. UniformInt64 signifie que chaque partition possède une plage de clés int64. Le nom est généralement destiné aux services avec des données qui peuvent être compartimentées, dans un ensemble délimité. Les régions, les codes postaux, les groupes de clients ou les autres limites de l’entreprise constituent des exemples courants de champs de données utilisés comme clés de partition nommées.

Valeurs acceptées: Named, Singleton, UniformInt64Range

Valeur par défaut: singleton

--placement-constraints

Spécifiez les contraintes de placement sous forme de chaîne. Les contraintes de placement sont des expressions booléennes sur les propriétés de nœud et permettent de restreindre un service à des nœuds particuliers en fonction des besoins du service. Par exemple, pour placer un service sur des nœuds où NodeType est bleu, spécifiez ce qui suit : « NodeColor == blue) ».

--plcmt-time-limit --service-placement-time-limit

Spécifiez la durée pendant laquelle les réplicas peuvent rester InBuild avant de signaler que la build est bloquée, représentée au format ISO 8601 « hh:mm:ss ».

--quorum-loss-wait --quorum-loss-wait-duration

Spécifiez la durée maximale pendant laquelle une partition est autorisée à être dans un état de perte de quorum, représentée au format ISO 8601 « hh:mm:ss ».

--replica-restart-wait --replica-restart-wait-duration

Spécifiez la durée entre le moment où un réplica tombe en panne et lorsqu’un nouveau réplica est créé, représenté au format ISO 8601 « hh:mm:ss ».

--tags

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

--target-replica --target-replica-set-size

Spécifiez la taille du jeu de réplicas cible pour le service avec état.

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

Supprimez un service managé.

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

Exemples

Supprimez le service managé.

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

Paramètres obligatoires

--application --application-name

Spécifiez le nom du service.

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

--name --service-name

Spécifiez le nom du service.

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

Répertorier les services managés d’une application managée donnée.

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

Exemples

Répertorier les services managés.

az sf managed-service list -g testRG -c testCluster --application-name testApp

Paramètres obligatoires

--application --application-name

Spécifiez le nom du service.

--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 managed-service show

Obtenez un service.

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

Exemples

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

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

Paramètres obligatoires

--application --application-name

Spécifiez le nom du service.

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

--name --service-name

Spécifiez le nom du service.

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

Mettez à jour un service managé.

az sf managed-service update --application
                             --cluster-name
                             --name
                             --resource-group
                             [--default-move-cost {High, Low, Medium, Zero}]
                             [--instance-count]
                             [--keep-duration]
                             [--min-inst-pct]
                             [--min-instance-count]
                             [--min-replica]
                             [--placement-constraints]
                             [--plcmt-time-limit]
                             [--quorum-loss-wait]
                             [--replica-restart-wait]
                             [--tags]
                             [--target-replica]

Exemples

Mettez à jour le service sans état managé.

az sf managed-service update -g testRG -c testCluster --application-name testApp --service-name testService --min-instance-count 2 \
  --min-instance-percentage 20

Mettez à jour le service avec état managé.

az sf managed-service update -g testRG -c testCluster --application-name testApp --service-name testService2 --service-placement-time-limit '00:11:00' \
  --stand-by-replica-keep-duration '00:11:00' --replica-restart-wait-duration '00:11:00' --quorum-loss-wait-duration '00:11:00'

Paramètres obligatoires

--application --application-name

Spécifiez le nom du service.

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

--name --service-name

Spécifiez le nom du service.

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

--default-move-cost

Spécifiez le coût par défaut d’un déplacement. Les coûts plus élevés rendent moins probable que cluster Resource Manager déplace le réplica lors de la tentative d’équilibrage du cluster.

Valeurs acceptées: High, Low, Medium, Zero

--instance-count

Spécifiez le nombre d’instances pour le service sans état. Si -1 est utilisé, cela signifie qu’il s’exécute sur tous les nœuds.

--keep-duration --stand-by-keep-duration --stand-by-replica-keep-duration

Spécifiez la définition de la durée pendant laquelle les réplicas StandBy doivent être conservés avant d’être supprimés, représentés au format ISO 8601 « hh:mm:ss ».

--min-inst-pct --min-instance-percentage

Spécifiez le pourcentage minimal d’InstanceCount qui doit être à la hauteur de l’case activée de sécurité EnsureAvailability pendant les opérations telles que la mise à niveau ou la désactivation du nœud. Le nombre réel utilisé est max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Notez que si InstanceCount est défini sur -1, pendant le calcul MinInstancePercentage, -1 est d’abord converti en nombre de nœuds sur lesquels les instances sont autorisées à être placées en fonction des contraintes de placement sur le service. Les valeurs autorisées sont comprises entre 0 et 100.

--min-instance-count

Spécifiez le nombre minimal d’instances qui doivent être conformes aux case activée de sécurité EnsureAvailability pendant les opérations telles que la mise à niveau ou la désactivation du nœud. Le nombre réel utilisé est max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Notez que si InstanceCount est défini sur -1, pendant le calcul MinInstanceCount -1 est d’abord converti en nombre de nœuds sur lesquels les instances sont autorisées à être placées en fonction des contraintes de placement sur le service.

--min-replica --min-replica-set-size

Spécifiez la taille minimale du jeu de réplicas pour le service avec état.

--placement-constraints

Spécifiez les contraintes de placement sous forme de chaîne. Les contraintes de placement sont des expressions booléennes sur les propriétés de nœud et permettent de restreindre un service à des nœuds particuliers en fonction des besoins du service. Par exemple, pour placer un service sur des nœuds où NodeType est bleu, spécifiez ce qui suit : « NodeColor == blue) ».

--plcmt-time-limit --service-placement-time-limit

Spécifiez la durée pendant laquelle les réplicas peuvent rester InBuild avant de signaler que la build est bloquée, représentée au format ISO 8601 « hh:mm:ss ».

--quorum-loss-wait --quorum-loss-wait-duration

Spécifiez la durée maximale pendant laquelle une partition est autorisée à être dans un état de perte de quorum, représentée au format ISO 8601 « hh:mm:ss ».

--replica-restart-wait --replica-restart-wait-duration

Spécifiez la durée entre le moment où un réplica tombe en panne et lorsqu’un nouveau réplica est créé, représenté au format ISO 8601 « hh:mm:ss ».

--tags

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

--target-replica --target-replica-set-size

Spécifiez la taille du jeu de réplicas cible pour le service avec état.

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.