Criar funções do Lambda com Node.js

Você pode executar o código JavaScript com Node.js noAWS Lambda. O Lambda fornece runtimes para Node.js que executam seu código para processar eventos. Seu código é executado em um ambiente que inclui o AWS SDK for JavaScript, com as credenciais de uma função do AWS Identity and Access Management (IAM) que você gerencia. Para saber mais sobre as versões do SDK incluídas nos runtimes do Node.js, consulte Versões do SDK incluídas no runtime.

O Lambda oferece suporte aos runtimes Node.js a seguir.

O console cria uma função do Lambda com um único arquivo de origem denominado index.js ou index.mjs. Você pode editar esse arquivo e adicionar mais arquivos no editor de códigos integrado. Para salvar suas alterações, selecione Salvar. Em seguida, para executar seu código, escolha Teste.

O arquivo index.js ou index.mjs exporta uma função denominada handler que assume um objeto de evento e um objeto de contexto. Esta é a função de manipulador que o Lambda chama quando a função é invocada. O runtime da função do Node.js recebe eventos de invocação do Lambda e os transmite ao manipulador. Na configuração da função, o valor do manipulador é index.handler.

Quando você salva seu código de função, o console do Lambda cria um pacote de implantação de arquivos .zip. Quando desenvolver o código de função fora do console (usando um IDE), você precisará criar um pacote de implantação para carregar o código na função do Lambda.

O runtime transmite um objeto de contexto para o manipulador, além do evento de invocação. O objeto de contexto contém informações adicionais sobre a invocação, a função e o ambiente de execução. Outras informações estão disponíveis de variáveis de ambiente.

Sua função do Lambda é fornecida com um grupo de logs do CloudWatch Logs. O runtime envia detalhes sobre cada invocação para o CloudWatch Logs. Ele retransmite quaisquer logs que sua função produz durante a invocação. Se a função retornar um erro, o Lambda formatará o erro e o retornará para o invocador.

Inicialização do Node.js

O Node.js tem um modelo de loop de eventos exclusivo que torna seu comportamento de inicialização diferente de outros runtimes. Especificamente, o Node.js utiliza um modelo de E/S sem bloqueio que oferece suporte a operações assíncronas. Esse modelo permite que o Node.js funcione de modo eficiente com a maioria das workloads. Por exemplo, se uma função Node.js fizer uma chamada de rede, a solicitação poderá ser designada como uma operação assíncrona e colocada em uma fila de retorno de chamada. A função poderá continuar processando outras operações dentro da pilha de chamadas principal sem ser bloqueada aguardando o retorno da chamada de rede. Após a chamada de rede ser concluída, o retorno de chamada é executado e, em seguida, removido da fila de retorno de chamada.

Algumas tarefas de inicialização podem ser executadas de modo assíncrono. Não há garantia de que a execução dessas tarefas assíncronas será concluída antes de uma invocação. Por exemplo, um código que faz uma chamada de rede para buscar um parâmetro do AWS Parameter Store poderá não estar concluído quando o Lambda executar a função de manipulador. Como resultado, a variável poderá ser nula durante uma invocação. Para evitar isso, certifique-se de que as variáveis ​​e outros códigos assíncronos estejam totalmente inicializados antes de continuar com o restante da lógica de negócios principal da função.

Como alternativa, é possível designar o código da função como um módulo ES, o que permite que você use await no nível superior do arquivo, fora do escopo do manipulador de função. Quando você await cada Promise, o código de inicialização assíncrona é concluído antes das invocações do manipulador, maximizando a eficácia da simultaneidade provisionada ao reduzir a latência de inicialização a frio. Para obter mais informações e um exemplo, consulte Uso de módulos ES do Node.js e do “await” em nível superior no AWS Lambda.

Designar um manipulador de funções como módulo ES

Por padrão, o Lambda trata arquivos com o sufixo .js como módulos CommonJS. Como opção, é possível designar o código como um módulo ES. Isso pode ser feito de duas maneiras: especificando o type como module no arquivo da função package.json ou usando a extensão do nome do arquivo .mjs. Na primeira abordagem, o código da função trata todos os arquivos .js como módulos ES, enquanto no segundo cenário, somente o arquivo especificado com .mjs corresponde a um módulo ES. É possível mesclar módulos ES e módulos CommonJS nomeando-os .mjs e .cjs, respectivamente, pois os arquivos .mjs serão sempre módulos ES, e os arquivos .cjs serão sempre módulos CommonJS.

O Lambda pesquisa pastas na variável de ambiente NODE_PATH ao carregar módulos de ES. É possível carregar o AWS SDK incluído no runtime ao usar as instruções import do módulo de ES. Também é possível carregar módulos ES usando camadas.

Versões do SDK incluídas no runtime

A versão do AWS SDK incluída no runtime do Node.js depende da versão do runtime e da Região da AWS. Para encontrar a versão do SDK incluída no runtime que você está usando, crie uma função do Lambda com o código a seguir.

const { version } = require("@aws-sdk/client-s3/package.json");

exports.handler = async () => ({ version });

{
  "version": "3.462.0"
}

Usar o keep-alive para conexões TCP

O agente Node.js HTTP/HTTPS padrão cria uma nova conexão TCP para cada nova solicitação. Para evitar o custo de estabelecer novas conexões, você pode usar keepAlive: true para reutilizar as conexões que sua função faz usando o AWS SDK para JavaScript. O Keep-alive pode reduzir os tempos de solicitação de funções do Lambda que fazem várias chamadas de API usando o SDK.

No AWS SDK para JavaScript 3.x, que está incluído no runtime do Lambda para nodejs18.x e em versões posteriores, o recurso keep-alive está habilitado por padrão. Para desativar o keep-alive, consulte Reusing connections with keep-alive in Node.js no Guia do desenvolvedor do AWS SDK para JavaScript 3.x. Para obter mais informações sobre como usar o keep-alive, consulte HTTP keep-alive is on by default in modular AWS SDK for JavaScript no Blog de ferramentas da AWS para o desenvolvedor.

Carregamento de certificado de CA

Até a versão do runtime do Node.js 18, o Lambda carrega automaticamente certificados de CA (autoridade de certificação) específicos da Amazon para facilitar a criação de funções que interagem com outros serviços da AWS. Por exemplo, o Lambda inclui os certificados do Amazon RDS necessários para validar o certificado de identidade do servidor instalado no banco de dados do Amazon RDS. Esse comportamento pode ter um impacto na performance durante inicializações a frio.

A partir do Node.js 20, o Lambda não carrega mais certificados de CA adicionais por padrão. O runtime do Node.js 20 contém um arquivo de certificado com todos os certificados de CA da Amazon localizado em /var/runtime/ca-cert.pem. Para restaurar o mesmo comportamento do Node.js 18 e de runtimes anteriores, defina a variável de ambiente NODE_EXTRA_CA_CERTS como /var/runtime/ca-cert.pem.

Para otimizar a performance, recomendamos que você agrupe somente os certificados de que precisa com o pacote de implantação e carregue-os usando a variável de ambiente NODE_EXTRA_CA_CERTS. O arquivo de certificados deve consistir em um ou mais certificados de CA raiz ou intermediários confiáveis no formato PEM. Por exemplo, para o RDS, inclua os certificados necessários junto com seu código como certificates/rds.pem. Em seguida, carregue os certificados configurando NODE_EXTRA_CA_CERTS como/var/task/certificates/rds.pem.