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

Nesta página, mostramos como criar, baixar, implantar e invocar uma função HTTP com base na API Cloud Run functions v2 usando o Cloud Code. Saiba mais sobre as funções do Cloud Run.

Antes de começar

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.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

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

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

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

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

1. Instale o Git. O Git é necessário para copiar amostras na sua máquina.
2. Instale o plug-in do Cloud Code se ainda não tiver feito isso.

Criar uma função

Se você já criou uma função, é possível baixar uma função existente para um novo espaço de trabalho e editar localmente.

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

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

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

3. Navegue até o programa de aprendizado em que você quer criar a nova função, insira um nome para ela e selecione Criar novo aplicativo.

   Se a pasta do aplicativo não aparecer automaticamente no Explorer, clique em refresh 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 expanda a seção Cloud Functions.

2. Abra 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 em 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 seu 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 de seleção rápida, selecione um projeto do Google Cloud para implantar a função.

3. Selecione a 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. Enquanto estiver em andamento, um indicador de progresso progress_activity vai aparecer. Quando ele for concluído, uma marca de seleção check_circle vai aparecer. Se ele falhar, uma marca de erro vai aparecer.

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

   

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

   • Para conferir os arquivos somente leitura da função implantada, expanda a função e depois a pasta Código-fonte. Aqui, é possível conferir 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 nela 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 nela 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

Ao invocar uma função implantada, é possível executá-la no console doGoogle Cloud usando o terminal integrado do ambiente de desenvolvimento integrado. 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. No menu de 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 de um arquivo JSON: essa opção pega o conteúdo do arquivo JSON selecionado, transforma em uma string e transmite com -d '{. Isso é útil quando você tem uma entrada para suas funções e quer salvá-la, permitindo que você a execute sem precisar digitar repetidamente.

A seguir

• Consulte a visão geral Trabalhar com o Cloud Functions para saber mais sobre 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.