Compartilhar via

az sf managed-service

  • Referência

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

Comandos

Nome Description Tipo Status
az sf managed-service correlation-scheme

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

 Núcleo GA
az sf managed-service correlation-scheme create

Crie um novo esquema de correlação de serviço gerenciado em um cluster gerenciado do Azure Service Fabric.

 Núcleo GA
az sf managed-service correlation-scheme delete

Exclua um esquema de correlação de serviço gerenciado.

 Núcleo GA
az sf managed-service correlation-scheme update

Atualizar um esquema de correlação de serviço gerenciado.

 Núcleo GA
az sf managed-service create

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

 Núcleo GA
az sf managed-service delete

Excluir um serviço gerenciado.

 Núcleo GA
az sf managed-service list

Listar serviços gerenciados de um determinado aplicativo gerenciado.

 Núcleo GA
az sf managed-service load-metrics

Gerenciar métricas de carga de serviço em execução em um cluster gerenciado do Azure Service Fabric. Suporte somente a serviços implantados pela ARM.

 Núcleo GA
az sf managed-service load-metrics create

Crie uma nova métrica de carga de serviço gerenciado em um cluster gerenciado do Azure Service Fabric.

 Núcleo GA
az sf managed-service load-metrics delete

Excluir um serviço gerenciado.

 Núcleo GA
az sf managed-service load-metrics update

Atualizar um serviço gerenciado.

 Núcleo GA
az sf managed-service show

Obtenha um serviço.

 Núcleo GA
az sf managed-service update

Atualizar um serviço gerenciado.

 Núcleo GA

az sf managed-service create

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

Exemplos

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

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

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

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

Parâmetros Exigidos

--application --application-name

Especifique o nome do serviço.

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

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

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

Especifique o modo de ativação do pacote de serviço.

--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
--has-persisted-state

Determina se este é um serviço persistente que armazena estados no disco local. Se for, o valor dessa propriedade é true, se não for false.

Valores aceitos: false, true
--high-key

Especifique o limite superior do intervalo de chaves de partição que deve ser dividido entre a partição 'Contar' Isso só é usado com o esquema de partição UniformInt64.

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

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

Especifique a definição sobre por quanto tempo as réplicas em espera devem ser mantidas antes de serem removidas, representadas no formato ISO 8601 "hh:mm:ss".

--low-key

Especifique o limite inferior do intervalo de chaves de partição que deve ser dividido entre a partição 'Contar' Isso só é usado com o esquema de partição UniformInt64.

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

Especifique a porcentagem mínima de InstanceCount que deve estar ativa para atender à verificação de segurança EnsureAvailability durante operações como upgrade ou desativação do nó. O número real usado é max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Observe que, se InstanceCount for definido como -1, durante o cálculo MinInstancePercentage, -1 será primeiro convertido no número de nós nos quais as instâncias podem ser colocadas de acordo com as restrições de posicionamento no serviço. Os valores permitidos são de 0 a 100.

--min-instance-count

Especifique o número mínimo de instâncias que devem estar ativas para atender à verificação de segurança EnsureAvailability durante operações como upgrade ou desativação do nó. O número real usado é max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Observe que, se InstanceCount for definido como -1, durante a computação MinInstanceCount -1 será primeiro convertido no número de nós nos quais as instâncias podem ser colocadas de acordo com as restrições de posicionamento no serviço.

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

Especifique o número de partições. Isso só é usado com o esquema de partição UniformInt64.

--partition-names

Especifique a matriz para os nomes das partições. Isso só é usado com esquema de partição nomeada.

--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, UniformInt64Range
Valor padrão: singleton
--placement-constraints

Especifique as restrições de posicionamento como uma cadeia de caracteres. As restrições de posicionamento são expressões boolianas nas propriedades de nó, e permitem restringir um serviço a nós específicos com base nos requisitos do serviço. Por exemplo, para colocar um serviço em nós onde NodeType é azul, especifique o seguinte: "NodeColor == azul)".

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

Especifique a duração pela qual as réplicas podem permanecer no InBuild antes de relatar que a compilação está presa, representada no formato ISO 8601 "hh:mm:ss".

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

Especifique a duração máxima para a qual uma partição pode estar em um estado de perda de quorum, representada no formato ISO 8601 "hh:mm:ss".

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

Especifique a duração entre quando uma réplica fica inativa e quando uma nova réplica é criada, representada no formato ISO 8601 "hh:mm:ss".

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

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

Excluir um serviço gerenciado.

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

Exemplos

Excluir serviço gerenciado.

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

Parâmetros Exigidos

--application --application-name

Especifique o nome do serviço.

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

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

Listar serviços gerenciados de um determinado aplicativo gerenciado.

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

Exemplos

Listar serviços gerenciados.

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

Parâmetros Exigidos

--application --application-name

Especifique o nome do serviço.

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

Obtenha um serviço.

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

Exemplos

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

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

Parâmetros Exigidos

--application --application-name

Especifique o nome do serviço.

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

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

Atualizar um serviço gerenciado.

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]

Exemplos

Atualize o serviço gerenciado sem monitoração de estado.

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

Atualize o serviço com monitoração de estado gerenciado.

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'

Parâmetros Exigidos

--application --application-name

Especifique o nome do serviço.

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

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

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

Especifique a definição sobre por quanto tempo as réplicas em espera devem ser mantidas antes de serem removidas, representadas no formato ISO 8601 "hh:mm:ss".

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

Especifique a porcentagem mínima de InstanceCount que deve estar ativa para atender à verificação de segurança EnsureAvailability durante operações como upgrade ou desativação do nó. O número real usado é max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Observe que, se InstanceCount for definido como -1, durante o cálculo MinInstancePercentage, -1 será primeiro convertido no número de nós nos quais as instâncias podem ser colocadas de acordo com as restrições de posicionamento no serviço. Os valores permitidos são de 0 a 100.

--min-instance-count

Especifique o número mínimo de instâncias que devem estar ativas para atender à verificação de segurança EnsureAvailability durante operações como upgrade ou desativação do nó. O número real usado é max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Observe que, se InstanceCount for definido como -1, durante a computação MinInstanceCount -1 será primeiro convertido no número de nós nos quais as instâncias podem ser colocadas de acordo com as restrições de posicionamento no serviço.

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

--placement-constraints

Especifique as restrições de posicionamento como uma cadeia de caracteres. As restrições de posicionamento são expressões boolianas nas propriedades de nó, e permitem restringir um serviço a nós específicos com base nos requisitos do serviço. Por exemplo, para colocar um serviço em nós onde NodeType é azul, especifique o seguinte: "NodeColor == azul)".

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

Especifique a duração pela qual as réplicas podem permanecer no InBuild antes de relatar que a compilação está presa, representada no formato ISO 8601 "hh:mm:ss".

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

Especifique a duração máxima para a qual uma partição pode estar em um estado de perda de quorum, representada no formato ISO 8601 "hh:mm:ss".

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

Especifique a duração entre quando uma réplica fica inativa e quando uma nova réplica é criada, representada no formato ISO 8601 "hh:mm:ss".

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

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