函数实例生命周期回调

调用代码

配置调用代码类型的回调程序后，函数实例启动或停止时，系统会向您的函数发送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实现方式。

函数计算控制台目前预置了/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，不会重新执行，系统会返回相关错误。