az sf application

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

Comandos

Name	Description	Tipo	Status
az sf application certificate	Gerencie o certificado de um aplicativo.	Core	disponibilidade geral
az sf application certificate add	Adicione um novo certificado aos Conjuntos de Dimensionamento de Máquina Virtual que compõem o cluster a ser usado por aplicativos hospedados.	Core	disponibilidade geral
az sf application create	Crie um novo aplicativo em um cluster do Azure Service Fabric.	Core	disponibilidade geral
az sf application delete	Excluir um aplicativo.	Core	disponibilidade geral
az sf application list	Listar aplicativos de um determinado cluster.	Core	disponibilidade geral
az sf application show	Mostrar as propriedades de um aplicativo em um cluster do Azure Service Fabric.	Core	disponibilidade geral
az sf application update	Atualizar 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 acionará uma atualização do aplicativo.	Core	disponibilidade geral

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

--max-nodes --maximum-nodes

Especifique o número máximo de nós nos quais colocar um aplicativo. O valor deste parâmetro deve ser um número 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 a garantia de ter réplicas em todos esses nós. O valor deste parâmetro deve ser um número inteiro não negativo. O valor padrão para isso é zero, o que significa que nenhuma capacidade está reservada para o aplicativo.

--package-url

Especifique a url do arquivo sfpkg do pacote de aplicativo.

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 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 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 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 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 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 aplicação.

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

Atualizar 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 acionará 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 da 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 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.

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

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

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

--max-nodes --maximum-nodes

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

--min-nodes --minimum-nodes

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

Feedback

Esta página foi útil?

Partilhar via

az sf application

Comandos

az sf application create

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az sf application delete

Exemplos

Parâmetros Obrigatórios

az sf application list

Exemplos

Parâmetros Obrigatórios

az sf application show

Exemplos

Parâmetros Obrigatórios

az sf application update

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

Feedback