az sf application

Gerencie aplicativos em execução em um cluster de Service Fabric do Azure. Oferece suporte apenas a aplicativos implantados no ARM.

Comandos

az sf application certificate

Gerenciar o certificado de um aplicativo.

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.

az sf application create

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

az sf application delete

Excluir um aplicativo.

az sf application list

Listar aplicativos de um determinado cluster.

az sf application show

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

az sf application update

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

az sf application create

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

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

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

--application-parameters --parameters

Especifique os parâmetros do aplicativo como pares de 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 um aplicativo será colocado. 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 Service Fabric reservará a capacidade para esse aplicativo, isso não significa que o aplicativo tem 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 de aplicativos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID .

az sf application delete

Excluir um aplicativo.

az sf application delete --application-name
                         --cluster-name
                         --resource-group
                         [--subscription]

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID .

az sf application list

Listar aplicativos de um determinado cluster.

az sf application list --cluster-name
                       --resource-group
                       [--query-examples]
                       [--subscription]

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

--query-examples

Recomende uma cadeia de caracteres JMESPath para você. Você pode copiar uma da consulta e colá-la após o parâmetro--Query entre aspas duplas para ver os resultados. Você pode adicionar uma ou mais palavras-chave posicionais para que possamos dar sugestões com base nessas palavras-chaves.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID .

az sf application show

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

az sf application show --application-name
                       --cluster-name
                       --resource-group
                       [--query-examples]
                       [--subscription]

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

--query-examples

Recomende uma cadeia de caracteres JMESPath para você. Você pode copiar uma da consulta e colá-la após o parâmetro--Query entre aspas duplas para ver os resultados. Você pode adicionar uma ou mais palavras-chave posicionais para que possamos dar sugestões com base nessas palavras-chaves.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID .

az sf application update

Atualizar um aplicativo de Service Fabric do Azure. Isso permite atualizar os parâmetros do aplicativo e/ou atualizar a versão do tipo de aplicativo que irá disparar uma atualização de 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]
                         [--subscription]
                         [--ud-timeout]
                         [--upgrade-timeout]

Exemplos

Atualize os parâmetros do aplicativo e os valores de política upgreade 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, 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

--application-parameters --parameters

Especifique os parâmetros do aplicativo como pares de 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
--failure-action

Especifique a ação a ser tomada 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 que a atualização seja uma alteração somente de configuração.

valores aceitos: false, true
--hc-retry-timeout --health-check-retry-timeout

Especifique a duração, em segundos, após a qual 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 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 de integridade logo após a execução da verificação de integridade.

--hc-wait-duration --health-check-wait-duration

Especifique a duração, em segundos, que 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 um aplicativo será colocado. 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.

--max-porcent-unhealthy-apps --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 o formato 0 a 100.

--max-porcent-unhealthy-partitions --max-unhealthy-parts

Especifique o percentual máximo de partições unhelthy 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 o formato 0 a 100.

--max-porcent-unhealthy-replicas --max-unhealthy-reps

Especifique o percentual máximo de réplicas unhelthy 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 o formato 0 a 100.

--max-porcent-unhealthy-services --max-unhealthy-servs

Especifique o percentual máximo de serviços unhelthy 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 o formato 0 a 100.

--min-nodes --minimum-nodes

Especifique o número mínimo de nós em que Service Fabric reservará a capacidade para esse aplicativo, isso não significa que o aplicativo tem 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 Service Fabric aguarda que um serviço seja reconfigurado para um estado seguro, se ainda não estiver em um estado seguro, antes de Service Fabric prosseguir com a atualização.

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

Especifique o mapa da política de integridade a ser usado para diferentes tipos de serviço como uma tabela de hash no seguinte formato: {"Service typeName": "MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices"}. Por exemplo: @ {"ServiceTypeName01" = "5, 10, 5"; "ServiceTypeName02" = "5, 5, 5"}.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID .

--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 Service Fabric leva para toda a atualização. Após esse período, a atualização falhará.