Compartir vía

az sf application

  • Referencia

Administración de aplicaciones que se ejecutan en un clúster de Azure Service Fabric. Solo admite aplicaciones implementadas por ARM.

Comandos

Nombre Description Tipo Estado
az sf application certificate

Administrar el certificado de una aplicación.

 Principal GA
az sf application certificate add

Agregue un nuevo certificado a los conjuntos de escalado de máquinas virtuales que componen el clúster que usarán las aplicaciones hospedadas.

 Principal GA
az sf application create

Cree una nueva aplicación en un clúster de Azure Service Fabric.

 Principal GA
az sf application delete

Elimina una aplicación.

 Principal GA
az sf application list

Enumerar las aplicaciones de un clúster determinado.

 Principal GA
az sf application show

Mostrar las propiedades de una aplicación en un clúster de Azure Service Fabric.

 Principal GA
az sf application update

Actualice una aplicación de Azure Service Fabric. Esto permite actualizar los parámetros de la aplicación o actualizar la versión del tipo de aplicación que desencadenará una actualización de la aplicación.

 Principal GA

az sf application create

Cree una nueva aplicación en un clúster de 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]

Ejemplos

Cree la aplicación "testApp" con parámetros. El tipo de aplicación "TestAppType" versión "v1" ya debe existir en el clúster y los parámetros de la aplicación deben definirse en el manifiesto de aplicación.

az sf application create -g testRG -c testCluster --application-name testApp --application-type-name TestAppType \
  --application-type-version v1 --application-parameters key0=value0

Cree la aplicación "testApp" y la versión del tipo de aplicación mediante la dirección URL del paquete proporcionada.

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 requeridos

--application-name --name

Especifique el nombre de la aplicación.

--application-type-name --type-name

Especifique el nombre del tipo de aplicación.

--application-type-version --version

Especifique la versión del tipo de aplicación.

--cluster-name -c

Especifique el nombre del clúster, si no se le asigna, será el mismo que el nombre del grupo de recursos.

--resource-group -g

Especifique el nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--application-parameters --parameters

Especifique los parámetros de la aplicación como pares clave-valor. Estos parámetros deben existir en el manifiesto de aplicación. por ejemplo: --application-parameters param1=value1 param2=value2.

--max-nodes --maximum-nodes

Especifique el número máximo de nodos en los que se va a colocar una aplicación. El valor de este parámetro debe ser un entero no negativo. El valor predeterminado es 0, lo que indica que la aplicación se puede colocar en cualquier número de nodos del clúster.

--min-nodes --minimum-nodes

Especifique el número mínimo de nodos en los que Service Fabric reservará capacidad para esta aplicación; esto no significa que la aplicación esté garantizada para tener réplicas en todos esos nodos. El valor de este parámetro debe ser un entero no negativo. El valor predeterminado de este valor es cero, lo que significa que no hay ninguna capacidad reservada para la aplicación.

--package-url

Especifique la dirección URL del archivo sfpkg del paquete de aplicación.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az sf application delete

Elimina una aplicación.

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

Ejemplos

Elimina una aplicación.

az sf application delete -g testRG -c testCluster --application-name testApp

Parámetros requeridos

--application-name --name

Especifique el nombre de la aplicación.

--cluster-name -c

Especifique el nombre del clúster, si no se le asigna, será el mismo que el nombre del grupo de recursos.

--resource-group -g

Especifique el nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az sf application list

Enumerar las aplicaciones de un clúster determinado.

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

Ejemplos

Enumerar las aplicaciones de un clúster determinado.

az sf application list -g testRG -c testCluster

Parámetros requeridos

--cluster-name -c

Especifique el nombre del clúster, si no se le asigna, será el mismo que el nombre del grupo de recursos.

--resource-group -g

Especifique el nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az sf application show

Mostrar las propiedades de una aplicación en un clúster de Azure Service Fabric.

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

Ejemplos

Obtener aplicación.

az sf application show -g testRG -c testCluster --application-name testApp

Parámetros requeridos

--application-name --name

Especifique el nombre de la aplicación.

--cluster-name -c

Especifique el nombre del clúster, si no se le asigna, será el mismo que el nombre del grupo de recursos.

--resource-group -g

Especifique el nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az sf application update

Actualice una aplicación de Azure Service Fabric. Esto permite actualizar los parámetros de la aplicación o actualizar la versión del tipo de aplicación que desencadenará una actualización de la aplicación.

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]

