Todos los productos
Search
Centro de documentos

Serverless App Engine:Gestionar plantillas de trabajo

Última actualización: Sep 05, 2026

Al crear una plantilla de trabajo en SAE, puede ejecutar tareas automáticamente según una programación periódica o activarlas manualmente mediante solicitudes HTTP/HTTPS. Una vez que finaliza una tarea, SAE libera rápidamente sus recursos de cómputo.

Casos de uso

Los Jobs de SAE son adecuados para escenarios asíncronos, sin conexión y no sensibles a la latencia.

  • Procesamiento basado en tiempo: por ejemplo, enviar cupones promocionales al inicio de cada hora, actualizar los ingresos diarios o renovar los recuentos de etiquetas y los datos de audiencia diariamente.

  • Procesamiento de datos por lotes: por ejemplo, generar informes estadísticos mensuales o actualizar estados de mensajes SMS en lotes que no requieren resultados en tiempo real.

  • Desacoplamiento asíncrono: por ejemplo, actualizar el estado de una promoción, ejecutar una consulta sin conexión de forma asíncrona o desacoplar procesos de la lógica interna del negocio.

  • CI/CD: liberación inmediata de recursos de cómputo tras completar una tarea de CI/CD.

Para consultar una comparación entre los Jobs de SAE y productos de código abierto autogestionados en distintos escenarios, consulte Use cases.

Requisitos previos

Si utiliza una cuenta principal, debe activar Serverless App Engine y EventBridge, además de otorgar los permisos necesarios.

Si desea utilizar un usuario RAM, primero debe completar los siguientes pasos:

  1. Utilice su cuenta principal para activar EventBridge.

  2. Utilice su cuenta principal para activar los Jobs de SAE y cree el rol vinculado al servicio AliyunServiceRoleForEventBridgeSendToSAE según las indicaciones de la consola.

  3. Utilice su cuenta principal para otorgar el permiso AliyunEventBridgeReadOnlyAccess al usuario RAM. Para obtener más información, consulte Grant permissions to a RAM user.

Flujo de trabajo

  1. Para ejecutar una tarea, primero debe crear una plantilla de trabajo.

  2. Las tareas se activan mediante una regla de programación o una solicitud HTTP/HTTPS. Cada activación genera una nueva tarea basada en la plantilla de trabajo.

  3. SAE crea una nueva instancia para ejecutar cada tarea.

