Partilhar via

az sf managed-application

Gerencie aplicativos em execução em um cluster gerenciado do Azure Service Fabric. Suporta apenas aplicações implementadas por ARM.

Comandos

Name Description Tipo Status
az sf managed-application create

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

 Core disponibilidade geral
az sf managed-application delete

Exclua um aplicativo gerenciado.

 Core disponibilidade geral
az sf managed-application list

Listar aplicativos gerenciados de um determinado cluster gerenciado.

 Core disponibilidade geral
az sf managed-application show

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

 Core disponibilidade geral
az sf managed-application update

Atualize um aplicativo gerenciado do Azure Service Fabric.

 Core disponibilidade geral

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 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 Obrigatórios

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

--tags

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

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az sf managed-application delete

Exclua um aplicativo gerenciado.

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

Exemplos

Exclua o aplicativo gerenciado.

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

Parâmetros Obrigatórios

--application-name --name

Especifique o nome do aplicativo.

--cluster-name -c

Especifique o nome do cluster, se não for fornecido, 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: 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 Obrigatórios

--cluster-name -c

Especifique o nome do cluster, se não for fornecido, 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: 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

Obtenha um aplicativo gerenciado.

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

Parâmetros Obrigatórios

--application-name --name

Especifique o nome do aplicativo.

--cluster-name -c

Especifique o nome do cluster, se não for fornecido, 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az sf managed-application update

Alteração interruptiva

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

Atualize um aplicativo gerenciado do Azure Service Fabric.

Isso permite atualizar as tags, os parâmetros do aplicativo, o aplicativo UpgradePolicy e/ou atualizar a versão do tipo de aplicativo, o que acionará 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 da 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

Atualize 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 Obrigatórios

--application-name --name

Especifique o nome do aplicativo.

--cluster-name -c

Especifique o nome do cluster, se não for fornecido, 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--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 tomada se a atualização monitorada falhar. Os valores aceitáveis para este parâmetro são Rollback ou Manual.

Propriedade Valor
Grupo de parâmetros: Upgrade description Arguments
Valores aceites: 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
Default value: False
Valores aceites: false, true
--hc-retry-timeout --health-check-retry-timeout

Especifique a duração, em segundos, após a qual o Service Fabric tenta novamente 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 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 detetadas 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, para aguardar antes que uma instância sem estado seja fechada, para permitir que as solicitações ativas sejam drenadas normalmente. Isso seria efetivo 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 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.

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

Especifique a percentagem máxima de partições não saudáveis por serviço permitida pela política de saúde para o tipo de serviço padrão a usar na atualização monitorizada. Os valores permitidos são de 0 a 100.

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

Especifique a percentagem máxima de réplicas não saudáveis por serviço permitida pela política de saúde para o tipo de serviço padrão a usar na atualização monitorizada. Os valores permitidos são de 0 a 100.

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

Especifique a percentagem máxima de serviços não saudáveis permitidos pela política de saúde para o tipo de serviço padrão a usar na atualização monitorizada. 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 da política de atualização não será permitido.

Propriedade Valor
Grupo de parâmetros: Upgrade description Arguments
Default value: False
Valores aceites: false, true
--rep-check-timeout --replica-check-timeout

Especifique o tempo máximo, em segundos, que o Service Fabric aguarda a reconfiguração de um serviço 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

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

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

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

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

Propriedade Valor
Grupo de parâmetros: Upgrade description Arguments
Default value: False
Valores aceites: false, true
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False