Function Compute:関数インスタンスのライフサイクルフック

Initializer、PreFreeze、およびPreStopフックのメソッドシグネチャは、C# ランタイム環境で同じです。 シグネチャは、コンテキスト入力パラメータのみを含み、応答パラメータは含まない。 サンプルコード:

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){}
    }
}

次の例は、さまざまな種類のフックの形式を示しています。

• 初期化フック: HelloFcApp:: 例。Hello::Initialize

• PreFreezeフック: HelloFcApp:: 例こんにちは::PreFreeze

• PreStopフック: HelloFcApp:: 例こんにちは::PreStop

Serverless Devsを使用してライフサイクルフックを設定する場合は、Initializer、PreFreeze、およびPreStopフックをs.yamlファイルに追加する必要があります。

• 初期化フックの設定

  initializerフィールドとinitializationTimeoutフィールドをfunctionパラメーターに追加します。

• PreFreezeフックの設定

  handlerとtimeoutを含むinstanceLifecycleConfig.preFreezeフィールドをfunctionパラメーターに追加します。

• PreStopフックの設定

  handlerとtimeoutを含むinstanceLifecycleConfig.preStopフィールドをfunctionパラメーターに追加します。

サンプルコード:

edition: 1.0.0
name: hello-world  #  The name of the project.
access: default    #  The alias of the key.

vars: # The global variable.
  region: cn-shanghai # The ID of the region.
  service:
    name: fc-example
    description: 'fc example by serverless devs'

services:
  helloworld: # The name of the service or module.
    component: fc
    actions: # The custom execution logic.
      pre-deploy: # The operation before the deployment.
        - run: mvn package # The command to run.
          path: ./ # The path in which the command runs.
    props: # The property value of the component.
      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