Compartir vía

az sf managed-application

  • Referencia

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.

 Principal GA
az sf managed-application delete

Elimine una aplicación administrada.

 Principal GA
az sf managed-application list

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

 Principal GA
az sf managed-application show

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

 Principal GA
az sf managed-application update

Actualice una aplicación administrada de Azure Service Fabric.

 Principal 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
                                 --application-type-name
                                 --application-type-version
                                 --cluster-name
                                 --resource-group
                                 [--application-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

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

Elimine una aplicación administrada.

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

Actualice una aplicación administrada de Azure Service Fabric.

Esto permite actualizar las etiquetas, los parámetros de la aplicación, el valor es 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
                                 --cluster-name
                                 --resource-group
                                 [--application-parameters]
                                 [--application-type-version]
                                 [--close-duration]
                                 [--consider-warning-as-error {false, true}]
                                 [--failure-action {Manual, Rollback}]
                                 [--force-restart {false, true}]
                                 [--hc-retry-timeout]
                                 [--hc-stable-duration]
                                 [--hc-wait-duration]
                                 [--max-percent-unhealthy-apps]
                                 [--max-percent-unhealthy-partitions]
                                 [--max-percent-unhealthy-replicas]
                                 [--max-percent-unhealthy-services]
                                 [--recreate-application {false, true}]
                                 [--rep-check-timeout]
                                 [--service-type-health-policy-map]
                                 [--tags]
                                 [--ud-timeout]
                                 [--upgrade-mode {Monitored, UnmonitoredAuto}]
                                 [--upgrade-timeout]

Ejemplos

Actualice los parámetros de la aplicación y los valores de directiva upgreade 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 --upgrade-replica-set-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

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

--close-duration --instance-close-delay-duration --instance-close-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.

--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-percent-unhealthy-apps --max-percent-unhealthy-deployed-applications --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-percent-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-percent-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-percent-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.

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

Valores aceptados: false, true
Valor predeterminado: False
--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 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".

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

--upgrade-mode

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

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.

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.