Criar uma função do Cloud Run usando a CLI do Google Cloud

O Cloud Run functions é um ambiente de execução sem servidor para criar e conectar serviços em nuvem, Com ele, você pode escrever funções simples com uma única finalidade e vinculadas a eventos emitidos pela sua infraestrutura e pelos serviços em nuvem. A função é acionada quando um evento em análise é disparado ou por uma solicitação HTTP.

Nesta página, mostramos como criar e implantar uma função HTTP usando o console do Google Cloud. Esta página é baseada no Node.js, mas o processo é semelhante a todos os ambientes de execução.

O exemplo neste guia de início rápido usa a seguinte função Node.js, que retorna uma mensagem quando acionada por uma solicitação HTTP:

const functions = require('@google-cloud/functions-framework');

functions.http('helloHttp', (req, res) => {
 res.send(`Hello ${req.query.name || req.body.name || 'World'}!`);
});

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. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub APIs.

    Enable the APIs

    5.

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

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub APIs.

    Enable the APIs

    8.

Crie uma função

  1. Abra a página de visão geral do Functions no console do Google Cloud:

    Acesse a página de visão geral das funções do Cloud Run.

    Verifique se o projeto para que você ativou as funções do Cloud Run está selecionado.

  2. Clique em Criar função.

  3. Nomeie a função, por exemplo, function-1.

  4. Selecione uma Região em que a função vai ser implantada.

  5. No campo HTTPS em Acionar, deixe a opção Exigir autenticação selecionada. Essa é a configuração padrão.

    A outra opção, Permitir invocações não autenticadas, permite alcançar a função sem autenticação. Isso é útil para testes, mas não recomendamos usar essa configuração em produção, a menos que você esteja criando uma API ou um site público. Além disso, talvez ela não funcione para você, dependendo das configurações da política corporativa. Consulte Como autenticar para invocação para detalhes sobre como invocar uma função que requer autenticação.

  6. Clique 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 que você quer usar. O exemplo usa nodejs22.

Implantar a função

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

  2. Depois de clicar em Implantar, o console do Google Cloud vai redirecionar você para a página Detalhes da função.

Enquanto a função é implantada, você verá um ícone de carregamento. Depois que a implantação da função é concluída, o ícone de carregamento muda para uma marca de seleção verde.

teste a função

Para testar a função após a implantação, faça o seguinte:

  1. Abra a guia Testes.

  2. Role para baixo até o campo Comando de teste da CLI.

  3. Clique em Executar no Cloud Shell.

    Uma janela do Cloud Shell é aberta na parte inferior da tela, mostrando o comando curl da guia Teste. Talvez você precise autorizar o Cloud Shell.

  4. Para executar o comando curl que é exibido na janela do Cloud Shell, pressione Enter.

    Sua mensagem "Hello world" é exibida.

A seguir