Compartir a través de

az sf managed-application

Administrar aplicaciones que se ejecutan en un clúster administrado de Azure Service Fabric. Solo admite aplicaciones implementadas por ARM.

Comandos

Nombre Description Tipo Estado
az sf managed-application create

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

 Core GA
az sf managed-application delete

Elimine una aplicación administrada.

 Core GA
az sf managed-application list

Enumeración de aplicaciones administradas de un clúster administrado determinado.

 Core GA
az sf managed-application show

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

 Core GA
az sf managed-application update

Actualice una aplicación administrada de Azure Service Fabric.

 Core GA

az sf managed-application create

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

az sf managed-application create --application-name --name
                                 --application-type-name --type-name
                                 --application-type-version --version
                                 --cluster-name
                                 --resource-group
                                 [--application-parameters --parameters]
                                 [--package-url]
                                 [--tags]

Ejemplos

Cree una aplicación administrada "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 managed-application create -g testRG -c testCluster --application-name testApp --application-type-name TestAppType \
  --application-type-version v1 --application-parameters key0=value0 --tags key1=value1

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

az sf managed-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.

--package-url

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

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

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 managed-application delete

Elimine una aplicación administrada.

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

Ejemplos

Elimine la aplicación administrada.

az sf managed-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 managed-application list

Enumeración de aplicaciones administradas de un clúster administrado determinado.

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

Ejemplos

Enumere las aplicaciones administradas de un clúster administrado determinado.

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

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

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

Ejemplos

Obtenga la aplicación administrada.

az sf managed-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 managed-application update

Cambio importante

La lista de opciones ha cambiado, ejecute el comando de ayuda para ver las opciones permitidas.

Actualice una aplicación administrada de Azure Service Fabric.

Esto permite actualizar las etiquetas, los parámetros de la aplicación, la aplicación UpgradePolicy o actualizar la versión del tipo de aplicación, que desencadenará una actualización de la aplicación.

az sf managed-application update --application-name --name
                                 --cluster-name
                                 --resource-group
                                 [--application-parameters --parameters]
                                 [--application-type-version --version]
                                 [--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]
                                 [--instance-close-delay-duration]
                                 [--max-unhealthy-apps]
                                 [--max-unhealthy-parts]
                                 [--max-unhealthy-reps]
                                 [--max-unhealthy-servs]
                                 [--recreate-application {false, true}]
                                 [--rep-check-timeout --replica-check-timeout]
                                 [--service-type-health-policy-map]
                                 [--tags]
                                 [--ud-timeout --upgrade-domain-timeout]
                                 [--upgrade-mode {Monitored, UnmonitoredAuto}]
                                 [--upgrade-timeout]
                                 [--warning-as-error {false, true}]

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 managed-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 la asignación de directivas de estado del tipo de servicio de aplicación administrada.

az sf managed-application update -g testRG -c testCluster --application-name testApp --service-type-health-policy-map  "ServiceTypeName01"="5,10,5" "ServiceTypeName02"="5,5,5"

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

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.

--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
Grupo de parámetros: Upgrade description Arguments
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
--instance-close-delay-duration

Especifique la duración en segundos, para esperar antes de que se cierre una instancia sin estado, para permitir que las solicitudes activas se agoten correctamente. Esto sería efectivo cuando la instancia se cierra durante la actualización del clúster o la aplicación, solo para las instancias que tienen una duración de retraso distinto de cero configurada en la descripción del servicio.

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

Determina si la aplicación se debe volver a crear al actualizar. Si value=true, no se permiten el resto de los parámetros de la directiva de actualización.

Propiedad Valor
Grupo de parámetros: Upgrade description Arguments
Valor predeterminado: False
Valores aceptados: false, true
--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 pares clave-valor con el formato siguiente: "ServiceTypeName"="MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices". por ejemplo: --service-type-health-policy-map "ServiceTypeName01"="5,10,5" "ServiceTypeName02"="5,5,5".

Propiedad Valor
Grupo de parámetros: Upgrade description Arguments
--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

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

Especifique el modo usado para supervisar el estado durante una actualización gradual. Los valores son Monitored y UnmonitoredAuto.

Propiedad Valor
Grupo de parámetros: Upgrade description Arguments
Valores aceptados: Monitored, UnmonitoredAuto
--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
--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
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