Function Compute：函數執行個體生命週期回調方法

C#的Initializer回調、PreFreeze回調和PreStop回調方法簽名相同，均只有一個Context輸入參數，沒有返回參數。定義如下。

public void FunctionName(IFcContext context);

您也可以將回調方法設定為靜態方法，定義如下。

public static void FunctionName(IFcContext context);

以下範例程式碼展示一個簡單的包含Initializer回調、PreFreeze回調和PreStop回調的程式。

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 void PreFreeze(IFcContext context)
        {
            IFcLogger logger = context.Logger;
            logger.LogInformation("PreFreeze start");
            logger.LogInformation("Handle PreFreeze: {0}", context.RequestId);
            logger.LogInformation("PreFreeze 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){}
    }
}

樣本如下。

• Initializer回調程式：HelloFcApp::Example.Hello::Initialize

• PreFreeze回調程式：HelloFcApp::Example.Hello::PreFreeze

• PreStop回調程式：HelloFcApp::Example.Hello::PreStop

如果使用Serverless Devs工具，需要在s.yaml設定檔中添加Initializer回調程式、PreFreeze回調程式和PreStop回調程式。

• Initializer回調配置

  在function配置下添加initializer和initializationTimeout兩個欄位。

• PreFreeze回調配置

  在function配置下添加instanceLifecycleConfig.preFreeze欄位，包括handler和timeout兩個欄位。

• PreStop回調配置

  在function配置下添加instanceLifecycleConfig.preStop欄位，包括handler和timeout兩個欄位。

具體樣本如下所示。

edition: 1.0.0
name: hello-world  #  專案名稱
access: default    #  密鑰別名

vars: # 全域變數
  region: cn-shanghai # 地區
  service:
    name: fc-example
    description: 'fc example by serverless devs'

services:
  helloworld: # 業務名稱/模組名稱
    component: fc
    actions: # 自訂執行邏輯
      pre-deploy: # 在deploy之前運行
        - run: mvn package # 要啟動並執行命令列
          path: ./ # 命令列啟動並執行路徑
    props: #  組件的屬性值
      region: ${vars.region}
      service: ${vars.service}
      function:
        name: dotnet-lifecycle-hook-demo
        description: 'fc example by serverless devs'
        runtime: dotnetcore3.1
        codeUri: ./target
        handler: example.App::handleRequest
        memorySize: 128
        timeout: 60
        initializer: HelloFcApp::Example.Hello::Initialize
        initializationTimeout: 30
        instanceLifecycleConfig:
          preStop:
            Handler: HelloFcApp::Example.Hello::PreStop
            Timeout: 30
          preFreeze:
            Handler: HelloFcApp::Example.Hello::PreFreeze
            Timeout: 30