Compartilhar via

az sf managed-application

Gerenciar aplicativos em execução em um cluster gerenciado do Azure Service Fabric. Dá suporte apenas 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.

 Core GA
az sf managed-application delete

Excluir um aplicativo gerenciado.

 Core GA
az sf managed-application list

Listar aplicativos gerenciados de um determinado cluster gerenciado.

 Core GA
az sf managed-application show

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

 Core GA
az sf managed-application update

Atualize um aplicativo gerenciado do Azure Service Fabric.

 Core 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 --name
                                 --application-type-name --type-name
                                 --application-type-version --version
                                 --cluster-name
                                 --resource-group
                                 [--application-parameters --parameters]
                                 [--package-url]
                                 [--tags]

Exemplos

Crie um 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á o mesmo que o 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az sf managed-application delete

Excluir um aplicativo gerenciado.

az sf managed-application delete --application-name --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á o mesmo que o 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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

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á o mesmo que o 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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

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 --name
                               --cluster-name
                               --resource-group

Exemplos

Obter 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á o mesmo que o 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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az sf managed-application update

Alteração interruptiva

A lista de opções foi alterada, execute o comando de ajuda para ver as opções permitidas

Atualize um aplicativo gerenciado do Azure Service Fabric.

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

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

Exemplos

Atualize os parâmetros do aplicativo e atualize os valores de política 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 --replica-check-timeout 300 --force-restart

Atualizar o mapa da política 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á o mesmo que o 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

--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 Reversão ou Manual.

Propriedade Valor
Grupo de parâmetros: Upgrade description Arguments
Valores aceitos: Manual, Rollback
--force-restart

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

Propriedade Valor
Grupo de parâmetros: Upgrade description Arguments
Valor padrão: False
Valores aceitos: false, true
--hc-retry-timeout --health-check-retry-timeout

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

Propriedade Valor
Grupo de parâmetros: Upgrade description Arguments
--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 passar para o próximo domínio de atualização ou concluir a atualização. Essa duração de espera impede alterações não detectadas na integridade logo após a verificação de integridade ser executada.

Propriedade Valor
Grupo de parâmetros: Upgrade description Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Upgrade description Arguments
--instance-close-delay-duration

Especifique a duração em segundos, aguardar até que uma instância sem estado seja fechada, para permitir que as solicitações ativas sejam drenados normalmente. Isso será eficaz quando a instância estiver fechando durante a atualização do aplicativo/cluster, somente para as instâncias que têm uma duração de atraso diferente de zero configurada na descrição do serviço.

Propriedade Valor
Grupo de parâmetros: Upgrade description Arguments
--max-unhealthy-apps

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

Propriedade Valor
Grupo de parâmetros: Upgrade description Arguments
--max-unhealthy-parts

Especifique o percentual máximo de partições não íntegras por serviço permitido pela política 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.

Propriedade Valor
Grupo de parâmetros: Upgrade description Arguments
--max-unhealthy-reps

Especifique o percentual máximo de réplicas não íntegras por serviço permitido pela política 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.

Propriedade Valor
Grupo de parâmetros: Upgrade description Arguments
--max-unhealthy-servs

Especifique o percentual máximo de serviços não íntegros permitidos pela política 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.

Propriedade Valor
Grupo de parâmetros: Upgrade description Arguments
--recreate-application

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

Propriedade Valor
Grupo de parâmetros: Upgrade description Arguments
Valor padrão: False
Valores aceitos: false, true
--rep-check-timeout --replica-check-timeout

Especifique o tempo máximo, em segundos, que o Service Fabric espera 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.

Propriedade Valor
Grupo de parâmetros: Upgrade description Arguments
--service-type-health-policy-map

Especifique o mapa da política de integridade a ser usada 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".

Propriedade Valor
Grupo de parâmetros: Upgrade description Arguments
--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas 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á.

Propriedade Valor
Grupo de parâmetros: Upgrade description Arguments
--upgrade-mode

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

Propriedade Valor
Grupo de parâmetros: Upgrade description Arguments
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á.

Propriedade Valor
Grupo de parâmetros: Upgrade description Arguments
--warning-as-error

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

Propriedade Valor
Grupo de parâmetros: Upgrade description Arguments
Valor padrão: False
Valores aceitos: false, true
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False