az sf application

  • Referência

Gerenciar aplicativos em execução em um cluster do Azure Service Fabric. Suporte somente a aplicativos implantados pelo ARM.

Comandos

Nome Description Tipo Status
az sf application certificate

Gerenciar o certificado de um aplicativo.

 Núcleo 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.

 Núcleo GA
az sf application create

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

 Núcleo GA
az sf application delete

Excluir um aplicativo.

 Núcleo GA
az sf application list

Listar aplicativos de um determinado cluster.

 Núcleo GA
az sf application show

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

 Núcleo 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.

 Núcleo 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 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á 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 desse parâmetro deve ser um inteiro não negativo. O valor padrão é 0, 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 esse aplicativo, isso não significa que o aplicativo tenha a garantia de ter 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 o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. 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 o 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á 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 Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. 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 Exigidos

--cluster-name -c

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

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. 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 Exigidos

--application-name --name

Especifique o nome do aplicativo.

--cluster-name -c

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

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. 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 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 --upgrade-replica-set-check-timeout 300 --force-restart

Atualize os nós mínimo e máximo 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á 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 aceitos: false, true
valor padrão: False
--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 Rollback ou Manual.

valores aceitos: Manual, Rollback
--force-restart

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

valores aceitos: false, true
valor padrão: False
--hc-retry-timeout --health-check-retry-timeout

Especifique a duração, em segundos, após a qual o Service Fabric tentará 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 detectadas 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 desse parâmetro deve ser um inteiro não negativo. O valor padrão é 0, 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 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-replicas --max-unhealthy-reps

Especifique a porcentagem máxima de réplicas unhelthy 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 de unhelthy 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.

--min-nodes --minimum-nodes

Especifique o número mínimo de nós em que o Service Fabric reservará capacidade para esse aplicativo, isso não significa que o aplicativo tenha a garantia de ter 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.

--rep-check-timeout --replica-check-timeout --upgrade-replica-set-check-timeout

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

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

Especifique o mapa da diretiva 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á.

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

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.