Compartir a través de


az spring app deployment

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 se instalará automáticamente la primera vez que ejecute un comando az spring app deployment. Más información sobre las extensiones.

Este grupo de comandos está en desuso implícitamente porque el grupo de comandos "spring" está en desuso y se quitará en una versión futura.

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

Elimina una implementación de la aplicación.

Extensión Deprecated
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 Deprecated
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 Deprecated
az spring app deployment list

Muestra todas las implementaciones de una aplicación.

Extensión Deprecated
az spring app deployment show

Muestra los detalles de una implementación.

Extensión Deprecated
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 Deprecated

az spring app deployment create

Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "spring" está en desuso y se quitará en una versión futura.

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 --termination-grace-period-seconds]
                                [--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 --sra]
                                [--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc]
                                [--scale-rule-metadata --srm]
                                [--scale-rule-name --srn]
                                [--scale-rule-type --srt]
                                [--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=<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.

--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 "key[=value]".

--builder

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

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

Propiedad Valor
Grupo de parámetros: Custom Container Arguments
--container-command

Comando de la imagen de contenedor.

Propiedad Valor
Grupo de parámetros: Custom Container Arguments
--container-image

Etiqueta de imagen de contenedor.

Propiedad Valor
Grupo de parámetros: Custom Container Arguments
--container-registry

Registro de la imagen de contenedor.

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

Propiedad Valor
Valor predeterminado: False
--disable-probe

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

Propiedad Valor
Valores aceptados: false, true
--disable-validation

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

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

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

Propiedad Valor
Grupo de parámetros: App Customization Arguments
Valores aceptados: false, true
--enable-startup-probe
Vista previa

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

Propiedad Valor
Grupo de parámetros: App Customization Arguments
Valores aceptados: false, true
--env

Variables de entorno separadas por espacios en formato "key[=value]".

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

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

Propiedad Valor
Grupo de parámetros: App Customization Arguments
--instance-count

Número de instancias.

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

Propiedad Valor
Grupo de parámetros: Custom Container Arguments
--liveness-probe-config
Vista previa

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

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

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

Propiedad Valor
Grupo de parámetros: StandardGen2 Arguments
Valor predeterminado: 1
--no-wait

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

Propiedad Valor
Valor predeterminado: False
--readiness-probe-config
Vista previa

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

Propiedad Valor
Grupo de parámetros: App Customization Arguments
--registry-password

Contraseña del registro de contenedor.

Propiedad Valor
Grupo de parámetros: Custom Container Arguments
--registry-username

El nombre de usuario del registro de contenedor.

Propiedad Valor
Grupo de parámetros: Custom Container Arguments
--runtime-version

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

Propiedad Valor
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 <triggerParameter>=<secretRef> y separados por espacio.

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

Propiedad Valor
Grupo de parámetros: StandardGen2 Arguments
--scale-rule-metadata --srm

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

Propiedad Valor
Grupo de parámetros: StandardGen2 Arguments
--scale-rule-name --srn

El nombre de la regla de escalado.

Propiedad Valor
Grupo de parámetros: StandardGen2 Arguments
--scale-rule-type --srt

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

Propiedad Valor
Grupo de parámetros: StandardGen2 Arguments
--server-version

(Solo niveles estándar y básicos) Versión del servidor tomcat. Para enumerar todas las versiones de servidor compatibles, 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.

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

Propiedad Valor
Grupo de parámetros: Source Code deploy Arguments
--startup-probe-config
Vista previa

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

Propiedad Valor
Grupo de parámetros: App Customization Arguments
--target-module

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

Propiedad Valor
Grupo de parámetros: Source Code deploy Arguments
--version

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

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

Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "spring" está en desuso y se quitará en una versión futura.

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

--no-wait

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

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

Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "spring" está en desuso y se quitará en una versión futura.

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

--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 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 spring app deployment generate-thread-dump

Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "spring" está en desuso y se quitará en una versión futura.

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

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

Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "spring" está en desuso y se quitará en una versión futura.

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

Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "spring" está en desuso y se quitará en una versión futura.

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

Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "spring" está en desuso y se quitará en una versión futura.

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

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

Propiedad Valor
Valor predeterminado: 60s
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