Crear una plantilla de trabajo

  1. Vaya a la página de Plantillas de trabajo de SAE. En la barra de navegación superior, seleccione una región y un namespace, y luego haga clic en Create job template.

  2. En la página Basic information, configure los siguientes parámetros y haga clic en Next.

    Parámetro

    Descripción

    Job template name

    Introduzca un nombre personalizado para la plantilla de trabajo.

    Namespace type

    Seleccione un namespace System-created o bien Select an existing namespace.

    Task deployment method

    • Select image deployment: haga clic en Set image. Puede desplegar su aplicación mediante una Demo image, una imagen de My Alibaba Cloud images (de una instancia de ACR en la misma cuenta), Other Alibaba Cloud account's private images (de una instancia de ACR en otra cuenta) o una Custom image (de una instancia que no sea de ACR). También puede Use image from another job template. El proceso de creación, envío y descarga de una imagen es el mismo que para desplegar una aplicación. Para obtener más información, consulte Deploy an application by using an image.

    • Code package deployment: haga clic en Set code package for deployment. Seleccione un Stack language y un Code package type; después, cargue su paquete de código y especifique su entorno de ejecución. El proceso de creación y carga de un paquete de código es el mismo que para desplegar una aplicación. Para obtener más información, consulte Deploy an application by using a code package.

    • Shell script: haga clic en Configure shell script y consulte el ejemplo de la página para configurar el script de ejecución de la tarea.

    Instance type

    • Default: ofrece un rendimiento estable. Estas instancias no pueden ser apropiadas ni desalojadas, por lo que son adecuadas para escenarios que requieren alta estabilidad y rendimiento en tiempo real.

    • BestEffort: el rendimiento puede fluctuar significativamente. Estas instancias pueden ser apropiadas y desalojadas, lo que las hace aptas para escenarios sin requisitos estrictos de rendimiento en tiempo real ni estabilidad.

    • BestEffort First: el sistema prioriza la programación de instancias BestEffort. Si una instancia BestEffort es apropiada, el sistema recurre automáticamente a una instancia Default para evitar la interrupción de la tarea.

    Single instance specifications

    Especifique las especificaciones de CPU y memoria para una sola instancia durante la ejecución de la tarea.

    Number of concurrent instances

    Especifique el número de instancias que deben ejecutarse simultáneamente en un momento dado.

  3. En la página Task settings, configure los siguientes parámetros y haga clic en Next.

    Parámetro

    Descripción

    Task type

    • Periodic task

      • Cron expression: define la programación de la tarea. Puede introducir manualmente una Cron expression o hacer clic en Use generation tool para generarla de forma interactiva.

    • One-time task (HTTP/HTTPS trigger)

      • Request type: seleccione el protocolo de solicitud que activa la tarea según sus necesidades: HTTP, HTTPS o HTTP&HTTPS.

      • Request method: seleccione uno o varios métodos de solicitud que activen la tarea: GET, POST, PUT, PATCH, DELETE o HEAD.

      • Security configuration: seleccione un método de configuración de seguridad en la lista desplegable. Las opciones disponibles son:

        • No configuration: no se requiere configuración de seguridad. Todas las solicitudes URL recibidas se convierten en eventos y se envían a EventBridge.

        • Secure domain: introduzca los nombres de dominio seguros. Solo las solicitudes URL provenientes de estos dominios se convierten en eventos y se envían a EventBridge. El resto de las solicitudes se filtran.

        • IP range: introduzca una dirección IP o un bloque CIDR. Solo las solicitudes URL provenientes de la dirección IP o el bloque CIDR especificados se convierten en eventos y se envían a EventBridge. El resto de las solicitudes se filtran.

    Concurrency policy

    Expanda More settings y seleccione una directiva de concurrencia.

    • Allow: permite que las tareas se ejecuten simultáneamente. La activación programada crea nuevas tareas de forma continua.

    • Forbid: prohíbe que las tareas se ejecuten simultáneamente. No se crea una nueva tarea si la anterior aún no ha finalizado.

    • Replace: si la tarea anterior aún no ha finalizado, la nueva tarea la reemplaza.

    Timeout period

    Especifique el tiempo máximo de ejecución de una tarea. Si la tarea supera este límite, el sistema intenta finalizarla. El valor debe estar en el rango [0, 604800], medido en segundos. El valor predeterminado es 3600.

    Number of retries

    Especifique el número de veces que se debe reintentar una tarea con errores. El valor debe estar en el rango [0, 10]. El valor predeterminado es 3.

    Enable task sharding

    Active el interruptor Enable Task Sharding y luego haga clic en Edit task sharding name para ajustar la configuración en el panel Edit task sharding name. Esta opción se utiliza frecuentemente en cargas de trabajo de big data para distribuir shards equitativamente entre varios clientes y ejecutarlos.

  4. (Opcional) En la página Advanced settings, configure funciones adicionales según sus necesidades. Las siguientes descripciones toman como ejemplo el método de despliegue por imagen.

    • Comando de inicio

      El comando de inicio de la aplicación se define mediante CMD o ENTRYPOINT en la imagen y no requiere configuración adicional en SAE. Si tiene requisitos especiales, puede set a startup command para anular el comando definido en la imagen.

    • Entorno de ejecución y gestión del ciclo de vida

    • Persistencia de datos

      Almacene los datos de la aplicación en NAS, OSS o una database para evitar la pérdida de información al modificar o detener la aplicación. Nota: NAS, OSS y las bases de datos se facturan por separado.

    • Registros

      Puede enviar registros a SLS para su gestión y análisis centralizados. Nota: SLS se factura por separado.

  5. Haga clic en Create y espere a que se cree la plantilla de trabajo.

  6. Para ver la plantilla de trabajo creada, vaya a la página de Plantillas de trabajo de SAE. En la barra de navegación superior, seleccione la región y el namespace de destino. Haga clic en la plantilla de trabajo deseada para abrir su página de detalles.

Ejecutar y detener Jobs

Ejecutar una tarea periódica