Ejemplos

Actualice los parámetros de la aplicación y actualice los valores de directiva y la versión del tipo de aplicación a la versión 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

Actualice los nodos mínimo y máximo de la aplicación.

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

Parámetros requeridos

--application-name --name

Especifique el nombre de la aplicación.

--cluster-name -c

Especifique el nombre del clúster, si no se le asigna, será el mismo que el nombre del grupo de recursos.

--resource-group -g

Especifique el nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--application-parameters --parameters

Especifique los parámetros de la aplicación como pares clave-valor. Estos parámetros deben existir en el manifiesto de aplicación. por ejemplo: --application-parameters param1=value1 param2=value2.

--application-type-version --version

Especifique la versión del tipo de aplicación.

--consider-warning-as-error --warning-as-error

Indica si se debe tratar un evento de mantenimiento de advertencia como un evento de error durante la evaluación de estado.

Valores aceptados: false, true
Valor predeterminado: False
--failure-action

Especifique la acción que se realizará si se produce un error en la actualización supervisada. Los valores aceptables para este parámetro son Rollback o Manual.

Valores aceptados: Manual, Rollback
--force-restart

Indica que el host de servicio se reinicia aunque la actualización sea un cambio de solo configuración.

Valores aceptados: false, true
Valor predeterminado: False
--hc-retry-timeout --health-check-retry-timeout

Especifique la duración, en segundos, después de la cual Service Fabric reintenta la comprobación de estado si se produce un error en la comprobación de estado anterior.

--hc-stable-duration --health-check-stable-duration

Especifique la duración, en segundos, que Service Fabric espera para comprobar que la aplicación es estable antes de pasar al siguiente dominio de actualización o completar la actualización. Esta duración de espera evita cambios no detectados de mantenimiento justo después de realizar la comprobación de estado.

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

Especifique la duración, en segundos, que Service Fabric espera antes de realizar la comprobación de estado inicial después de finalizar la actualización en el dominio de actualización.

--max-nodes --maximum-nodes

Especifique el número máximo de nodos en los que se va a colocar una aplicación. El valor de este parámetro debe ser un entero no negativo. El valor predeterminado es 0, lo que indica que la aplicación se puede colocar en cualquier número de nodos del clúster.

--max-porcent-unhealthy-apps --max-unhealthy-apps

Especifique el porcentaje máximo de las instancias de aplicación implementadas en los nodos del clúster que tienen un estado de mantenimiento de error antes de que se produzca un error en el estado de mantenimiento de la aplicación para el clúster. Los valores permitidos son de 0 a 100.

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

Especifique el porcentaje máximo de particiones desheladas por servicio permitidas por la directiva de mantenimiento para el tipo de servicio predeterminado que se usará para la actualización supervisada. Los valores permitidos son de 0 a 100.

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

Especifique el porcentaje máximo de réplicas no actualizadas por servicio permitidas por la directiva de mantenimiento para el tipo de servicio predeterminado que se usará para la actualización supervisada. Los valores permitidos son de 0 a 100.

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

Especifique el porcentaje máximo de servicios no supervisados permitidos por la directiva de mantenimiento para el tipo de servicio predeterminado que se va a usar para la actualización supervisada. Los valores permitidos son de 0 a 100.

--min-nodes --minimum-nodes

Especifique el número mínimo de nodos en los que Service Fabric reservará capacidad para esta aplicación; esto no significa que la aplicación esté garantizada para tener réplicas en todos esos nodos. El valor de este parámetro debe ser un entero no negativo. El valor predeterminado de este valor es cero, lo que significa que no hay ninguna capacidad reservada para la aplicación.

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

Especifique el tiempo máximo, en segundos, que Service Fabric espera a que un servicio vuelva a configurarse en un estado seguro, si aún no está en un estado seguro, antes de que Service Fabric continúe con la actualización.

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

Especifique la asignación de la directiva de mantenimiento que se va a usar para distintos tipos de servicio como una tabla hash con el siguiente formato: {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Por ejemplo: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }.

--ud-timeout --upgrade-domain-timeout

Especifique el tiempo máximo, en segundos, que Service Fabric tarda en actualizar un único dominio de actualización. Después de este período, se produce un error en la actualización.

--upgrade-timeout

Especifique el tiempo máximo, en segundos, que Service Fabric tarda durante toda la actualización. Después de este período, se produce un error en la actualización.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.