Partilhar via

az sf application

  • Referência

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.

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

 Principal GA
az sf application create

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

 Principal GA
az sf application delete

Excluir um aplicativo.

 Principal GA
az sf application list

Listar aplicativos de um determinado cluster.

 Principal GA
az sf application show

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

 Principal 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 acionará uma atualização do aplicativo.

 Principal GA

az sf application create

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

az sf application create --application-name
                         --application-type-name
                         --application-type-version
                         --cluster-name
                         --resource-group
                         [--application-parameters]
                         [--max-nodes]
                         [--min-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

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az sf application delete

Excluir um aplicativo.

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az sf application show

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

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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 acionará uma atualização do aplicativo.

az sf application update --application-name
                         --cluster-name
                         --resource-group
                         [--application-parameters]
                         [--application-type-version]
                         [--consider-warning-as-error {false, true}]
                         [--failure-action {Manual, Rollback}]
                         [--force-restart {false, true}]
                         [--hc-retry-timeout]
                         [--hc-stable-duration]
                         [--hc-wait-duration]
                         [--max-nodes]
                         [--max-porcent-unhealthy-apps]
                         [--max-porcent-unhealthy-partitions]
                         [--max-porcent-unhealthy-replicas]
                         [--max-porcent-unhealthy-services]
                         [--min-nodes]
                         [--rep-check-timeout]
                         [--service-type-health-policy-map]
                         [--ud-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 --upgrade-replica-set-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

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

Valores aceites: false, true
Default value: False
--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.

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.

Valores aceites: false, true
Default value: False
--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.

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

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

--max-porcent-unhealthy-apps --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-porcent-unhealthy-partitions --max-unhealthy-parts

Especifique a porcentagem máxima de partições unhelthy por serviço permitido 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-porcent-unhealthy-replicas --max-unhealthy-reps

Especifique a porcentagem máxima de réplicas desativadas 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-porcent-unhealthy-services --max-unhealthy-servs

Especifique a porcentagem máxima de serviços não autorizados 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.

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

--rep-check-timeout --replica-check-timeout --upgrade-replica-set-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.

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

Especifique o mapa da política de estado de funcionamento a utilizar para diferentes tipos de serviços como uma tabela 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á.

--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 de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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