Compartir a través de

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.

 Núcleo GA
az sf service delete

Eliminar un servicio.

 Núcleo GA
az sf service list

Enumerar los servicios de una aplicación determinada.

 Núcleo GA
az sf service show

Obtener un servicio.

 Núcleo GA

az sf service create

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

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

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 singleton se suelen usar 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 comunes de campos de datos usados como claves de partición con nombre serían 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 del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

az sf service delete

Eliminar un servicio.

az sf service delete --application-name
                     --cluster-name
                     --name --service-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. Obligatorio.

--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 del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver 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. Obligatorio.

--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 del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

az sf service show

Obtener un servicio.

az sf service show --application-name
                   --cluster-name
                   --name --service-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. Obligatorio.

--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 del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.