Administrar y usar trabajos en el plan de Azure Spring Apps Enterprise
Nota:
Los planes de Básico, Estándar y Enterprise quedarán en desuso a partir de mediados de marzo de 2025, con un período de retiro de 3 años. Se recomienda realizar la transición a Azure Container Apps. Para más información, consulte el anuncio de retirada de Azure Spring Apps.
El plan de consumo estándar y dedicado quedará obsoleto a partir del 30 de septiembre de 2024, con un cierre completo al cabo de seis meses. Se recomienda realizar la transición a Azure Container Apps. Para obtener más información, consulte Migrar el plan de consumo y dedicado Azure Spring Apps Standard a Azure Container Apps.
Este artículo se aplica a: ❎ Básico/Estándar ✅ Enterprise
En este artículo se muestra cómo administrar el ciclo de vida de un trabajo y ejecutarlo en el plan Azure Spring Apps Enterprise.
Requisitos previos
- Una instancia de plan de Azure Spring Apps Enterprise ya aprovisionada. Para más información, consulte Inicio rápido: Compilación e implementación de aplicaciones en Azure Spring Apps con el plan Enterprise.
Crear e implementar un trabajo
Use los comandos siguientes para crear e implementar un trabajo:
az spring job create --name <job-name>
az spring job deploy \
--name <job-name> \
--artifact-path <artifact-path>
Para la versión preliminar pública, puede crear un máximo de 10 trabajos por instancia de servicio.
Iniciar y cancelar una ejecución de trabajo
Utilice el comando siguiente para iniciar una ejecución de trabajo:
az spring job start --name <job-name>
Si el comando se ejecuta correctamente, devuelve el nombre de la ejecución del trabajo. Con el parámetro --wait-until-finished true, el comando no devuelve hasta que finaliza la ejecución del trabajo.
Para consultar el estado de la ejecución del trabajo, use el siguiente comando. Reemplace <execution-name> por el nombre que devolvió el comando de inicio.
az spring job execution show \
--job <job-name> \
--name <execution-name>
Para cancelar las ejecuciones de trabajos que se están ejecutando, use el siguiente comando:
az spring job execution cancel \
--job <job-name> \
--name <execution-name>
Historial de ejecuciones de trabajos de consulta
Para mostrar el historial de ejecución, use el siguiente comando:
az spring job execution list --job <job-name>
En la versión preliminar pública, los últimos 10 registros de ejecución de trabajos completados o con errores por trabajo se conservan en el historial.
Consulta de registros de ejecución de trabajos
Para obtener el historial de ejecuciones de trabajos en Azure Portal, use la siguiente consulta de Log Analytics:
AppPlatformLogsforSpring
| where AppName == '<job-name>' and InstanceName startswith '<execution-name>'
| order by TimeGenerated asc
Para obtener más información, consulte Inicio rápido: configurar un área de trabajo de Log Analytics.
Para los registros en tiempo real, use el siguiente comando de la línea de comandos:
az spring job logs \
--name <job-name> \
--execution <execution-name>
Si hay varias instancias para la ejecución del trabajo, especifique --instance <instance-name> para ver solo los registros de una instancia.
Volver a ejecutar el trabajo
Utilice el comando siguiente para desencadenar una nueva ejecución de trabajo:
az spring job start \
--name <job-name> \
--args <argument-value> \
--envs <key=value>
Integrar con componentes administrados
Para la versión preliminar pública, los trabajos se pueden integrar sin problemas con Spring Cloud Config Server para una administración de configuración eficaz y el registro de servicio de Tanzu para la detección de servicios.
Integrar con Spring Cloud Config Server
Con Spring Cloud Config Server, puede administrar las configuraciones o propiedades requeridas por un trabajo en repositorios de Git y, a continuación, cargarlas en el trabajo. Después de configurar las configuraciones del repositorio de Git para Spring Cloud Config Server, debe enlazar los trabajos al servidor.
Use el comando siguiente para enlazar el trabajo a Spring Cloud Config Server durante la creación del trabajo:
az spring job create \
--name <job-name> \
--bind-config-server true
Para los trabajos existentes, use el siguiente comando para enlazarlos a Spring Cloud Config Server:
az spring config-server bind --job <job-name>
Si ya no necesita Spring Cloud Config Server para los trabajos, puede desenlazarlos de él. Este cambio surte efecto en las nuevas ejecuciones de trabajos.
Use el comando siguiente para desenlazar un trabajo:
az spring config-server unbind --job <job-name>
Integrar con el registro de servicio de Tanzu
Es habitual que un trabajo llame a una API desde una aplicación de larga duración en colaboración para consultar información, notificaciones, etc. Para permitir que el trabajo detecte aplicaciones que se ejecutan en el mismo servicio Azure Spring Apps, puede enlazar las aplicaciones y los trabajos a un registro de servicio administrado. En la sección siguiente se describe cómo enlazar un trabajo al registro de servicio de Tanzu.
Use el comando siguiente para enlazar un trabajo al registro de servicio de Tanzu durante la creación del trabajo:
az spring job create --bind-service-registry true
Para los trabajos existentes, use el siguiente comando para enlazarlos al registro de servicio de Tanzu:
az spring service-registry bind --job <job-name>
Al ejecutar la ejecución del trabajo, puede acceder a los puntos de conexión de las aplicaciones registradas a través del registro de servicio.
Si ya no necesita el registro de servicio para los trabajos, puede desenlazarlos de él. Este cambio surte efecto en las nuevas ejecuciones de trabajos.
Use el comando siguiente para desenlazar el trabajo:
az spring service-registry unbind --job <job-name>