配置回呼函數對函數執行個體生命週期關鍵點進行精細化控制 - Function Compute

本文介紹Python如何?並應用函數執行個體生命週期回調方法。

背景資訊

當您實現並配置函數執行個體生命週期回調後，Function Compute將在相關執行個體生命週期事件發生時調用對應的回調程式。函數執行個體生命週期涉及Initializer和PreStop回調。更多資訊，請參見配置執行個體生命週期。

函數執行個體生命週期回調程式與正常調用請求計費規則一致，但其執行日誌只能在函數日誌、即時日誌或進階日誌中查詢，調用請求列表不會展示回調程式日誌。具體操作，請參見查看執行個體生命週期回呼函數日誌。

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函數調用提供在調用時的運行上下文資訊。
無傳回值。

PreStop回調

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

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

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

配置生命週期回呼函數

通過控制台配置

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

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

shengmingzhouqi

通過Serverless Devs工具配置

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

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

具體的樣本如下所示。

edition: 3.0.0
name: fcDeployApp
access: "default"

vars: # 全域變數
  region: "cn-hangzhou"

resources:
  hello_world:
    component: fc3 # 組件名稱
    props:
      region: ${vars.region}              # 關於變數的使用方法，可以參考：https://docs.serverless-devs.com/serverless-devs/yaml#%E5%8F%98%E9%87%8F%E8%B5%8B%E5%80%BC
      functionName: "emojipy"
      description: 'this is emoji'
      runtime: "python3"
      code: ./
      handler: index.handler
      memorySize: 128
      timeout: 30
      environmentVariables:
        PYTHONPATH: /code:/code/python:/opt/python
#     initializationTimeout: 20     # 初始化方法逾時時間
#     initializer: index.my_initializer # 初始化方法
      instanceLifecycleConfig:      # 擴充函數
        preStop:                    # PreStop函數
          handler: index.preStop    # 函數入口
          timeout: 60               # 逾時時間
        initializer:                # initializer函數
          handler: index.initialize
          timeout: 60

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

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

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

登入Function Compute控制台，在左側導覽列，單擊函數。
在頂部功能表列，選擇地區，然後在函數頁面，單擊目標函數。

在函數詳情頁面，選擇測試頁簽，單擊測試函數，然後選擇日誌 > 函數日誌。

在函數日誌頁簽，您可以查看函數的調用日誌和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-193c8b213031

樣本程式

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

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