Una tarea periódica se ejecuta automáticamente según la expresión Cron que configuró al crear la plantilla de trabajo.

Ejecutar una tarea única

Una tarea única puede activarse mediante una solicitud HTTP o HTTPS. El protocolo y el método de la solicitud dependen de la configuración establecida en la plantilla de trabajo.

  1. Vaya a la página de Plantillas de trabajo de SAE. En la barra de navegación superior, seleccione la región y el namespace de destino, y luego haga clic en la plantilla de trabajo deseada para abrir su página de detalles.

  2. En la sección Job Settings, obtenga la public request URL o la internal request URL. Si realiza la solicitud desde la internet pública, utilice la public request URL.

  3. Active la tarea enviando una solicitud. Puede configurar el método POST para pasar parámetros específicos en el cuerpo de la solicitud en formato JSON. Para obtener detalles sobre los parámetros, consulte ExecJob.

    • Ejemplo 1: especificar variables de entorno en la llamada.

      curl -d '{"Envs":[{"name":"aaa","value":"bbb"},{"name":"ccc","value":"ddd"}]}' -H 'Content-Type: application/json' <url> # Note: Replace <url> with the actual URL.
    • Ejemplo 2: especificar el número de instancias simultáneas en la llamada.

      curl -d '{"Replicas":"3"}' -H 'Content-Type: application/json' <url> # Note: Replace <url> with the actual URL.

Ejecutar un Job manualmente

  1. Vaya a la página de Plantillas de trabajo de SAE. En la barra de navegación superior, seleccione la región y el namespace de destino, y luego haga clic en la plantilla de trabajo deseada para abrir su página de detalles.

  2. En la página Job Template Details, haga clic en Run job manually en la esquina superior derecha.

Detener un Job

  1. Vaya a la página de Plantillas de trabajo de SAE. En la barra de navegación superior, seleccione la región y el namespace de destino, y luego haga clic en la plantilla de trabajo deseada para abrir su página de detalles.

  2. En la página Job Template Details, haga clic en Stop job en la esquina superior derecha y siga las instrucciones en pantalla.

Gestionar el historial de tareas

  1. Vaya a la página de Plantillas de trabajo de SAE. En la barra de navegación superior, seleccione la región y el namespace de destino, y luego haga clic en la plantilla de trabajo deseada para abrir su página de detalles.

  2. En el panel de navegación izquierdo, haga clic en Task history. En la página Task history, consulte el estado de ejecución de la tarea y realice acciones según sea necesario.

    • Para eliminar una tarea, haga clic en Delete en la columna Actions y siga las instrucciones en pantalla.

    • Para ver los detalles, haga clic en un ID de tarea para abrir la página Task record details y consultar el estado de la instancia.

Ver eventos de tareas

  1. Vaya a la página de Plantillas de trabajo de SAE. En la barra de navegación superior, seleccione la región y el namespace de destino, y luego haga clic en la plantilla de trabajo deseada para abrir su página de detalles.

  2. En el panel de navegación izquierdo, haga clic en Event information. En el cuadro de búsqueda superior, puede buscar eventos por Source Name, Reason, Source Type o Severity.

Editar y eliminar una plantilla de trabajo

  1. Vaya a la página de Plantillas de trabajo de SAE. En la barra de navegación superior, seleccione la región y el namespace de destino, y luego haga clic en la plantilla de trabajo deseada para abrir su página de detalles.

  2. En la esquina superior derecha, haga clic en Edit job template o Delete job template y siga las instrucciones en pantalla.

Aviso

Al eliminar una plantilla de trabajo, el sistema borra todas las instancias de tareas creadas a partir de dicha plantilla, incluida la información de creación de la misma. También elimina el proyecto de SLS asociado que se adquirió en su nombre y deshabilita la función de recopilación de registros.

Revertir a una versión anterior

Si una plantilla de trabajo modificada causa problemas, puede revertirla a una versión histórica.

  1. Vaya a la página de Plantillas de trabajo de SAE. En la barra de navegación superior, seleccione la región y el namespace de destino, y luego haga clic en la plantilla de trabajo deseada para abrir su página de detalles.

  2. En la esquina superior derecha, haga clic en Roll back to historical version.

  3. En la página Roll back to historical version, seleccione la versión deseada y haga clic en OK.