az sf service

  • Referência

Gerenciar serviços em execução em um cluster do Azure Service Fabric. Suporte somente a serviços implantados pela ARM.

Comandos

Nome Description Tipo Status
az sf service create

Crie um novo serviço em um cluster do Azure Service Fabric.

 Núcleo GA
az sf service delete

Excluir um serviço.

 Núcleo GA
az sf service list

Listar serviços de um determinado aplicativo.

 Núcleo GA
az sf service show

Obtenha um serviço.

 Núcleo GA

az sf service create

Crie um novo serviço em um cluster do 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]

Exemplos

Crie um novo serviço sem monitoração de estado "testApp~testService1" com contagem de instâncias -1 (em todos os nós).

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

Crie um novo serviço com monitoração de estado "testApp~testService2" com um destino de 5 nós.

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 Exigidos

--application --application-name

Especifique o nome do serviço. O nome do aplicativo deve ser um prefixo do nome do serviço, por exemplo: appName~serviceName.

--cluster-name -c

Especifique o nome do cluster, se não for fornecido, ele será igual ao nome do grupo de recursos.

--name --service-name

Especifique o nome do serviço. O nome do aplicativo deve ser um prefixo do nome do serviço, por exemplo: appName~serviceName.

--resource-group -g

Especifique o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--service-type

Especifique o nome do tipo de serviço do aplicativo, ele deve existir no manifesto do aplicativo.

--state

Especifique se o serviço é sem monitoração de estado ou com monitoração de estado.

valores aceitos: stateful, stateless

Parâmetros Opcionais

--default-move-cost

Especifique o custo padrão para uma movimentação. Custos mais altos tornam menos provável que o Gerenciador de Recursos de Cluster mova a réplica ao tentar equilibrar o cluster.

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

Especifique a contagem de instâncias para o serviço sem monitoração de estado. Se -1 for usado, significa que ele será executado em todos os nós.

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

Especifique o tamanho mínimo do conjunto de réplicas para o serviço com monitoração de estado.

--partition-scheme

Especifique o esquema de partição a ser usado. Partições de singleton normalmente são usadas quando o serviço não requer qualquer roteamento adicional. UniformInt64 significa que cada partição possui um intervalo de chaves int64. Nomeado é geralmente para serviços com dados que podem ser agrupados, dentro de um conjunto limitado. Alguns exemplos comuns de campos de dados usados como chaves de partição nomeada seriam regiões, códigos postais, grupos de clientes ou outros limites de negócios.

valores aceitos: named, singleton, uniformInt64
valor padrão: singleton
--target-replica --target-replica-set-size

Especifique o tamanho do conjunto de réplicas de destino para o serviço com monitoração de estado.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az sf service delete

Excluir um serviço.

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

Exemplos

Excluir serviço.

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

Parâmetros Exigidos

--application-name

O nome do recurso do aplicativo.

--cluster-name -c

Especifique o nome do cluster, se não for fornecido, ele será igual ao nome do grupo de recursos.

--name --service-name

Especifique o nome do serviço. O nome do aplicativo deve ser um prefixo do nome do serviço, por exemplo: appName~serviceName.

--resource-group -g

Especifique o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az sf service list

Listar serviços de um determinado aplicativo.

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

Exemplos

Listar serviços.

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

Parâmetros Exigidos

--application-name

O nome do recurso do aplicativo.

--cluster-name -c

Especifique o nome do cluster, se não for fornecido, ele será igual ao nome do grupo de recursos.

--resource-group -g

Especifique o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az sf service show

Obtenha um serviço.

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

Exemplos

Mostrar as propriedades de um serviço em um cluster do Azure Service Fabric.

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

Parâmetros Exigidos

--application-name

O nome do recurso do aplicativo.

--cluster-name -c

Especifique o nome do cluster, se não for fornecido, ele será igual ao nome do grupo de recursos.

--name --service-name

Especifique o nome do serviço. O nome do aplicativo deve ser um prefixo do nome do serviço, por exemplo: appName~serviceName.

--resource-group -g

Especifique o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.