Function Compute:Kait siklus hidup instans

Invoke code

Setelah Anda mengonfigurasi kait bertipe invoke code, Function Compute mengirim permintaan HTTP POST /initialize atau GET /pre-stop ke fungsi Anda saat instans fungsi dimulai atau dihentikan. Anda harus merespons permintaan tersebut dalam kode bisnis Anda.

Kolom Path ditandai sebagai (Opsional) karena setiap kait merupakan konfigurasi opsional. Jika Anda tidak mengatur Initializer untuk fungsi yang Anda buat, Anda tidak perlu mengimplementasikan /initialize. Dalam kasus ini, meskipun server HTTP Anda mengimplementasikan /initialize, logika /initialize dalam kode Anda tidak akan pernah dipanggil. Hal yang sama berlaku untuk PreStop.

Untuk menggunakan metode kait Initializer dalam custom image, implementasikan logika untuk path /initialize dengan metode POST dalam server HTTP Anda. Hal yang sama berlaku untuk metode kait PreStop. Program contoh berikut menggunakan runtime kustom Python 3.10 sebagai contoh.

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)

Kode kait Anda juga dapat gagal saat runtime. Contoh /initialize berikut menunjukkan dua kegagalan khas dan cara Function Compute merespons masing-masing. Untuk perilaku sistem setiap kode kesalahan, lihat Hook error codes.

Pada contoh berikut, penanganan melemparkan exception. Function Compute memperlakukan kegagalan tersebut sebagai error 500 dan memulai ulang instans.

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

Pada contoh berikut, penanganan mengembalikan kode status 404. Function Compute tidak mengirim ulang permintaan.

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

Execute instruction (hanya untuk fungsi berakselerasi GPU)

Dengan jenis execute instruction, Function Compute menjalankan perintah shell atau skrip yang Anda konfigurasi setelah instans fungsi dimulai. Kode keluar 0 menunjukkan bahwa instruksi kait berhasil dijalankan. Kode keluar lainnya menunjukkan kegagalan.

Anda dapat menggunakan implementasi shell kustom, seperti /bin/bash, /bin/sh, /bin/csh, atau /bin/zsh. Pastikan lingkungan runtime fungsi mendukung implementasi shell yang Anda gunakan.

Konsol Function Compute menyediakan /bin/bash dan /bin/sh sebagai opsi prasetel. Contoh berikut menggunakan /bin/sh. Skrip ini melakukan pemeriksaan kesehatan inisialisasi: menggunakan curl untuk mengirim permintaan ke layanan lokal dan menggunakan jq untuk memformat output. Pastikan kedua alat tersebut tersedia di lingkungan runtime Anda.

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

Tulis informasi error ke standard error (stderr) dalam skrip Anda untuk membantu menemukan penyebab error. Misalnya, potongan kode berikut menulis informasi error saat permintaan curl gagal dan mengatur kode keluar menjadi 1. Perilaku kegagalan yang sama berlaku: jika instruksi mengembalikan kode keluar bukan nol, instruksi tidak dijalankan lagi dan sistem mengembalikan error terkait. Untuk informasi selengkapnya, lihat Hook error codes.

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 instruksi mengembalikan kode keluar bukan nol, instruksi tidak dijalankan lagi dan sistem mengembalikan error terkait. Jika skrip Anda menulis informasi error ke stderr, Anda dapat menggunakan output tersebut untuk menemukan penyebab kegagalan.