az sf application

Gerenciar aplicativos em execução em um cluster do Azure Service Fabric. Dá suporte apenas a aplicativos implantados pelo ARM.

Comandos

Nome	Description	Tipo	Status
az sf application certificate	Gerenciar o certificado de um aplicativo.	Core	GA
az sf application certificate add	Adicione um novo certificado aos Conjuntos de Dimensionamento de Máquinas Virtuais que compõem o cluster a ser usado por aplicativos hospedados.	Core	GA
az sf application create	Crie um novo aplicativo em um cluster do Azure Service Fabric.	Core	GA
az sf application delete	Excluir um aplicativo.	Core	GA
az sf application list	Listar aplicativos de um determinado cluster.	Core	GA
az sf application show	Mostrar as propriedades de um aplicativo em um cluster do Azure Service Fabric.	Core	GA
az sf application update	Atualize um aplicativo do Azure Service Fabric. Isso permite atualizar os parâmetros do aplicativo e/ou atualizar a versão do tipo de aplicativo que disparará uma atualização do aplicativo.	Core	GA

az sf application create

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

az sf application create --application-name --name
                         --application-type-name --type-name
                         --application-type-version --version
                         --cluster-name
                         --resource-group
                         [--application-parameters --parameters]
                         [--max-nodes --maximum-nodes]
                         [--min-nodes --minimum-nodes]
                         [--package-url]

Exemplos

Crie o aplicativo "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 application create -g testRG -c testCluster --application-name testApp --application-type-name TestAppType \
  --application-type-version v1 --application-parameters key0=value0

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

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

--max-nodes --maximum-nodes

Especifique o número máximo de nós nos quais colocar um aplicativo. O valor desse parâmetro deve ser um inteiro não negativo. O valor padrão é 0, o que indica que o aplicativo pode ser colocado em qualquer número de nós no cluster.

--min-nodes --minimum-nodes

Especifique o número mínimo de nós em que o Service Fabric reservará capacidade para este aplicativo, isso não significa que o aplicativo tenha réplicas em todos esses nós. O valor desse parâmetro deve ser um inteiro não negativo. O valor padrão para isso é zero, o que significa que nenhuma capacidade é reservada para o aplicativo.

--package-url

Especifique a URL do arquivo sfpkg do pacote do aplicativo.

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

Excluir um aplicativo.

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

Exemplos

Excluir aplicativo.

az sf 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 application list

Listar aplicativos de um determinado cluster.

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

Exemplos

Listar aplicativos para um determinado cluster.

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

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

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

Exemplos

Obter aplicativo.

az sf 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 application update

Atualize um aplicativo do Azure Service Fabric. Isso permite atualizar os parâmetros do aplicativo e/ou atualizar a versão do tipo de aplicativo que disparará uma atualização do aplicativo.

az sf application update --application-name --name
                         --cluster-name
                         --resource-group
                         [--application-parameters --parameters]
                         [--application-type-version --version]
                         [--consider-warning-as-error --warning-as-error {false, true}]
                         [--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]
                         [--max-nodes --maximum-nodes]
                         [--max-unhealthy-apps]
                         [--max-unhealthy-parts]
                         [--max-unhealthy-reps]
                         [--max-unhealthy-servs]
                         [--min-nodes --minimum-nodes]
                         [--rep-check-timeout --replica-check-timeout]
                         [--service-type-health-policy-map]
                         [--ud-timeout --upgrade-domain-timeout]
                         [--upgrade-timeout]

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 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 os nós mínimos e máximos do aplicativo.

az sf application update -g testRG -c testCluster --application-name testApp --minimum-nodes 1 --maximum-nodes 3

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.

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

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

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

--max-nodes --maximum-nodes

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

--min-nodes --minimum-nodes

--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 uma tabela de hash no seguinte formato: {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Por exemplo: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }.

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

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

Comentários

Esta página foi útil?

Compartilhar via

az sf application

Comandos

az sf application create

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az sf application delete

Exemplos

Parâmetros Exigidos

az sf application list

Exemplos

Parâmetros Exigidos

az sf application show

Exemplos

Parâmetros Exigidos

az sf application update

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

Comentários