Compartilhar via

az sf managed-application

  • Referência

Gerenciar aplicativos em execução em um cluster gerenciado do Azure Service Fabric. Suporte somente a aplicativos implantados pelo ARM.

Comandos

Nome Description Tipo Status
az sf managed-application create

Crie um novo aplicativo gerenciado em um cluster gerenciado do Azure Service Fabric.

 Núcleo GA
az sf managed-application delete

Exclua um aplicativo gerenciado.

 Núcleo GA
az sf managed-application list

Listar aplicativos gerenciados de um determinado cluster gerenciado.

 Núcleo GA
az sf managed-application show

Mostrar as propriedades de um aplicativo gerenciado em um cluster gerenciado do Azure Service Fabric.

 Núcleo GA
az sf managed-application update

Atualize um aplicativo gerenciado do Azure Service Fabric.

 Núcleo GA

az sf managed-application create

Crie um novo aplicativo gerenciado em um cluster gerenciado do Azure Service Fabric.

az sf managed-application create --application-name
                                 --application-type-name
                                 --application-type-version
                                 --cluster-name
                                 --resource-group
                                 [--application-parameters]
                                 [--package-url]
                                 [--tags]

Exemplos

Crie o aplicativo gerenciado "testApp" com parâmetros. O tipo de aplicativo "TestAppType" versão "v1" já deve existir no cluster e os parâmetros do aplicativo devem ser definidos no manifesto do aplicativo.

az sf managed-application create -g testRG -c testCluster --application-name testApp --application-type-name TestAppType \
  --application-type-version v1 --application-parameters key0=value0 --tags key1=value1

Crie o aplicativo "testApp" e a versão do tipo de aplicativo usando a URL do pacote fornecida.

az sf managed-application create -g testRG -c testCluster --application-name testApp --application-type-name TestAppType \
  --application-type-version v1 --package-url "https://sftestapp.blob.core.windows.net/sftestapp/testApp_1.0.sfpkg" \
    --application-parameters key0=value0

Parâmetros Exigidos

--application-name --name

Especifique o nome do aplicativo.

--application-type-name --type-name

Especifique o nome do tipo de aplicativo.

--application-type-version --version

Especifique a versão do tipo de 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 Opcionais

--application-parameters --parameters

Especifique os parâmetros do aplicativo como pares chave/valor. Esses parâmetros devem existir no manifesto do aplicativo. Por exemplo: --application-parameters param1=value1 param2=value2.

--package-url

Especifique a url do arquivo sfpkg do pacote do aplicativo.

--tags

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

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

Exclua um aplicativo gerenciado.

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

Exemplos

Excluir aplicativo gerenciado.

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

Parâmetros Exigidos

--application-name --name

Especifique o nome 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 managed-application list

Listar aplicativos gerenciados de um determinado cluster gerenciado.

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

Exemplos

Listar aplicativos gerenciados para um determinado cluster gerenciado.

az sf managed-application list -g testRG -c testCluster

Parâmetros Exigidos

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

Mostrar as propriedades de um aplicativo gerenciado em um cluster gerenciado do Azure Service Fabric.

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

Exemplos

Obtenha o aplicativo gerenciado.

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

Parâmetros Exigidos

--application-name --name

Especifique o nome 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 managed-application update

Atualize um aplicativo gerenciado do Azure Service Fabric.

Isso permite atualizar as tags, os parâmetros do aplicativo, o valor é o aplicativo UpgradePolicy e/ou atualizar a versão do tipo de aplicativo que acionará uma atualização do aplicativo.

az sf managed-application update --application-name
                                 --cluster-name
                                 --resource-group
                                 [--application-parameters]
                                 [--application-type-version]
                                 [--close-duration]
                                 [--consider-warning-as-error {false, true}]
                                 [--failure-action {Manual, Rollback}]
                                 [--force-restart {false, true}]
                                 [--hc-retry-timeout]
                                 [--hc-stable-duration]
                                 [--hc-wait-duration]
                                 [--max-percent-unhealthy-apps]
                                 [--max-percent-unhealthy-partitions]
                                 [--max-percent-unhealthy-replicas]
                                 [--max-percent-unhealthy-services]
                                 [--recreate-application {false, true}]
                                 [--rep-check-timeout]
                                 [--service-type-health-policy-map]
                                 [--tags]
                                 [--ud-timeout]
                                 [--upgrade-mode {Monitored, UnmonitoredAuto}]
                                 [--upgrade-timeout]

Exemplos

Atualize os parâmetros do aplicativo e os valores de política de upgreade e a versão do tipo de aplicativo para v2.

az sf managed-application update -g testRG -c testCluster --application-name testApp --application-type-version v2 \
  --application-parameters key0=value0 --health-check-stable-duration 0 --health-check-wait-duration 0 --health-check-retry-timeout 0 \
    --upgrade-domain-timeout 5000 --upgrade-timeout 7000 --failure-action Rollback --upgrade-replica-set-check-timeout 300 --force-restart

