Function Compute：函數執行個體生命週期回調

調用代碼

配置調用代碼類型的回調程式後，函數執行個體啟動或停止時，系統會向您的函數發送HTTP請求POST /initialize或GET /pre-stop，您需要在業務代碼中響應該請求。

如果您想在自訂鏡像使用Initializer回調方法，您需要在您的HTTP Server中實現Path為/initialize和Method為POST的對應邏輯，使用PreStop回調方法同理。本文以自訂運行時Python 3.10為例，具體樣本程式如下所示。

import os
from flask import Flask
from flask import request

app = Flask(__name__)

@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"

@app.route('/', defaults={'path': ''})
@app.route('/<path:path>', methods=['GET', 'POST', 'PUT', 'DELETE'])
def hello_world(path):
    rid = request.headers.get('x-fc-request-id')
    print("FC invoke Start RequestId: " + rid)
    # do your things
    print("FC invoke End RequestId: " + rid)
    return "Hello, World!", 200, [('Function-Name', os.getenv('FC_FUNCTION_NAME'))]


@app.route('/pre-stop', methods=['GET'])
def prestop_invoke():
    rid = request.headers.get('x-fc-request-id')
    print("FC PreStop Start RequestId: " + rid)
    # do your things
    print("FC PreStop End RequestId: " + rid)
    return "OK"


if __name__ == '__main__':
    app.run(host='0.0.0.0', port=9000)

除了上面正確的代碼程式，Python語言中還有函數執行報錯的情境，/initialize範例程式碼如下。

@app.route('/initialize', methods=['POST'])
def init():
    raise Exception("hahaha")
    return "OK", 200, []

@app.route('/initialize', methods=['POST'])
def init():
    return "OK", 404, []

執行指令

如果您希望函數執行個體啟動後，向函數發送HTTP請求來做一些初始化操作，可以通過配置回調指令來實現。支援使用者自訂Shell實現方式，例如/bin/bash 、 /bin/sh、/bin/csh和/bin/zsh等，需要確保函數運行時環境支援對應的Shell實現方式。

Function Compute控制台目前預置了/bin/bash 和 /bin/sh兩種方式，本文以/bin/sh方式為例，具體樣本程式如下。

#!/bin/sh

URL="http://localhost:7860"
REQUEST_PATH="sdapi/v1/txt2img"
JSON_DATA='{
	"prompt": "",
	"steps": 1,
	"height": 8,
	"width": 8
}'
temp_file=$(mktemp)
trap 'rm -f "$temp_file"' EXIT

if ! http_code=$(curl -s -w "%{http_code}" \
	-H "Content-Type: application/json" \
	-d "$JSON_DATA" \
	-o "$temp_file" \
	-X POST "$URL"/"$REQUEST_PATH"); then
	echo "{\"status\": \"curl_error\", \"code\": $curl_exit_code}" \
	| jq . >&2
	exit 1
fi

response=$(<"$temp_file")
echo "http code $http_code"

if [ "$http_code" -eq 200 ]; then
	echo "$response" | jq -r '.' || printf "%s\n" "$response"
	exit 0
else
	echo "$response_body" \
	| jq -c 'if type == "object" then . else {raw: .} end' 2>/dev/null \
	| jq -s '{status: "http_error", code: $code, response: .[0]}' \
		--arg code "$http_code" \
		>&2
	exit 1
fi

當回調指令退出碼為0時，表示執行成功，否則表示執行失敗。您可以在指令碼中適當將一些錯誤資訊輸出至標準錯誤（stderr）中，方便定位錯誤原因，例如下面程式碼片段表示curl請求執行失敗後，輸出相關錯誤資訊，並將退出碼置為1。

if ! http_code=$(curl -s -w "%{http_code}" \
	-H "Content-Type: application/json" \
	-d "$JSON_DATA" \
	-o "$temp_file" \
	-X POST "$URL"/"$REQUEST_PATH"); then
	echo "{\"status\": \"curl_error\", \"code\": $curl_exit_code}" \
	| jq . >&2
	exit 1
fi

調用代碼

執行指令

若指令退出碼為非0，不會重新執行，系統會返回相關錯誤。