Nesta página, mostramos como criar, fazer o download, implantar e invocar uma função HTTP de 2a geração usando o Cloud Functions com o Cloud Code.
Antes de começar
- Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
-
No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Ative as APIs Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub.
-
No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Ative as APIs Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub.
- Instale o Git. O Git é necessário para copiar amostras na sua máquina.
- Instale o plug-in do Cloud Code, caso ainda não tenha feito isso.
criar uma função
Se você já criou uma função antes, é possível fazer o download de uma função atual em um novo espaço de trabalho e editá-la localmente.
Para criar uma nova função usando um exemplo, siga estas etapas:
Clique em Cloud Code e expanda a seção Cloud Functions.
Clique em add Criar função e selecione um modelo.
Navegue até o caminho em que você quer criar a nova função, insira um nome para ela e selecione Criar novo aplicativo.
Se a pasta do seu aplicativo não aparecer automaticamente no Explorer, clique em Atualizar Atualizar.
O arquivo
launch.json
contém as configurações necessárias para sua função:{ "configurations": [ { "name": "Deploy Cloud Function", "type": "cloudcode.cloudfunctions", "request": "launch", "functionName": "function-hello-world", "gen": "GEN_2", "entryPoint": "helloHttp", } ] }
Para saber mais sobre como criar várias funções em um único espaço de trabalho, consulte Gerenciar funções no espaço de trabalho do VS Code.
Fazer o download de uma função que já existe para um novo espaço de trabalho
Para fazer o download de uma função em um novo espaço de trabalho, siga estas etapas:
Clique em Cloud Code e expanda a seção Cloud Functions.
Expanda o snippet do projeto do Google Cloud, clique com o botão direito do mouse na função que você quer baixar e selecione Fazer o download para um novo espaço de trabalho.
Quando solicitado, insira um nome para o novo aplicativo e clique em Criar novo aplicativo.
Isso faz o download da função para sua máquina local e a abre em um novo espaço de trabalho no seu ambiente de desenvolvimento integrado.
Implantar uma função
Para implantar uma função, siga estas etapas:
Clique com o botão direito do mouse em uma função e selecione Implantar função.
No menu "Seleção rápida", selecione um projeto do Google Cloud para implantar sua função.
Selecione uma região em que a função será implantada.
Selecione um ambiente de execução.
A implantação da função pode levar alguns minutos. Durante o andamento, um indicador de progresso progress_activity é exibido. Depois de concluído, uma marca de seleção check_circle será exibida. Se falhar, aparecerá uma marca de erro de erro.
Se a implantação falhar, consulte a guia Saída para conferir a mensagem de erro. Clique no link para acessar os registros do build no console do Google Cloud e fornecer mais detalhes sobre o erro.
Opcional: depois que a função for implantada, será possível realizar as seguintes ações:
Para visualizar os arquivos somente leitura da função implantada, expanda a função e depois a pasta Código-fonte. Aqui é possível ver
launch.json
em.vscode
, o código implantado epackage.json
.Para visualizar a função no console do Google Cloud, clique com o botão direito do mouse na função e selecione Abrir no Console do Cloud e, se solicitado, selecione Abrir.
Para editar os metadados da função, clique com o botão direito do mouse na função e selecione Editar metadados no Console do Cloud.
Para ver os registros da função implantada, clique com o botão direito do mouse na função e selecione Ver registros.
Invocar uma função
Invocar uma função permite que você execute a função implantada no console do Google Cloud usando o terminal integrado do ambiente de desenvolvimento integrado. Para invocar uma função, siga estas etapas:
Clique com o botão direito do mouse na função e selecione Invocar função via HTTP.
Na seção rápida Acionar função via HTTP exibida, selecione uma das duas opções:
Padrão: um terminal é aberto no ambiente de desenvolvimento integrado e executa um comando para executar a função no Google Cloud.
Importar argumentos do arquivo JSON: essa opção usa o conteúdo do arquivo JSON selecionado, o transforma em uma string e o transmite com
-d '{
. Isso é útil quando você tem uma entrada para suas funções e quer salvá-la, permitindo que você a execute sem ter que redigitá-la várias vezes.
A seguir
- Consulte a visão geral de Como trabalhar com o Cloud Functions para saber mais sobre como gerenciar seu espaço de trabalho ou configurar um ambiente de desenvolvimento local.