Function Compute:Kait siklus hidup instans

Invoke code

Setelah Anda mengonfigurasi kait invoke code, sistem mengirim permintaan HTTP ke fungsi Anda, seperti POST /initialize atau GET /pre-stop, ketika instans dimulai atau akan dihentikan. Anda harus menangani permintaan tersebut dalam kode aplikasi Anda.

Untuk menggunakan kait Initializer dalam custom image, server HTTP Anda harus mengimplementasikan logika untuk path /initialize dengan metode POST. Hal yang sama berlaku untuk kait PreStop, yang memerlukan logika untuk path /pre-stop dengan metode GET. Contoh kode berikut menunjukkan implementasi untuk runtime Python 3.10 kustom.

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)
    # lakukan tindakan Anda
    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)
    # lakukan tindakan Anda
    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)
    # lakukan tindakan Anda
    print("FC PreStop End RequestId: " + rid)
    return "OK"


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

Contoh sebelumnya menunjukkan inisialisasi yang berhasil. Contoh berikut menunjukkan bagaimana kait /initialize dapat gagal dalam Python.

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

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

Execute instruction

Kait execute instruction menjalankan perintah untuk menginisialisasi instans setelah dimulai. Anda dapat menggunakan shell apa pun yang didukung oleh lingkungan runtime fungsi, seperti /bin/bash, /bin/sh, /bin/csh, atau /bin/zsh.

Konsol Function Compute menyediakan dua opsi preset: /bin/bash dan /bin/sh. Topik ini menggunakan /bin/sh sebagai contoh.

#!/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

Kode keluar (exit code) 0 menunjukkan keberhasilan. Kode keluar lainnya menunjukkan kegagalan. Untuk membantu troubleshooting, Anda dapat menulis detail kesalahan ke standard error (stderr) dalam skrip. Misalnya, cuplikan berikut menunjukkan cara mengeluarkan detail kesalahan dan mengatur kode keluar menjadi 1 ketika permintaan curl gagal.

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

Invoke code

Execute instruction

Jika kode keluar bukan 0, instruksi gagal dan tidak dieksekusi ulang. Sistem kemudian mengembalikan kesalahan.