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. 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.

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. Enquanto estiver em andamento, um indicador de progresso progress_activity vai aparecer. Depois que ele for concluído, uma marca de seleção check_circle vai aparecer. Em caso de falha, error.

   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 receber mais detalhes sobre o erro.

   

5. Opcional: depois que a função for implantada, será possível realizar o seguinte 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 visualizar launch.json em .vscode, o código implantado e package.json.

   • Para visualizar a função no console do Google Cloud, clique com o botão direito do mouse 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 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 seção Gatilho rápido da função via HTTP exibida, selecione uma das as 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 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 desejar salvá-lo, permitindo que você o execute sem ter que redigitá-lo repetidamente.

A seguir

• Consulte a seção Trabalhar com o Cloud Functions para saber mais sobre como gerenciar seu espaço de trabalho ou como 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.