Function Compute:Configure verificações de integridade da instância

Contexto

Funções que usam runtime personalizado ou imagem de contêiner personalizada podem apresentar instabilidade ocasional e causar comportamento anormal na instância. Para evitar isso, configure verificações periódicas de integridade no Function Compute. Essa configuração impede o roteamento de requisições para instâncias não íntegras e evita falhas.

Limitações

As verificações de integridade têm suporte apenas para Web Function e funções GPU.

Funcionamento das verificações de integridade

Comportamento de inicialização da instância

Para obter instruções sobre como definir os parâmetros Threshold for Successful Detections e Maximum Failures, consulte Configure verificações de integridade no console.

Comportamento de uma única verificação de integridade

Agendamento após falha na verificação de integridade

Configure verificações de integridade no console

Esta seção explica como configurar as verificações de integridade para uma função. O exemplo utiliza uma Web Function com o Runtime Node.js 18.

Etapa 1: Crie uma função

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

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

3. Na página Create Function, selecione Web Function. Para Custom Runtime, selecione Custom Runtime. Em seguida, clique em Create.

4. Na página de detalhes da função, selecione a aba Code. Edite o código da função no editor de código e clique em Deploy.

   Veja abaixo o código de exemplo para index.js.

   'use strict';
   
   // Constants
   const PORT = 9000;
   const HOST = '0.0.0.0';
   const REQUEST_ID_HEADER = 'x-fc-request-id'
   
   const express = require('express');
   const bodyParser = require('body-parser');
   const app = express();
   
   app.use(bodyParser.urlencoded({ extended: true }));
   app.use(bodyParser.json());
   app.use(bodyParser.raw());
   
   app.get('/readyz', (req, res) => {
     console.log(`receive health check`);
     res.status(200);
     console.log(`i am ready`);
     res.send('i am ready\n');
   });
   
   // invocation
   app.post('/invoke', (req, res) => {
     var rid = req.headers[REQUEST_ID_HEADER]
     console.log(`FC Invoke Start RequestId: ${rid}`)
     res.send('OK');
     console.log(`FC Invoke End RequestId: ${rid}`)
   });
   
   var server = app.listen(PORT, HOST);
   console.log(`Running on http://${HOST}:${PORT}`);
   
   server.timeout = 0; // never timeout
   server.keepAliveTimeout = 0; // keepalive, never timeout

   No código acima, readyz atua como o handler de verificação de integridade. Ele processa requisições HTTP GET enviadas para o caminho /readyz. Após concluir a Etapa 2: Configure verificações de integridade para a instância da função, configure o Function Compute para executar periodicamente esse handler e verificar a integridade da instância.

   Quando o Function Compute identifica que sua instância de função não está íntegra, ele tenta rotear as requisições para outras instâncias íntegras. Se o Function Compute não conseguir realizar esse roteamento, ele retorna um erro relacionado à falha na verificação de integridade.

Etapa 2: Configure verificações de integridade

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

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

3. Na página de detalhes da função, selecione a aba Configuration. À direita de Advanced Settings, clique em Modify. No painel Advanced Settings, ative a opção Health Check, configure os parâmetros conforme descrito na tabela a seguir e clique em Deploy.

   Parâmetro	Descrição
   Request Path	Caminho para o qual o Function Compute envia uma requisição HTTP GET para verificar a integridade. O valor deve começar com /.
   Delay for First Detection	Atraso em segundos após a inicialização da instância antes da execução da primeira verificação de integridade.
   Detection Interval	Intervalo em segundos entre as verificações de integridade.
   Timeout Period	Tempo limite em segundos para receber uma resposta da verificação de integridade. Se nenhuma resposta for recebida dentro desse período, a verificação falha.
   Maximum Failures	Quantidade de falhas consecutivas nas verificações necessária para marcar a instância como não íntegra.
   Threshold for Successful Detections	Número de verificações bem-sucedidas consecutivas exigidas para que uma instância não íntegra seja marcada novamente como íntegra.

Etapa 3: Verifique a verificação de integridade

1. Na página de configuração da função, selecione a aba Code e clique em Test Function para visualizar o resultado.

   Com o código de exemplo da Etapa 1, a instância da função passa na verificação de integridade e retorna OK.

2. Substitua o handler de verificação de integridade no código pelo trecho abaixo. Clique em Deploy. Após a implantação do código, clique novamente em Test Function para conferir o resultado.

   O código modificado é apresentado a seguir:

   app.get('/readyz', (req, res) => {
     console.log(`receive health check`);
     res.status(500);
     console.log(`i am not ready`);
     res.send('i am not ready\n');
   });

   Agora, a verificação de integridade sempre falhará com um código de status 500. Ao invocar a função novamente, você receberá a seguinte resposta:

   {
       "RequestId": "1-65081d42-e4895cbc7d6252bda643****",
       "Code": "FunctionNotStarted",
       "Message": "The function http server cannot be started. check function health failed with status code: 500 "
   }

Mais informações