Atualizar mapa de diretiva de integridade do tipo de serviço de aplicativo gerenciado.

az sf managed-application update -g testRG -c testCluster --application-name testApp --service-type-health-policy-map  "ServiceTypeName01"="5,10,5" "ServiceTypeName02"="5,5,5"

Parâmetros Exigidos

--application-name --name

Especifique o nome 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 Opcionais

--application-parameters --parameters

Especifique os parâmetros do aplicativo como pares chave/valor. Esses parâmetros devem existir no manifesto do aplicativo. Por exemplo: --application-parameters param1=value1 param2=value2.

--application-type-version --version

Especifique a versão do tipo de aplicativo.

--close-duration --instance-close-delay-duration --instance-close-duration

Especifique a duração em segundos, para aguardar antes que uma instância sem monitoração de estado seja fechada, para permitir que as solicitações ativas sejam drenadas normalmente. Isso seria efetivo quando a instância estiver sendo fechada durante a atualização do aplicativo/cluster, somente para as instâncias que tiverem uma duração de atraso diferente de zero configurada na descrição do serviço.

--consider-warning-as-error --warning-as-error

Indica se um evento de integridade de aviso deve ser tratado como um evento de erro durante a avaliação de integridade.

Valores aceitos: false, true
Valor padrão: False
--failure-action

Especifique a ação a ser executada se a atualização monitorada falhar. Os valores aceitáveis para esse parâmetro são Rollback ou Manual.

Valores aceitos: Manual, Rollback
--force-restart

Indica que o host de serviço é reiniciado mesmo se a atualização for uma alteração somente de configuração.

Valores aceitos: false, true
Valor padrão: False
--hc-retry-timeout --health-check-retry-timeout

Especifique a duração, em segundos, após a qual o Service Fabric tentará novamente a verificação de integridade se a verificação de integridade anterior falhar.

--hc-stable-duration --health-check-stable-duration

Especifique a duração, em segundos, que o Service Fabric aguarda para verificar se o aplicativo está estável antes de mover para o próximo domínio de atualização ou concluir a atualização. Essa duração de espera evita alterações de integridade não detectadas logo após a verificação de integridade ser executada.

--hc-wait-duration --health-check-wait-duration

Especifique a duração, em segundos, que o Service Fabric aguarda antes de executar a verificação de integridade inicial depois de concluir a atualização no domínio de atualização.

--max-percent-unhealthy-apps --max-percent-unhealthy-deployed-applications --max-unhealthy-apps

Especifique a porcentagem máxima das instâncias de aplicativo implantadas nos nós do cluster que têm um estado de integridade de erro antes que o estado de integridade do aplicativo para o cluster seja erro. Os valores permitidos são de 0 a 100.

--max-percent-unhealthy-partitions --max-unhealthy-parts

Especifique a porcentagem máxima de partições unhelthy por serviço permitida pela diretiva de integridade para o tipo de serviço padrão a ser usado para a atualização monitorada. Os valores permitidos são de 0 a 100.

--max-percent-unhealthy-replicas --max-unhealthy-reps

Especifique a porcentagem máxima de réplicas unhelthy por serviço permitida pela diretiva de integridade para o tipo de serviço padrão a ser usado para a atualização monitorada. Os valores permitidos são de 0 a 100.

--max-percent-unhealthy-services --max-unhealthy-servs

Especifique a porcentagem máxima de serviços de unhelthy permitida pela diretiva de integridade para o tipo de serviço padrão a ser usado para a atualização monitorada. Os valores permitidos são de 0 a 100.

--recreate-application

Determina se o aplicativo deve ser recriado na atualização. Se value=true, o restante dos parâmetros da política de atualização não será permitido.

Valores aceitos: false, true
Valor padrão: False
--rep-check-timeout --replica-check-timeout --upgrade-replica-set-check-timeout

Especifique o tempo máximo, em segundos, que o Service Fabric aguarda que um serviço seja reconfigurado em um estado seguro, se ainda não estiver em um estado seguro, antes que o Service Fabric prossiga com a atualização.

--service-type-health-policy-map --service-type-policy

Especifique o mapa da diretiva de integridade a ser usado para diferentes tipos de serviço como pares chave/valor no seguinte formato: "ServiceTypeName"="MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices". por exemplo: --service-type-health-policy-map "ServiceTypeName01"="5,10,5" "ServiceTypeName02"="5,5,5".

--tags

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

--ud-timeout --upgrade-domain-timeout

Especifique o tempo máximo, em segundos, que o Service Fabric leva para atualizar um único domínio de atualização. Após esse período, a atualização falhará.

--upgrade-mode

Especifique o modo usado para monitorar a integridade durante uma atualização sem interrupção. Os valores são Monitored e UnmonitoredAuto.

Valores aceitos: Monitored, UnmonitoredAuto
--upgrade-timeout

Especifique o tempo máximo, em segundos, que o Service Fabric leva para toda a atualização. Após esse período, a atualização falhará.

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.