az spring app deployment

  • Referencia

Nota:

Esta referencia forma parte de la extensión spring para la CLI de Azure (versión 2.56.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az spring app deployment . Obtenga más información sobre las extensiones.

Comandos para administrar el ciclo de vida de las implementaciones de una aplicación en Azure Spring Apps. Se pueden realizar más operaciones en las implementaciones en el nivel de aplicación con el parámetro --deployment. Por ejemplo, az spring app deploy --deployment .

Comandos

Nombre Description Tipo Estado
az spring app deployment create

Crea una implementación de almacenamiento provisional para la aplicación. Para implementar código o actualizar la configuración en una implementación existente, use az spring app deploy/update --deployment <staging deployment>.

 Extensión GA
az spring app deployment delete

Elimina una implementación de la aplicación.

 Extensión GA
az spring app deployment generate-heap-dump

Genere un volcado de montón de la instancia de la aplicación de destino en una ruta de acceso de archivo determinada.

 Extensión GA
az spring app deployment generate-thread-dump

Genere un volcado de subproceso de la instancia de la aplicación de destino a una ruta de acceso de archivo determinada.

 Extensión GA
az spring app deployment list

Muestra todas las implementaciones de una aplicación.

 Extensión GA
az spring app deployment show

Muestra los detalles de una implementación.

 Extensión GA
az spring app deployment start-jfr

Inicie un JFR en la instancia de la aplicación de destino en una ruta de acceso de archivo determinada.

 Extensión GA

az spring app deployment create

Crea una implementación de almacenamiento provisional para la aplicación. Para implementar código o actualizar la configuración en una implementación existente, use az spring app deploy/update --deployment <staging deployment>.

az spring app deployment create --app
                                --name
                                --resource-group
                                --service
                                [--apms]
                                [--artifact-path]
                                [--build-certificates]
                                [--build-env]
                                [--builder]
                                [--config-file-patterns]
                                [--container-args]
                                [--container-command]
                                [--container-image]
                                [--container-registry]
                                [--cpu]
                                [--custom-actuator-path]
                                [--custom-actuator-port]
                                [--disable-app-log]
                                [--disable-probe {false, true}]
                                [--disable-validation {false, true}]
                                [--enable-liveness-probe {false, true}]
                                [--enable-readiness-probe {false, true}]
                                [--enable-startup-probe {false, true}]
                                [--env]
                                [--grace-period]
                                [--instance-count]
                                [--jvm-options]
                                [--language-framework]
                                [--liveness-probe-config]
                                [--main-entry]
                                [--max-replicas]
                                [--memory]
                                [--min-replicas]
                                [--no-wait]
                                [--readiness-probe-config]
                                [--registry-password]
                                [--registry-username]
                                [--runtime-version {Java_11, Java_17, Java_21, Java_8, NetCore_31}]
                                [--scale-rule-auth]
                                [--scale-rule-http-concurrency]
                                [--scale-rule-metadata]
                                [--scale-rule-name]
                                [--scale-rule-type]
                                [--server-version]
                                [--skip-clone-settings]
                                [--source-path]
                                [--startup-probe-config]
                                [--target-module]
                                [--version]

Ejemplos

Implemente el código fuente en una nueva implementación de una aplicación. Esto empaquetará el directorio actual, compilará binario con Pivotal Build Service y, a continuación, lo implementará.

az spring app deployment create -n green-deployment --app MyApp -s MyCluster -g MyResourceGroup --source-path

Implemente un archivo jar pregenerado en una aplicación con opciones de jvm y variables de entorno.

az spring app deployment create -n green-deployment --app MyApp -s MyCluster -g MyResourceGroup --artifact-path app.jar --jvm-options="-XX:+UseG1GC -XX:+UseStringDeduplication" --env foo=bar

Implemente una imagen de contenedor en Docker Hub en una aplicación.

az spring app deployment create -n green-deployment --app MyApp -s MyCluster -g MyResourceGroup --container-image contoso/your-app:v1

Implemente una imagen de contenedor en un registro privado en una aplicación.

az spring app deployment create -n green-deployment --app MyApp -s MyCluster -g MyResourceGroup --container-image contoso/your-app:v1 --container-registry myacr.azurecr.io --registry-username <username> --registry-password <password>

Parámetros requeridos

--app

Nombre de la aplicación.

--name -n

Nombre de la implementación.

--resource-group -g

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

--service -s

El nombre de la instancia de Azure Spring Apps, puede configurar el servicio predeterminado mediante az configure --defaults spring=.

Parámetros opcionales

--apms

(Solo nivel De empresa) Nombres de APM separados por espacios.

--artifact-path

Implemente el artefacto pregenerado especificado (jar, war o netcore zip, war está en versión preliminar pública).

--build-certificates

(Solo nivel De empresa) Nombres de certificado separados por espacios, los certificados se usan durante el tiempo de compilación.

--build-env

Variables de entorno separadas por espacios en formato "clave[=valor]".

--builder

(Solo nivel De empresa) Compila el generador de servicios que se usa para compilar el archivo ejecutable.

valor predeterminado: default
--config-file-patterns

(Solo nivel De empresa) Patrones de archivo de configuración separados por "", para decidir qué patrones del servicio de configuración de aplicaciones se usarán. Use """ para borrar las configuraciones existentes.

--container-args

Argumentos de la imagen de contenedor.

--container-command

Comando de la imagen de contenedor.

--container-image

Etiqueta de imagen de contenedor.

--container-registry

Registro de la imagen de contenedor.

valor predeterminado: docker.io
--cpu

Cantidad de recursos de CPU. Debe ser de 250m, 500m, 750m, 1250m o número de núcleos de CPU.

--custom-actuator-path

(Solo nivel De empresa) Ruta de acceso del accionador personalizado para la aplicación. El valor predeterminado es "/actuador".

--custom-actuator-port

(Solo nivel De empresa) Puerto de accionador personalizado para la aplicación. El valor predeterminado es 8080.

--disable-app-log

No imprima los registros de aplicación al implementar la aplicación.

valor predeterminado: False
--disable-probe

Si es true, deshabilite el sondeo de ejecución y preparación.

valores aceptados: false, true
--disable-validation

Si es true, deshabilite la validación de jar.

valores aceptados: false, true
--enable-liveness-probe
Vista previa

Si es false, deshabilitará el sondeo de ejecución de la instancia de la aplicación.

valores aceptados: false, true
--enable-readiness-probe
Vista previa

Si es false, deshabilitará el sondeo de preparación de la instancia de la aplicación.

valores aceptados: false, true
--enable-startup-probe
Vista previa

Si es false, deshabilitará el sondeo de inicio de la instancia de la aplicación.

valores aceptados: false, true
--env

Variables de entorno separadas por espacios en formato "clave[=valor]".

--grace-period --termination-grace-period-seconds
Vista previa

Duración opcional en segundos que la instancia de la aplicación debe finalizar correctamente.

--instance-count

Número de instancia.

--jvm-options

Cadena que contiene opciones de jvm, use '=' en lugar de ' para este argumento para evitar el error de análisis de Bash, por ejemplo: --jvm-options='-Xms1024m -Xmx2048m'.

--language-framework

Marco de lenguaje de la imagen de contenedor cargada. Valores admitidos: "springboot", "".

--liveness-probe-config
Vista previa

Una ruta de acceso del archivo json indica la configuración del sondeo de ejecución.

--main-entry -m

Cadena que contiene la ruta de acceso al archivo ejecutable de .NET en relación con la raíz zip.

--max-replicas

Número máximo de réplicas.

valor predeterminado: 10
--memory

Cantidad de recursos de memoria. Debe ser 512Mi, 1536Mi, 2560Mi, 3584Mi o #Gi, por ejemplo, 1Gi, 3Gi.

--min-replicas

Número mínimo de réplicas.

valor predeterminado: 1
--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False
--readiness-probe-config
Vista previa

Una ruta de acceso del archivo json indica la configuración del sondeo de preparación.

--registry-password

Contraseña del registro de contenedor.

--registry-username

El nombre de usuario del registro de contenedor.

--runtime-version

Versión en tiempo de ejecución del lenguaje usado.

valores aceptados: Java_11, Java_17, Java_21, Java_8, NetCore_31
--scale-rule-auth --sra

Parámetros de autenticación de regla de escalado. Dar formato "=" y separados por espacio.

--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc

Número máximo de solicitudes simultáneas antes de escalar horizontalmente. Solo se admite para las reglas de escalado http y tcp.

--scale-rule-metadata --srm

Metadatos de la regla de escalado. Dar formato a "key[=value]" y separados por espacio.

--scale-rule-name --srn

El nombre de la regla de escalado.

--scale-rule-type --srt

Tipo de la regla de escalado. Valor predeterminado: http.

--server-version

(Solo niveles estándar y básicos) Versión del servidor tomcat. Para enumerar todas las versiones de servidor admitidas, ejecute az spring list-support-server-versions -o table. Esta característica está en versión preliminar pública.

--skip-clone-settings

La creación de una implementación de ensayo copiará automáticamente la configuración de la implementación de producción.

valor predeterminado: False
--source-path

Implemente la carpeta de origen especificada. La carpeta se empaquetará en tar, se cargará y compilará mediante kpack. El valor predeterminado es la carpeta actual si no se proporciona ningún valor.

--startup-probe-config
Vista previa

Una ruta de acceso del archivo json indica la configuración del sondeo de inicio.

--target-module

Módulo secundario que se va a implementar, necesario para varios paquetes jar creados a partir del código fuente.

--version

Versión de implementación, mantenga sin cambios si no se establece.

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 spring app deployment delete

Elimina una implementación de la aplicación.

az spring app deployment delete --app
                                --name
                                --resource-group
                                --service
                                [--no-wait]

Parámetros requeridos

--app

Nombre de la aplicación.

--name -n

Nombre de la implementación.

--resource-group -g

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

--service -s

El nombre de la instancia de Azure Spring Apps, puede configurar el servicio predeterminado mediante az configure --defaults spring=.

Parámetros opcionales

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False
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 spring app deployment generate-heap-dump

Genere un volcado de montón de la instancia de la aplicación de destino en una ruta de acceso de archivo determinada.

az spring app deployment generate-heap-dump --app
                                            --app-instance
                                            --file-path
                                            --resource-group
                                            --service
                                            [--deployment]

Parámetros requeridos

--app

Nombre de la aplicación.

--app-instance

Instancia de aplicación de destino que desea volcar.

--file-path

Ruta de acceso del archivo de montaje del archivo de volcado.

--resource-group -g

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

--service -s

El nombre de la instancia de Azure Spring Apps, puede configurar el servicio predeterminado mediante az configure --defaults spring=.

Parámetros opcionales

--deployment -d

Nombre de una implementación existente de la aplicación. Si no se especifica, el valor predeterminado es la implementación de producció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 spring app deployment generate-thread-dump

Genere un volcado de subproceso de la instancia de la aplicación de destino a una ruta de acceso de archivo determinada.

az spring app deployment generate-thread-dump --app
                                              --app-instance
                                              --file-path
                                              --resource-group
                                              --service
                                              [--deployment]

Parámetros requeridos

--app

Nombre de la aplicación.

--app-instance

Instancia de aplicación de destino que desea volcar.

--file-path

Ruta de acceso del archivo de montaje del archivo de volcado.

--resource-group -g

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

--service -s

El nombre de la instancia de Azure Spring Apps, puede configurar el servicio predeterminado mediante az configure --defaults spring=.

Parámetros opcionales

--deployment -d

Nombre de una implementación existente de la aplicación. Si no se especifica, el valor predeterminado es la implementación de producció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 spring app deployment list

Muestra todas las implementaciones de una aplicación.

az spring app deployment list --app
                              --resource-group
                              --service

Parámetros requeridos

--app

Nombre de la aplicación.

--resource-group -g

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

--service -s

El nombre de la instancia de Azure Spring Apps, puede configurar el servicio predeterminado mediante az configure --defaults spring=.

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 spring app deployment show

Muestra los detalles de una implementación.

az spring app deployment show --app
                              --name
                              --resource-group
                              --service

Parámetros requeridos

--app

Nombre de la aplicación.

--name -n

Nombre de la implementación.

--resource-group -g

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

--service -s

El nombre de la instancia de Azure Spring Apps, puede configurar el servicio predeterminado mediante az configure --defaults spring=.

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 spring app deployment start-jfr

Inicie un JFR en la instancia de la aplicación de destino en una ruta de acceso de archivo determinada.

az spring app deployment start-jfr --app
                                   --app-instance
                                   --file-path
                                   --resource-group
                                   --service
                                   [--deployment]
                                   [--duration]

Parámetros requeridos

--app

Nombre de la aplicación.

--app-instance

Instancia de aplicación de destino que desea volcar.

--file-path

Ruta de acceso del archivo de montaje del archivo de volcado.

--resource-group -g

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

--service -s

El nombre de la instancia de Azure Spring Apps, puede configurar el servicio predeterminado mediante az configure --defaults spring=.

Parámetros opcionales

--deployment -d

Nombre de una implementación existente de la aplicación. Si no se especifica, el valor predeterminado es la implementación de producción.

--duration

Duración de JFR.

valor predeterminado: 60s
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.