az sf application

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.	Core	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.	Core	GA
az sf application create	Cree una nueva aplicación en un clúster de Azure Service Fabric.	Core	GA
az sf application delete	Eliminar una aplicación.	Core	GA
az sf application list	Enumerar las aplicaciones de un clúster determinado.	Core	GA
az sf application show	Mostrar las propiedades de una aplicación en un clúster de Azure Service Fabric.	Core	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.	Core	GA

az sf application create

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

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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--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 del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

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

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az sf application delete

Eliminar una aplicación.

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

Ejemplos

Eliminar 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 del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

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

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

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 del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

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

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

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 --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 del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

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

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

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

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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--application-parameters --parameters

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

Propiedad	Valor
Grupo de parámetros:	Upgrade description Arguments
Valor predeterminado:	False
Valores aceptados:	false, true

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

Propiedad	Valor
Grupo de parámetros:	Upgrade description Arguments
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.

Propiedad	Valor
Valor predeterminado:	False
Valores aceptados:	false, true

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

Propiedad	Valor
Grupo de parámetros:	Upgrade description Arguments

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

Propiedad	Valor
Grupo de parámetros:	Upgrade description Arguments

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

Propiedad	Valor
Grupo de parámetros:	Upgrade description Arguments

--max-nodes --maximum-nodes

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

Propiedad	Valor
Grupo de parámetros:	Upgrade description Arguments

--max-unhealthy-parts

Especifique el porcentaje máximo de particiones incorrectas 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.

Propiedad	Valor
Grupo de parámetros:	Upgrade description Arguments

--max-unhealthy-reps

Especifique el porcentaje máximo de réplicas incorrectas 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.

Propiedad	Valor
Grupo de parámetros:	Upgrade description Arguments

--max-unhealthy-servs

Especifique el porcentaje máximo de servicios incorrectos permitidos 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.

Propiedad	Valor
Grupo de parámetros:	Upgrade description Arguments

--min-nodes --minimum-nodes

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

Propiedad	Valor
Grupo de parámetros:	Upgrade description Arguments

--service-type-health-policy-map

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.

Propiedad	Valor
Grupo de parámetros:	Upgrade description Arguments

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

Propiedad	Valor
Grupo de parámetros:	Upgrade description Arguments

Parámetros globales

--debug

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

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

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

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

Comentarios

¿Le ha resultado útil esta página?

Compartir a través de

az sf application

Comandos

az sf application create

Ejemplos

Parámetros requeridos

Parámetros opcionales

az sf application delete

Ejemplos

Parámetros requeridos

az sf application list

Ejemplos

Parámetros requeridos

az sf application show

Ejemplos

Parámetros requeridos

az sf application update

Ejemplos

Parámetros requeridos

Parámetros opcionales

Comentarios