Partager via

az sf service

  • Référence

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

Commandes

Nom Description Type État
az sf service create

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

 Core GA
az sf service delete

Supprimez un service.

 Core GA
az sf service list

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

 Core GA
az sf service show

Obtenez un service.

 Core GA

az sf service create

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

az sf service create --application
                     --cluster-name
                     --name
                     --resource-group
                     --service-type
                     --state {stateful, stateless}
                     [--default-move-cost {High, Low, Medium, Zero}]
                     [--instance-count]
                     [--min-replica]
                     [--partition-scheme {named, singleton, uniformInt64}]
                     [--target-replica]

Exemples

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

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

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

az sf service create -g testRG -c testCluster --application-name testApp --state stateful --service-name testApp~testService2 \
  --service-type testStatefulType --min-replica-set-size 3 --target-replica-set-size 5

Paramètres obligatoires

--application --application-name

Spécifiez le nom du service. Le nom de l’application doit être un préfixe du nom de service, par exemple : appName~serviceName.

--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. Le nom de l’application doit être un préfixe du nom de service, par exemple : appName~serviceName.

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

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

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

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

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

--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, uniformInt64
Valeur par défaut: singleton
--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 service delete

Supprimez un service.

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

Exemples

Supprimer le service.

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

Paramètres obligatoires

--application-name

Nom de la ressource d’application. Obligatoire.

--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. Le nom de l’application doit être un préfixe du nom de service, par exemple : appName~serviceName.

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

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

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

Exemples

Répertorier les services.

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

Paramètres obligatoires

--application-name

Nom de la ressource d’application. Obligatoire.

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

Obtenez un service.

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

Exemples

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

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

Paramètres obligatoires

--application-name

Nom de la ressource d’application. Obligatoire.

--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. Le nom de l’application doit être un préfixe du nom de service, par exemple : appName~serviceName.

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