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

Contexto

Ao implementar e configurar um hook de ciclo de vida da instância, o Function Compute invoca o hook correspondente quando ocorre um evento específico do ciclo de vida. O runtime PHP oferece suporte a dois hooks de ciclo de vida da instância: Initializer e PreStop. Para obter mais informações, consulte Configurar ciclos de vida da instância.

As regras de faturamento para um hook de ciclo de vida da instância são as mesmas aplicadas a uma invocação de solicitação comum. No entanto, você pode consultar os logs de execução apenas em Real-time Logs, Function Logs ou Advanced Logs. A invocation request list não exibe logs para esses hooks. Para mais detalhes, consulte Visualizar logs de hooks de ciclo de vida da instância.

Hook Initializer

Exemplo de Initializer

O hook Initializer é executado após o início de uma instância de função, mas antes da execução do handler. O Function Compute garante que o hook Initializer seja executado com sucesso no máximo uma vez durante o ciclo de vida da instância da função. Se o hook Initializer falhar na primeira tentativa, a invocação da função falha imediatamente. Na próxima invocação, o sistema cria uma nova instância de função e executa o hook novamente.

O hook Initializer aceita um único parâmetro de entrada, $context, idêntico ao parâmetro de contexto em um handler.

A seguir, apresentamos um hook Initializer mínimo.

<?php
function my_initializer($context) {
    $logger = $GLOBALS['fcLogger'];
    $logger->info("hello world");
}
?>            

my_initializer é o nome do método do hook Initializer. Esse nome deve corresponder ao valor definido para o Initializer Hook no console do Function Compute. Por exemplo, se você configurar o Initializer Hook como main.my_initializer para sua função, o Function Compute carregará e executará o método my_initializer definido no arquivo main.php.

Assinatura do método

• Este hook aceita um único parâmetro de entrada, context, idêntico ao objeto context do handler.

• Os campos initializer e initializationTimeout no objeto context foram projetados para o hook Initializer. Caso utilize o recurso Initializer, esses campos assumem os valores configurados em Initializer Hook e Initializer Hook Timeout Period para a função. Caso contrário, permanecem vazios e são ignorados.

• Este hook não possui valor de retorno.

Hook PreStop

O hook PreStop é executado antes da destruição de uma instância de função. Ele possui a mesma assinatura de método que o hook Initializer.

<?php

$counter = 0;
function preStop($context) {
    $GLOBALS['fcLogger']->info("preStop ok");
}

function handler($event, $context) {
    global $counter;
    $counter += 2;
    return $counter;
}
?>

<funcName> AND <ServiceName> AND qualifier: <VERSION>

Configurar hooks de ciclo de vida

Configuração no console

edition: 3.0.0
name: fcDeployApp
access: "default"

vars: # Global variables
  region: "cn-hangzhou"

resources:
  hello_world:
    component: fc3 # Component name
    props:
      region: ${vars.region}              # For more information about how to use variables, see: https://docs.serverless-devs.com/serverless-devs/yaml#%E5%8F%98%E9%87%8F%E8%B5%8B%E5%80%BC
      functionName: "testphp"
      description: 'this is a test'
      runtime: "php7.2"
      code: ./
      handler: index.handler
      memorySize: 128
      timeout: 30
      instanceLifecycleConfig:      # Instance lifecycle hooks
        initializer:                # Initializer hook
          handler: index.my_initializer 
          timeout: 60     
        preStop:                    # PreStop hook
          handler: index.preStop    # Function handler
          timeout: 60               # Timeout
 

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

Visualize os logs dos hooks de ciclo de vida em Logs.

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 a função desejada.

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

   Na aba Logs, visualize os logs de invocação da função e os logs do Initializer. Exemplo:

   2024-03-04 17:57:28FC Initialize Start RequestId: 1-65e59b07-1520da26-bf73bbb91b69
   2024-03-04 17:57:282024-03-04 09:57:28.192 1-65e59b07-1520da26-bf73bbb91b69 [info] initializer
   2024-03-04 17:57:28FC Initialize End RequestId: 1-65e59b07-1520da26-bf73bbb91b69
   2024-03-04 17:57:28FC Invoke Start RequestId: 1-65e59b07-1520da26-bf73bbb91b69
   2024-03-04 17:57:28FC Invoke End RequestId: 1-65e59b07-1520da26-bf73bbb91b69

   Como cada instância de função permanece em cache por um período e não é destruída imediatamente, não é possível visualizar os logs dos hooks PreStop instantaneamente. Para acionar rapidamente um hook PreStop, atualize as configurações ou o código da função. Após concluir a atualização, visualize os logs dos hooks PreStop em Function Logs. O código de amostra a seguir mostra um exemplo:

   2024-03-04 18:33:26FC PreStop Start RequestId: 93c93603-9fbe-4576-9458-193c8b213031
   2024-03-04 18:33:262024-03-04 10:33:26.077 93c93603-9fbe-4576-9458-193c8b213031 [info] preStop
   2024-03-04 18:33:26FC PreStop End RequestId: 93c93603-9fbe-4576-9458-193c8b213031

Programa de exemplo

O Function Compute disponibiliza um projeto de exemplo MySQL que utiliza os hooks Initializer e PreStop. Neste exemplo, o hook Initializer lê a configuração do banco de dados MySQL a partir de variáveis de ambiente, cria uma conexão MySQL e testa sua conectividade. Já o hook PreStop encerra a conexão MySQL. Para mais informações, consulte php72-mysql.