Tous les produits
Search
Centre de documentation

Serverless App Engine:Gérer les modèles de job

Dernière mise à jour :Aug 25, 2026

En créant un modèle de job dans SAE, vous pouvez exécuter des tâches automatiquement selon une planification périodique ou les déclencher manuellement en envoyant des requêtes HTTP/HTTPS. Une fois la tâche terminée, SAE libère rapidement ses ressources de calcul.

Cas d'utilisation

SAE Jobs convient aux scénarios asynchrones, hors ligne et peu sensibles à la latence.

  • Traitement piloté par le temps : par exemple, envoi de coupons promotionnels au début de chaque heure, mise à jour quotidienne des revenus ou actualisation quotidienne des comptes de tags et des données d'audience.

  • Traitement par lots de données : par exemple, génération de rapports statistiques mensuels ou mise à jour par lots des statuts des messages SMS ne nécessitant pas de résultats en temps réel.

  • Découplage asynchrone : par exemple, actualisation du statut d'une promotion, exécution asynchrone d'une requête hors ligne ou découplage de la logique métier interne.

  • CI/CD : libération immédiate des ressources de calcul après l'achèvement des tâches CI/CD.

Pour comparer SAE Jobs aux produits open source gérés par vos soins dans différents scénarios, consultez Cas d'utilisation.

Prérequis

Si vous utilisez un compte principal, vous devez activer Serverless App Engine et EventBridge et accorder les autorisations requises.

Si vous souhaitez utiliser un utilisateur RAM, vous devez d'abord effectuer les étapes suivantes :

  1. Utilisez votre compte principal pour activer EventBridge.

  2. Utilisez votre compte principal pour activer SAE Jobs et créez le rôle lié au service AliyunServiceRoleForEventBridgeSendToSAE comme indiqué dans la console.

  3. Utilisez votre compte principal pour accorder l'autorisation AliyunEventBridgeReadOnlyAccess à l'utilisateur RAM. Pour plus d'informations, consultez Accorder des autorisations à un utilisateur RAM.

Flux de travail

  1. Pour exécuter une tâche, vous devez d'abord créer un modèle de job.

  2. Les tâches sont déclenchées par une règle de planification ou par une requête HTTP/HTTPS. Chaque déclenchement génère une nouvelle tâche basée sur le modèle de job.

  3. SAE crée une nouvelle instance pour exécuter chaque tâche.

