Criar e implantar uma função com o Cloud Code para VS Code

Nesta página, mostramos como criar, fazer o download, implantar e invocar uma função HTTP de 2ª geração usando o Cloud Functions com o Cloud Code.

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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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. Instale o Git. O Git é necessário para copiar amostras na sua máquina.
9. 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, é possível fazer o download de uma função existente para um novo espaço de trabalho e editá-la localmente.

Para criar uma nova função usando um exemplo, siga estas etapas:

1. Clique em Cloud Code e abra a seção Cloud Functions.

2. Clique em adicionar Criar função e selecione um modelo.

3. 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 Explorador, 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:

1. Clique em Cloud Code e abra a seção Cloud Functions.

2. Abra o snippet do Google Cloud projeto, clique com o botão direito do mouse na função que você quer fazer o download e selecione Fazer o download para um novo espaço de trabalho.

3. 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 ambiente de desenvolvimento integrado.

Implantar uma função

Para implantar uma função, siga estas etapas:

1. Clique com o botão direito do mouse em uma função e selecione Implantar função.

2. No menu "Seleção rápida", selecione um projeto do Google Cloud para implantar sua função.

3. Selecione uma região em que a função será implantada.

4. 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 aparece. Depois que ele for concluído, uma marca de seleção check_circle vai aparecer. Se falhar, uma marca de erro erro vai aparecer.

   Se a implantação falhar, consulte a mensagem de erro na guia Output. Clique no link para acessar os registros do build no console do Google Cloud e receber mais detalhes sobre o erro.

   

5. Opcional: depois que a função é implantada, é possível realizar as seguintes ações:

   • Para conferir os arquivos somente leitura da função implantada, expanda a função e a pasta Código-fonte. Aqui é possível ver launch.json em .vscode, o código implantado e package.json.

   • Para conferir 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. 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 conferir 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 pelo terminal integrado do ambiente de desenvolvimento integrado (IDE, na sigla em inglês). Para invocar uma função, siga estas etapas:

1. Clique com o botão direito do mouse na função e selecione Invocar função via HTTP.

2. Na seleção rápida Acionar função via HTTP que aparece, 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 em Google Cloud.

   • Importar argumentos do arquivo JSON: essa opção pega 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 a execução sem precisar digitar repetidamente.

A seguir

• Consulte a visão geral Trabalhar com o Cloud Functions para saber mais sobre como gerenciar seu espaço de trabalho ou configurar um ambiente de desenvolvimento local.

Receber suporte

Acesse o GitHub para enviar feedback e informar problemas ou o Stack Overflow (ambos em inglês) para fazer perguntas.