Share via

az sf service

  • Referencia

Administrar servicios que se ejecutan en un clúster de Azure Service Fabric. Solo admite servicios implementados por ARM.

Comandos

Nombre Description Tipo Estado
az sf service create

Cree un nuevo servicio en un clúster de Azure Service Fabric.

 Principal GA
az sf service delete

Eliminar un servicio.

 Principal GA
az sf service list

Enumerar los servicios de una aplicación determinada.

 Principal GA
az sf service show

Obtener un servicio.

 Principal GA

az sf service create

Cree un nuevo servicio en un clúster de 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]

Ejemplos

Cree un nuevo servicio sin estado "testApp~testService1" con el recuento de instancias -1 (en todos los nodos).

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

Cree un nuevo servicio con estado "testApp~testService2" con un destino de 5 nodos.

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

Parámetros requeridos

--application --application-name

Especifique el nombre del servicio. El nombre de la aplicación debe ser un prefijo del nombre del servicio, por ejemplo: appName~serviceName.

--cluster-name -c

Especifique el nombre del clúster, si no se le asigna, será el mismo que el nombre del grupo de recursos.

--name --service-name

Especifique el nombre del servicio. El nombre de la aplicación debe ser un prefijo del nombre del servicio, por ejemplo: appName~serviceName.

--resource-group -g

Especifique el nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--service-type

Especifique el nombre de tipo de servicio de la aplicación; debe existir en el manifiesto de aplicación.

--state

Especifique si el servicio no tiene estado o tiene estado.

valores aceptados: stateful, stateless

Parámetros opcionales

--default-move-cost

Especifique el costo predeterminado de un traslado. Los costos más altos hacen que sea menos probable que Cluster Resource Manager mueva la réplica al intentar equilibrar el clúster.

valores aceptados: High, Low, Medium, Zero
--instance-count

Especifique el recuento de instancias para el servicio sin estado. Si se usa -1, significa que se ejecutará en todos los nodos.

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

Especifique el tamaño mínimo del conjunto de réplicas para el servicio con estado.

--partition-scheme

Especifique qué esquema de partición se va a usar. Las particiones de singleton se usan normalmente cuando el servicio no requiere ningún enrutamiento adicional. UniformInt64 significa que cada partición posee un intervalo de claves int64. El nombre suele ser para los servicios con datos que se pueden agrupar en depósitos, dentro de un conjunto limitado. Algunos ejemplos habituales de campos de datos que se usan como claves de partición con nombre son regiones, códigos postales, grupos de clientes u otros límites empresariales.

valores aceptados: named, singleton, uniformInt64
valor predeterminado: singleton
--target-replica --target-replica-set-size

Especifique el tamaño del conjunto de réplicas de destino para el servicio con estado.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az sf service delete

Eliminar un servicio.

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

Ejemplos

Eliminar servicio.

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

Parámetros requeridos

--application-name

Nombre del recurso de aplicación.

--cluster-name -c

Especifique el nombre del clúster, si no se le asigna, será el mismo que el nombre del grupo de recursos.

--name --service-name

Especifique el nombre del servicio. El nombre de la aplicación debe ser un prefijo del nombre del servicio, por ejemplo: appName~serviceName.

--resource-group -g

Especifique el nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az sf service list

Enumerar los servicios de una aplicación determinada.

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

Ejemplos

Enumerar servicios.

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

Parámetros requeridos

--application-name

Nombre del recurso de aplicación.

--cluster-name -c

Especifique el nombre del clúster, si no se le asigna, será el mismo que el nombre del grupo de recursos.

--resource-group -g

Especifique el nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az sf service show

Obtener un servicio.

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

Ejemplos

Mostrar las propiedades de un servicio en un clúster de Azure Service Fabric.

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

Parámetros requeridos

--application-name

Nombre del recurso de aplicación.

--cluster-name -c

Especifique el nombre del clúster, si no se le asigna, será el mismo que el nombre del grupo de recursos.

--name --service-name

Especifique el nombre del servicio. El nombre de la aplicación debe ser un prefijo del nombre del servicio, por ejemplo: appName~serviceName.

--resource-group -g

Especifique el nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.