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

メソッド署名

• 初期化フックは、関数インスタンスが開始された後、ハンドラが実行される前に呼び出されます。 Function Computeは、関数インスタンスのライフサイクル内で1回だけInitializerフックが正常に呼び出されるようにします。 Initializerフックの呼び出しに失敗した場合、ハンドラーが実行される前にInitializerフックが正常に呼び出されるまで、システムはInitializerフックを再試行します。 Initializerフックを繰り返し再試行できるようにするには、Initializerフックを適切に設定します。

• PreStopフックは、関数インスタンスが破棄される前に呼び出されます。

function(ctx context.Context)

ライフサイクルフックの実装

// Initializerフックを登録します。
fc.RegisterInitializerFunction(initialize)
// PreStopフックを登録します。
fc.RegisterPreStopFunction(preStop) 

package main

import (
    "context"
    "log"

    "github.com/aliyun/fc-runtime-go-sdk/fc"
    "github.com/aliyun/fc-runtime-go-sdk/fccontext"
)

func HandleRequest(ctx context.Context) (string, error) {
    return "hello world!", nil
}

func preStop(ctx context.Context) {
    log.Print("this is preStop handler")
    fctx, _ := fccontext.FromContext(ctx)
    fctx.GetLogger().Infof("context: %#v\n", fctx)
}

func initialize(ctx context.Context) {
    log.Print("this is initialize handler")
    fctx, _ := fccontext.FromContext(ctx)
    fctx.GetLogger().Infof("context: %#v\n", fctx)
}

func main() {
    fc.RegisterInitializerFunction(initialize)
    fc.RegisterPreStopFunction(preStop)
    fc.Start(HandleRequest)
}                

ライフサイクルフックの設定

Function Computeコンソールの使用

function Computeコンソールで関数のInitializerフックとPreStopフックを設定できます。 例：

詳細は、「インスタンスライフサイクルの設定」をご参照ください。

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

vars: # The global variables.
  region: cn-hangzhou # The region.

resources:
  helloworld: # The name of the service or module.
    component: fc3 # The name of the component.
    props: #  The properties of the component.
      region: ${vars.region} # The region.
      functionName: "golang-lifecycle-hook-demo"
      description: 'this is golang lifecycle'
      runtime: "go1"
      code: ./
      handler: main
      memorySize: 128
      timeout: 60
      instanceLifecycleConfig:                       # The extension function.
        preStop:                                     # The PreStop hook.
          handler: preStop # The function handler.
          timeout: 60 # The timeout period.
        initializer:
          handler: initialize
          timeout: 60

インスタンスライフサイクルフックのログを表示する

ライフサイクルフックのログは、[ログ] で表示できます。

1. Function Computeコンソールにログインします。 左側のナビゲーションウィンドウで、[関数] をクリックします。

2. 上部のナビゲーションバーで、リージョンを選択します。 [関数] ページで、管理する関数をクリックします。

3. 関数の詳細ページで、テスト機能タブをクリックします。テスト機能を選択し、ログ > 関数ログを選択します。

   [ログ] タブでは、関数呼び出しログとInitializerログを表示できます。 例：

   2024-03-04 17:57:28FC Initialize Start RequestId: 1-65e59b07-1520da26-bf73bbb91b69
   2024-03-04 17:57:282024-03-04 09:57:28.192 1-65e59b07-1520da26-bf73bbb91b69 [info] initializer
   2024-03-04 17:57:28FC Initialize End RequestId: 1-65e59b07-1520da26-bf73bbb91b69
   2024-03-04 17:57:28FC Invoke Start RequestId: 1-65e59b07-1520da26-bf73bbb91b69
   2024-03-04 17:57:28FC Invoke End RequestId: 1-65e59b07-1520da26-bf73bbb91b69 

   各関数インスタンスは一定期間キャッシュされ、すぐには破棄されません。PreStopフックのログをすぐに表示することはできません。 PreStopフックをすばやくトリガーするには、関数設定または関数コードを更新します。 更新が完了すると、関数ログでPreStopフックのログを表示できます。 次のサンプルコードは例を示しています。

   2024-03-04 18:33:26FC PreStop Start RequestId: 93c93603-9fbe-4576-9458-193c8b213031
   2024-03-04 18:33:262024-03-04 10:33:26.077 93c93603-9fbe-4576-9458-193c8b213031 [info] preStop
   2024-03-04 18:33:26FC PreStop End RequestId: 93c93603-9fbe-4576-9458-193c8b21303 1 

サンプルプログラム

Function Computeは、Initializerフックを呼び出すためのサンプルプログラムを提供します。 サンプルプログラムでは、GoランタイムでInitializerフックを使用してMySQL接続プールを初期化する方法の例を示します。 サンプルプログラムでは、関数の環境変数を使用してMySQLデータベースを構成します。 詳細については、s.yamlファイルをご参照ください。 Initializerフックは、環境変数からMySQLデータベースの構成を取得し、MySQL接続プールを作成してから接続をテストするために使用されます。

詳細については、go-initializer-mysqlをご参照ください。