Function Compute:Hooks del ciclo de vida de instancias

Contexto

El ciclo de vida de una instancia de función incluye los hooks Initializer y PreStop. Function Compute invoca el hook correspondiente cuando ocurre un evento relacionado con el ciclo de vida de la instancia.

Un hook Initializer tiene dos tipos: invoke code y execute instruction. Actualmente, solo las funciones aceleradas por GPU admiten el tipo de hook Initializer execute instruction. Para obtener más información, consulte Configure instance lifecycle.

Las reglas de facturación de los hooks del ciclo de vida de instancias son las mismas que aplican a las solicitudes de invocación normales.

Para obtener más información sobre los registros de los hooks, consulte View instance lifecycle hook logs.

Tipos de hooks

Los hooks Initializer admiten dos tipos de implementación. A continuación se comparan ambos.

Para un hook Initializer, solo puede configurar uno de estos dos tipos.

Implementar hooks

En las siguientes secciones se describe cómo implementar cada tipo de hook.

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)

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

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

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

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

Configurar hooks del ciclo de vida

1. Inicie sesión en la consola de Function Compute. En el panel de navegación izquierdo, elija Function Management > Functions.

2. En la barra de navegación superior, seleccione una región. En la página Functions, haga clic en la función de destino.

3. En la página de detalles de la función, haga clic en la pestaña Configuration. En la sección Instance Configuration, haga clic en Modify.

4. En el panel Instance Configuration, configure el hook Initializer. Active el interruptor Initializer hook y establezca Initializer timeout según sus necesidades de negocio. En este ejemplo, el tiempo de espera se establece en 300 segundos. Para hook type, seleccione uno de los siguientes tipos:

   • invoke code

     Una vez habilitado el hook, Function Compute envía una solicitud HTTP POST /initialize a la función cuando inicia la instancia. Su código de negocio debe responder a la solicitud y devolver el código de estado 200.

   • execute instruction

     El tipo execute instruction solo está disponible para funciones aceleradas por GPU.

     Seleccione execute instruction como tipo de hook y luego elija una instrucción de shell, como /bin/sh. Escriba el script de inicialización en el editor de código. Para ver un ejemplo completo, consulte Execute instruction (GPU-accelerated functions only).

5. (Opcional) Configure el hook PreStop. Active el interruptor PreStop hook y establezca PreStop timeout según sus necesidades de negocio. En este ejemplo, el tiempo de espera se establece en 3 segundos.

6. Haga clic en Deploy.

7. Compruebe que los hooks surtan efecto. Invoque la función, o actualice su configuración o código, para activar la creación y destrucción de instancias. Después, revise los registros de los hooks siguiendo las instrucciones de View instance lifecycle hook logs.

Consultar los registros de los hooks del ciclo de vida de instancias

Puede consultar los registros de ejecución de los hooks en Real-time Log, Function Logs o Advanced Logs. La lista Invocation Request List no muestra los registros de los hooks.

Utilice la función Function Logs para consultar los registros de los hooks.

1. Inicie sesión en la consola de Function Compute. En el panel de navegación izquierdo, elija Function Management > Functions.

2. En la barra de navegación superior, seleccione una región. En la página Functions, haga clic en la función de destino.

3. En la página de detalles de la función, haga clic en la pestaña Test, haga clic en Test Function y luego elija Logs > Function Logs.

   En la pestaña Function Logs puede consultar los registros de invocación y los registros del hook Initializer de la función. El siguiente ejemplo muestra dichos registros.

2024-06-26 10:59:23FC Initialize Start RequestId: 529eab23-9b3a-4ffc-88c8-9a686*******
2024-06-26 10:59:23FC Initialize End RequestId: 529eab23-9b3a-4ffc-88c8-9a686*******
2024-06-26 10:59:25FC Invoke Start RequestId: 1-667b840c-15c49df0-b7dc1*******
2024-06-26 10:59:25FC Invoke End RequestId: 1-667b840c-15c49df0-b7dc1*******

Cada instancia de función permanece en caché durante un periodo de tiempo y no se destruye de inmediato, por lo que los registros del hook PreStop no están disponibles al instante. Para activar rápidamente el hook PreStop, actualice la configuración o el código de la función. Una vez completada la actualización, vuelva a revisar Function Logs para consultar los registros del hook PreStop. El siguiente ejemplo muestra dichos registros.

2024-06-26 11:04:33FC PreStop Start RequestId: c4385899-f071-490e-a8b7-e33c5*******
2024-06-26 11:04:33FC PreStop End RequestId: c4385899-f071-490e-a8b7-e33c5*******

Códigos de error de los hooks