Créer un modèle de job

  1. Accédez à la page Modèles de job SAE. Dans la barre de navigation supérieure, sélectionnez une région et un namespace, puis cliquez sur Create job template.

  2. Sur la page Basic information, configurez les paramètres suivants et cliquez sur Next.

    Paramètre

    Description

    Nom du modèle de job

    Saisissez un nom personnalisé pour le modèle de job.

    Type de namespace

    Sélectionnez un namespace System-created ou Select an existing namespace.

    Méthode de déploiement de la tâche

    • Sélectionner le déploiement par image : cliquez sur Set image. Vous pouvez déployer votre application en utilisant une Demo image, une image provenant de My Alibaba Cloud images (à partir d'une instance ACR sous le même compte), Other Alibaba Cloud account's private images (à partir d'une instance ACR sous un autre compte) ou une Custom image (à partir d'une instance non-ACR). Vous pouvez également Use image from another job template. Le processus de création, de push et de pull d'une image est identique à celui du déploiement d'une application. Pour plus d'informations, consultez Déployer une application à l'aide d'une image.

    • Déploiement par package de code : cliquez sur Set code package for deployment. Sélectionnez un Stack language et un Code package type, puis téléchargez votre package de code et spécifiez son environnement d'exécution. Le processus de création et de téléchargement d'un package de code est identique à celui du déploiement d'une application. Pour plus d'informations, consultez Déployer une application à l'aide d'un package de code.

    • Script Shell : cliquez sur Configure shell script et reportez-vous à l'exemple sur la page pour configurer le script d'exécution de la tâche.

    Type d'instance

    • Default : offre des performances stables. Ces instances ne peuvent pas être préemptées ni expulsées, ce qui les rend adaptées aux scénarios nécessitant une haute performance en temps réel et une grande stabilité.

    • BestEffort : les performances peuvent fluctuer considérablement. Ces instances peuvent être préemptées et expulsées, ce qui les rend adaptées aux scénarios sans exigences strictes en matière de performance en temps réel et de stabilité.

    • BestEffort First : le système priorise la planification des instances BestEffort. Si une instance BestEffort est préemptée, le système bascule automatiquement vers une instance Default pour éviter l'interruption de la tâche.

    Spécifications d'une seule instance

    Spécifiez les spécifications CPU et mémoire pour une seule instance lors de l'exécution de la tâche.

    Nombre d'instances concurrentes

    Spécifiez le nombre d'instances qui doivent s'exécuter simultanément à tout moment donné.

  3. Sur la page Task settings, configurez les paramètres suivants et cliquez sur Next.

    Paramètre

    Description

    Type de tâche

    • Tâche périodique

      • Expression Cron : définit la planification de la tâche. Vous pouvez saisir manuellement une expression Cron ou cliquer sur Use generation tool pour en générer une de manière interactive.

    • Tâche ponctuelle (déclenchement HTTP/HTTPS)

      • Type de requête : sélectionnez le protocole de requête qui déclenche la tâche selon vos besoins : HTTP, HTTPS ou HTTP&HTTPS.

      • Méthode de requête : sélectionnez une ou plusieurs méthodes de requête qui déclenchent la tâche : GET, POST, PUT, PATCH, DELETE ou HEAD.

      • Configuration de sécurité : sélectionnez une méthode de configuration de sécurité dans la liste déroulante. Les options suivantes sont disponibles :

        • No configuration : aucune configuration de sécurité n'est requise. Toutes les requêtes URL reçues sont converties en événements et poussées vers EventBridge.

        • Secure domain : saisissez les noms de domaine sécurisés. Seules les requêtes URL provenant de ces domaines sont converties en événements et poussées vers EventBridge. Toutes les autres requêtes sont filtrées.

        • IP range : saisissez une adresse IP ou un bloc CIDR. Seules les requêtes URL provenant de l'adresse IP ou du bloc CIDR spécifié sont converties en événements et poussées vers EventBridge. Toutes les autres requêtes sont filtrées.

    Politique de concurrence

    Développez More settings et sélectionnez une politique de concurrence.

    • Allow : permet l'exécution simultanée des tâches. Le déclencheur planifié crée continuellement de nouvelles tâches.

    • Forbid : interdit l'exécution simultanée des tâches. Une nouvelle tâche n'est pas créée si la tâche précédente n'est pas encore terminée.

    • Replace : si la tâche précédente n'est pas encore terminée, la nouvelle tâche la remplace.

    Délai d'expiration

    Spécifiez la durée d'exécution maximale d'une tâche. Si la tâche dépasse ce délai, le système tente de la terminer. La valeur doit être comprise entre [0, 604800], mesurée en secondes. La valeur par défaut est 3 600.

    Nombre de tentatives

    Spécifiez le nombre de tentatives pour une tâche ayant échoué. La valeur doit être comprise entre [0, 10]. La valeur par défaut est 3.

    Activer le sharding de tâche

    Activez l'option Enable Task Sharding, puis cliquez sur Edit task sharding name pour configurer les paramètres dans le panneau Edit task sharding name. Cette fonction est souvent utilisée pour les charges de travail Big Data afin de distribuer uniformément les shards entre plusieurs clients pour exécution.

  4. (Facultatif) Sur la page Advanced settings, configurez des fonctionnalités supplémentaires selon vos besoins. Les descriptions suivantes utilisent la méthode de déploiement par image comme exemple.

    • Commande de démarrage

      La commande de démarrage de l'application est définie par CMD ou ENTRYPOINT dans l'image et ne nécessite aucune configuration supplémentaire dans SAE. Si vous avez des exigences particulières, vous pouvez définir une commande de démarrage pour remplacer celle de l'image.

    • Environnement d'exécution et gestion du cycle de vie

    • Persistance des données

      Stockez les données de l'application dans NAS, OSS ou une base de données pour éviter la perte de données lorsque vous modifiez ou arrêtez l'application. Remarque : NAS, OSS et les bases de données sont facturés séparément.

    • Journaux

      Vous pouvez envoyer les journaux vers SLS pour une gestion et une analyse centralisées. Remarque : SLS est facturé séparément.

  5. Cliquez sur Create et attendez que le modèle de job soit créé.

  6. Pour afficher le modèle de job créé, accédez à la page Modèles de job SAE. Dans la barre de navigation supérieure, sélectionnez la région et le namespace cibles. Cliquez sur le modèle de job cible pour ouvrir sa page de détails.

Exécuter et arrêter des Jobs

Exécuter une tâche périodique

Une tâche périodique s'exécute automatiquement en fonction de l'expression Cron que vous avez définie lors de la création du modèle de job.

Exécuter une tâche ponctuelle

Une tâche ponctuelle peut être déclenchée par une requête HTTP ou HTTPS. Le protocole et la méthode de la requête dépendent de la configuration que vous avez définie dans le modèle de job.

  1. Accédez à la page Modèles de job SAE. Dans la barre de navigation supérieure, sélectionnez la région et le namespace cibles, puis cliquez sur le modèle de job cible pour ouvrir sa page de détails.

  2. Dans la section Job Settings, obtenez l'URL de requête publique ou l'URL de requête interne. Si vous effectuez une requête depuis Internet public, utilisez l'URL de requête publique.

  3. Déclenchez la tâche en envoyant une requête. Vous pouvez configurer la méthode POST pour transmettre des paramètres spécifiques dans le corps de la requête au format JSON. Pour plus de détails sur les paramètres, consultez ExecJob.

    • Exemple 1 : spécifier des variables d'environnement dans l'appel.

      curl -d '{"Envs":[{"name":"aaa","value":"bbb"},{"name":"ccc","value":"ddd"}]}' -H 'Content-Type: application/json' <url> # Note: Replace <url> with the actual URL.
    • Exemple 2 : spécifier le nombre d'instances concurrentes dans l'appel.

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

Exécuter un Job manuellement

  1. Accédez à la page Modèles de job SAE. Dans la barre de navigation supérieure, sélectionnez la région et le namespace cibles, puis cliquez sur le modèle de job cible pour ouvrir sa page de détails.

  2. Sur la page Job Template Details, cliquez sur Run job manually dans le coin supérieur droit.

Arrêter un Job

  1. Accédez à la page Modèles de job SAE. Dans la barre de navigation supérieure, sélectionnez la région et le namespace cibles, puis cliquez sur le modèle de job cible pour ouvrir sa page de détails.

  2. Sur la page Job Template Details, cliquez sur Stop job dans le coin supérieur droit et suivez les instructions à l'écran.

Gérer l'historique des tâches

  1. Accédez à la page Modèles de job SAE. Dans la barre de navigation supérieure, sélectionnez la région et le namespace cibles, puis cliquez sur le modèle de job cible pour ouvrir sa page de détails.

  2. Dans le volet de navigation de gauche, cliquez sur Task history. Sur la page Task history, affichez le statut d'exécution de la tâche et effectuez les actions nécessaires.

    • Pour supprimer une tâche, cliquez sur Delete dans la colonne Actions et suivez les instructions à l'écran.

    • Pour afficher les détails, cliquez sur un ID de tâche pour ouvrir la page Task record details et afficher le statut de l'instance.

Afficher les événements de tâche

  1. Accédez à la page Modèles de job SAE. Dans la barre de navigation supérieure, sélectionnez la région et le namespace cibles, puis cliquez sur le modèle de job cible pour ouvrir sa page de détails.

  2. Dans le volet de navigation de gauche, cliquez sur Event information. Dans la zone de recherche en haut, vous pouvez rechercher des événements par Source Name, Reason, Source Type ou Severity.

Modifier et supprimer un modèle de job

  1. Accédez à la page Modèles de job SAE. Dans la barre de navigation supérieure, sélectionnez la région et le namespace cibles, puis cliquez sur le modèle de job cible pour ouvrir sa page de détails.

  2. Dans le coin supérieur droit, cliquez sur Edit job template ou Delete job template et suivez les instructions à l'écran.

Avertissement

Lorsque vous supprimez un modèle de job, le système supprime toutes les instances de tâche créées à partir de ce modèle, y compris les informations de création du modèle. Il supprime également le projet SLS associé acheté en votre nom et désactive la fonctionnalité de collecte de journaux.

Restaurer une version

Si un modèle de job modifié cause des problèmes, vous pouvez le restaurer vers une version historique.

  1. Accédez à la page Modèles de job SAE. Dans la barre de navigation supérieure, sélectionnez la région et le namespace cibles, puis cliquez sur le modèle de job cible pour ouvrir sa page de détails.

  2. Dans le coin supérieur droit, cliquez sur Roll back to historical version.

  3. Sur la page Roll back to historical version, sélectionnez la version souhaitée et cliquez sur OK.