本文介紹Web Server模式的Custom Container Runtime實現函數實例生命周期回調的方法。

使用限制

非Web Server模式的Custom Container Runtime不支持Initializer、PreFreeze和PreStop三種回調。函數計算僅在客戶端主動取消請求時,向相關實例發送SIGTERM信號,如有需要,您可以在容器業務邏輯內自行捕獲SIGTERM信號。

回調方法

當您實現并配置函數實例生命周期回調后,函數計算將在相關實例生命周期事件發生時調用對應的回調程序。函數實例生命周期涉及Initializer、PreFreeze和PreStop三種回調。更多信息,請參見函數實例生命周期回調

下文介紹Initializer回調方法,PreFreeze和PreStop回調方法與之相同。

Path輸入請求期望的響應
(可選)POST /initialize

請求體:無。

請求頭:Common Request Headers。具體信息,請參見函數計算公共請求頭

響應體:函數Initializer的返回值。
StatusCode
  • 200:成功狀態。
  • 404:失敗狀態。
Python語言中關于initialize的示例代碼如下:
@app.route('/initialize', methods=['POST'])
def init_invoke():
    rid = request.headers.get(x-fc-request-id)
    print("FC Initialize Start RequestId: " + rid)
    # do your things
    print("FC Initialize End RequestId: " + rid)
    return "OK"
(可選)GET /pre-freeze響應體:函數PreFreeze的返回值。
StatusCode
  • 200:成功狀態。
  • 404:失敗狀態。
(可選)GET /pre-stop響應體:函數PreStop的返回值。
StatusCode
  • 200:成功狀態。
  • 404:失敗狀態。
如果您想在Custom Runtime中使用Initializer回調方法,您需要在您的HTTP Server中實現Path為/initialize和Method為POST的對應邏輯。示例代碼,請參見上表中關于initialize的示例代碼。
重要 創建的函數不設置Initializer時,無需實現/initialize。此時,即使HTTP Server實現了/initialize,代碼中的/initialize邏輯也無法被調用執行。