Function Compute:Hooks de ciclo de vida da instância

Informações básicas

O ciclo de vida de uma instância de função envolve os hooks Initializer e PreStop. O Function Compute invoca o hook correspondente quando ocorre um evento relacionado ao ciclo de vida da instância.

Existem dois tipos de hook Initializer: invoke code e execute instruction. Atualmente, apenas funções aceleradas por GPU suportam o tipo de hook Initializer execute instruction. Para mais informações, consulte Configure instance lifecycle.

As regras de faturamento para hooks de ciclo de vida da instância são as mesmas aplicadas a solicitações de invocação comuns.

Para mais detalhes sobre logs de hooks, consulte View instance lifecycle hook logs.

Tipos de hooks

Os hooks Initializer suportam dois tipos de implementação. A tabela a seguir os compara.

Configure apenas um dos dois tipos para um hook Initializer.

Implementar hooks

As seções a seguir descrevem como 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 de ciclo de vida

1. Faça login no console do Function Compute. No painel de navegação à esquerda, escolha Function Management > Functions.

2. Na barra de navegação superior, selecione uma região. Na página Functions, clique em na função desejada.

3. Na página de detalhes da função, clique em na aba Configuration. Na seção Instance Configuration, clique em Modify.

4. No painel Instance Configuration, configure o hook Initializer. Ative a chave Initializer hook e defina o Initializer timeout conforme suas necessidades de negócio. Neste exemplo, o tempo limite está definido como 300 segundos. Para hook type, selecione um dos seguintes tipos:

   • invoke code

     Ao ativar o hook, o Function Compute envia uma solicitação HTTP POST /initialize para a função quando a instância é iniciada. Seu código de negócio deve responder à solicitação e retornar o código de status 200.

   • execute instruction

     Este tipo de hook está disponível exclusivamente para funções aceleradas por GPU.

     Selecione execute instruction como tipo de hook e escolha uma instrução shell, como /bin/sh. No editor de código, escreva o script de inicialização. Para um exemplo completo, consulte Execute instruction (GPU-accelerated functions only).

5. (Opcional) Configure o hook PreStop. Ative a chave PreStop hook e defina o PreStop timeout conforme suas necessidades de negócio. Neste exemplo, o tempo limite está definido como 3 segundos.

6. Clique em Deploy.

7. Verifique se os hooks entraram em vigor. Invoque a função ou atualize a configuração ou o código dela para acionar a criação e a destruição da instância. Em seguida, verifique os logs dos hooks seguindo as instruções em View instance lifecycle hook logs.

Visualizar logs de hooks de ciclo de vida da instância

Consulte os logs de execução de hooks em Real-time Log, Function Logs ou Advanced Logs. A Invocation Request List não exibe logs de hooks.

Utilize o recurso Function Logs para visualizar os logs dos hooks.

1. Faça login no console do Function Compute. No painel de navegação à esquerda, escolha Function Management > Functions.

2. Na barra de navegação superior, selecione uma região. Na página Functions, clique em na função desejada.

3. Na página de detalhes da função, clique em na aba Test, clique em Test Function e escolha Logs > Function Logs.

   Na aba Function Logs, visualize os logs de invocação e os logs do hook Initializer da função. O exemplo a seguir mostra os logs.

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*******

Como cada instância de função permanece em cache por um período e não é destruída imediatamente, os logs do hook PreStop não ficam disponíveis instantaneamente. Para acionar o hook PreStop rapidamente, atualize a configuração ou o código da função. Após concluir a atualização, verifique novamente os Function Logs para visualizar os logs do hook PreStop. O exemplo a seguir mostra os logs.

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 erro de hooks