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

Initializer回調

初始化回調程式（Initializer回調）在函數執行個體啟動成功後，請求處理常式（Handler）之前執行。Function Compute保證在一個執行個體生命週期內，成功且只成功執行一次Initializer回調。如果您的Initializer回調第一次執行失敗，那麼此次函數調用直接返回失敗，下次調用時，會再建立一個函數執行個體執行initializer回調。

Initializer回調只有一個context輸入參數，使用方法和事件請求處理常式一樣。

一個最簡單的Initializer方法定義如下所示。

def initialize(context):
    print("initialize invoked")

initialize是Initializer回調方法名，需要與您在Function Compute控制台配置的Initializer回調程式一致。例如，您為函數配置的Initializer回調程式為index.initialize，那麼Function Compute在配置Initializer屬性後會去載入index.py中定義的initialize方法。

方法簽名

• 輸入參數只有context，為您的FC函數調用提供在調用時的運行上下文資訊。
• 無傳回值。

PreFreeze回調

預凍結回調程式（PreFreeze回調）在函數執行個體凍結前執行，方法簽名同Initializer回調。

一個簡單的PreFreeze方法定義如下所示。

def preFreeze(context):
    print("preFreeze invoked")

PreStop回調

預停止回調程式（PreStop回調）在函數執行個體銷毀前執行，方法簽名同Initializer回調。

一個最簡單的PreStop方法定義如下所示。

def preStop(context):
    print("preStop invoked")

配置生命週期回呼函數

通過控制台配置

您可以登入Function Compute控制台，為函數配置Initializer 回調程式、PreFreeze 回調程式和PreStop 回調程式。具體操作步驟，請參見函數執行個體生命週期。

回調程式的格式為[檔案名稱.方法名]。例如，Initializer 回調程式設定為index.initialize，表示index.py檔案中的initialize方法。

通過Serverless Devs工具配置

具體的樣本如下所示。

edition: 1.0.0          #  命令列YAML規範版本，遵循語義化版本（Semantic Versioning）規範
name: hello-world       #  專案名稱
access: default         #  密鑰別名

services:
  fc-deploy-test: # 模組名稱
    component: devsapp/fc  # 組件名稱
    props:                 # 組件的屬性值
      region: cn-hangzhou   # 地區
      service:             # 服務配置
        name: fc-deploy-service    # service名稱
        description: dem component # Service的簡短描述
      function:                       # 函數配置
        name: fc-base-service         # function名稱
        description: 'this is test'   # function的簡短描述
        codeUri: './code'             # 代碼位置
        handler: 'index.handler'      # function執行的入口，具體格式和語言相關
        memorySize: 128               # function的記憶體規格
        runtime: python3              # 運行時
        timeout: 60                   # function啟動並執行逾時時間
        initializationTimeout: 20     # 初始化方法逾時時間
        initializer: index.my_initializer # 初始化方法
        instanceLifecycleConfig:      # 擴充函數
          preStop:                    # PreStop 函數
            handler: index.preStop        # 函數入口
            timeout: 60               # 逾時時間

關於Serverless Devs的YAML配置規範，請參見Serverless Devs常用命令。

查看執行個體生命週期回呼函數日誌

您可以通過函數日誌功能查看回呼函數日誌。

1. 登入Function Compute控制台，在左側導覽列，單擊服務及函數。
2. 在頂部功能表列，選擇地區，然後在服務列表頁面，單擊目標服務。
3. 在函數管理頁面，單擊目標函數名稱，然後在函數詳情頁面，單擊測試函數頁簽。
4. 在測試函數頁簽，單擊測試函數，然後選擇調用日誌 > 函數日誌。
   在函數日誌頁簽，您可以查看函數的調用日誌、Initializer回調日誌和PreFreeze回調日誌，樣本如下。

   2022-10-09 19:26:17 FunctionCompute dotnetcore3.1 runtime inited.
   2022-10-09 19:26:17 FC Initialize Start RequestId: 793ad2f1-9826-4d9a-90d9-5bf39e******
   2022-10-09 19:26:17 2022-10-09 19:26:17 793ad2f1-9826-4d9a-90d9-5bf39e****** [INFO] Initialize start
   2022-10-09 19:26:17 2022-10-09 19:26:17 793ad2f1-9826-4d9a-90d9-5bf39e****** [INFO] Handle initializer: 793ad2f1-9826-4d9a-90d9-5bf39e******
   2022-10-09 19:26:17 2022-10-09 19:26:17 793ad2f1-9826-4d9a-90d9-5bf39e****** [INFO] Initialize end
   2022-10-09 19:26:17 FC Initialize End RequestId: 793ad2f1-9826-4d9a-90d9-5bf39e******
   2022-10-09 19:26:17 FC Invoke Start RequestId: 793ad2f1-9826-4d9a-90d9-5bf39e******
   2022-10-09 19:26:17 2022-10-09 19:26:17 793ad2f1-9826-4d9a-90d9-5bf39e****** [INFO] Handle request: 793ad2f1-9826-4d9a-90d9-5bf39e******
   2022-10-09 19:26:17 FC Invoke End RequestId: 793ad2f1-9826-4d9a-90d9-5bf39e******
   2022-10-09 19:26:17 FC PreFreeze Start RequestId: 793ad2f1-9826-4d9a-90d9-5bf39e******
   2022-10-09 19:26:17 2022-10-09 19:26:17 793ad2f1-9826-4d9a-90d9-5bf39e****** [INFO] PreFreeze start
   2022-10-09 19:26:17 2022-10-09 19:26:17 793ad2f1-9826-4d9a-90d9-5bf39e****** [INFO] Handle PreFreeze: 793ad2f1-9826-4d9a-90d9-5bf39e******
   2022-10-09 19:26:17 2022-10-09 19:26:17 793ad2f1-9826-4d9a-90d9-5bf39e****** [INFO] PreFreeze end
   2022-10-09 19:26:17 FC PreFreeze End RequestId: 793ad2f1-9826-4d9a-90d9-5bf39e******

   因為每個函數執行個體會緩衝一段時間，不會馬上銷毀，因此不能立即查看PreStop回調日誌。如需快速觸發PreStop回調，可更新函數配置或者函數代碼。更新完成後，再次查看函數日誌，您可以查看PreStop回調日誌。樣本如下。

   2022-10-09 19:32:17 FC PreStop Start RequestId: 03be685c-378b-4736-8b08-a67c1d*****
   2022-10-09 19:32:17 2022-10-09 19:32:17 03be685c-378b-4736-8b08-a67c1d***** [INFO] PreStop start
   2022-10-09 19:32:17 2022-10-09 19:32:17 03be685c-378b-4736-8b08-a67c1d***** [INFO] Handle PreStop: 03be685c-378b-4736-8b08-a67c1d*****
   2022-10-09 19:32:17 2022-10-09 19:32:17 03be685c-378b-4736-8b08-a67c1d***** [INFO] PreStop end
   2022-10-09 19:32:17 FC PreStop End RequestId: 03be685c-378b-4736-8b08-a67c1d*****

樣本程式

Function Compute為您提供了使用Initializer回調和PreStop回調的MySQL樣本程式。在本樣本中，Initializer回呼函數用於從環境變數中擷取MySQL資料庫配置，建立MySQL串連並測試連通性，PreStop回呼函數負責關閉MySQL串連。

詳細資料，請參見python3-mysql。