Guia de início rápido: criar e implantar uma função do Cloud Node.js

Criar e implantar uma função do Cloud Node.js

O Cloud Functions é um ambiente de execução sem servidor para criar e conectar serviços em nuvem. Com ele, é possível escrever funções simples que têm uma única finalidade e que são vinculadas a eventos emitidos pela infraestrutura e pelos serviços em nuvem. A função é acionada quando um evento em análise é disparado.

Saiba como criar e implantar uma função do Cloud Node.js usando o Console do Cloud.


Para receber orientações passo a passo sobre esta tarefa diretamente no Console do Cloud, clique em Orientação:

Orientações


As seções a seguir guiam você pelas mesmas etapas que você encontra clicando em Orientações.

Quando a função é acionada por uma solicitação HTTP, ela grava a seguinte mensagem:

/**
 * Responds to any HTTP request.
 *
 * @param {!express:Request} req HTTP request context.
 * @param {!express:Response} res HTTP response context.
 */
exports.helloWorld = (req, res) => {
  let message = req.query.message || req.body.message || 'Hello World!';
  res.status(200).send(message);
};

Consulte a Referência da API Express para saber mais sobre os parâmetros request e response.

Antes de começar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  4. Enable the Cloud Functions and Cloud Build APIs.

    Enable the APIs

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  7. Enable the Cloud Functions and Cloud Build APIs.

    Enable the APIs

Criar uma função

  1. Abra a página Visão geral das funções no Console do Cloud:

    Acessar a página Visão geral do Cloud Functions

    Verifique se o projeto com o Cloud Functions ativado foi selecionado.

  2. Clique em Criar função.

  3. Nomeie a função.

  4. No campo Gatilho, selecione HTTP.

  5. No campo Autenticação, selecione Permitir invocações não autenticadas.

  6. Clique em Salvar para salvar as alterações e, depois, em Próxima.

  7. No campo Código-fonte, selecione Editor in-line. Neste exercício, você usará a função padrão fornecida no editor.

  8. Use o menu suspenso Ambiente de execução para selecionar um ambiente de execução do Node.js.

Implantar a função

  1. Na parte inferior da página, clique em Implantar.

  2. Depois de clicar em Implantar, o Console do Cloud será redirecionado para a página de visão geral do Cloud Functions.

    Enquanto a função é implantada, o ícone ao lado dela fica girando. Depois de concluída a implantação, o ícone muda para uma marca de seleção verde.

    Captura de tela que mostra o processo de implantação da função

Testar a função

  1. Veja o menu da função e clique em Testar função.

    Captura de tela que mostra o processo de teste da função

  2. Na página de teste, clique em Testar a função.

    A tela Saída exibe o texto "Hello World!"

  3. Altere a mensagem. No campo Evento acionador, insira o texto {"message":"Hello, YOUR_NAME!"}, substituindo YOUR_NAME por um nome e clique em Testar a função.

    Vamos supor que você inseriu o nome "Rowan". No campo Saída é exibida a mensagem Hello, Rowan!.

    No campo Registros, um código de status 200 indica êxito.

    Captura de tela que mostra o campo Registros com código 200, indicando êxito

Ver registros

Verifique os registros para ver as ações no histórico de registros:

  • De volta à página "Visão geral do Cloud Functions", veja o menu da função e clique em Exibir registros.

O histórico de registros é exibido.

Captura de tela que mostra o campo Registros com código 200, indicando êxito

A seguir