Configurer les hooks de cycle de vie pour un contrôle précis des étapes clés du cycle de vie des instances de fonction - Function Compute

Function Compute appelle les hooks de cycle de vie lors d'événements spécifiques de l'instance. Vous pouvez ainsi exécuter du code d'initialisation et de nettoyage en dehors du handler. Le runtime C# prend en charge deux hooks : Initializer et PreStop. Pour plus d'informations sur la gestion du cycle de vie des instances, consultez Configurer le cycle de vie des instances.

Les hooks de cycle de vie sont facturés comme les invocations de fonction standard. Leurs journaux d'exécution apparaissent dans Function Logs , Real-time Logs et Advanced Logs , mais pas dans la liste des requêtes d'invocation.

Fonctionnement des hooks Initializer et PreStop

Initializer

Le hook Initializer s'exécute après le démarrage d'une instance de fonction, avant la première invocation du handler. Function Compute garantit une exécution unique durant la durée de vie de l'instance.

Si le hook Initializer échoue, l'invocation renvoie une erreur. Lors de l'invocation suivante, Function Compute crée une nouvelle instance et relance le hook Initializer.

Utilisez le hook Initializer pour les configurations uniques, telles que l'initialisation de clients SDK ou de connexions à une base de données. Function Compute réutilisant les instances chaudes entre les invocations, le code de configuration du hook Initializer ne s'exécute qu'une fois. Ses résultats restent disponibles pour tous les appels de handler ultérieurs sur cette même instance.

PreStop

Le hook PreStop s'exécute avant la destruction d'une instance de fonction. Utilisez-le pour vider les mémoires tampons, fermer les connexions ou libérer des ressources avant l'arrêt de l'instance.

Signature de méthode

Les hooks Initializer et PreStop partagent la même signature de méthode : un paramètre d'entrée IFcContext et aucune valeur de retour.

Méthode d'instance :

public void FunctionName(IFcContext context);

Méthode statique :

public static void FunctionName(IFcContext context);

Exemple

L'exemple suivant présente une classe implémentant les deux hooks ainsi qu'un stream handler.

using System;
using System.IO;
using System.Threading.Tasks;
using Aliyun.Serverless.Core;
using Microsoft.Extensions.Logging;

namespace Example
{
    public class Hello
    {
        public void Initialize(IFcContext context)
        {
            IFcLogger logger = context.Logger;
            logger.LogInformation("Initialize start");
            logger.LogInformation("Handle initializer: {0}", context.RequestId);
            logger.LogInformation("Initialize end");
        }

        public void PreStop(IFcContext context)
        {
            IFcLogger logger = context.Logger;
            logger.LogInformation("PreStop start");
            logger.LogInformation("Handle PreStop: {0}", context.RequestId);
            logger.LogInformation("PreStop end");
        }

        public async Task<Stream> StreamHandler(Stream input, IFcContext context)
        {
            IFcLogger logger = context.Logger;
            logger.LogInformation("Handle request: {0}", context.RequestId);

            MemoryStream copy = new MemoryStream();
            await input.CopyToAsync(copy);
            copy.Seek(0, SeekOrigin.Begin);
            return copy;
        }

        static void Main(string[] args){}
    }
}