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 2a geração usando o Cloud Functions com o Cloud Code.

Antes de começar

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

  2. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  4. Ative as APIs Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub.

    Ative as APIs

    5.

  5. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  6. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  7. Ative as APIs Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub.

    Ative as APIs

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

crie uma função

Se você já criou uma função antes, é 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, em seguida, expanda a seção Cloud Functions.

  2. Clique em add 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 a função e selecione Create New Application.

    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",
    }
  ]
}

Saiba como criar várias funções em um único espaço de trabalho em Gerenciar funções no espaço de trabalho do VS Code.

Fazer o download de uma função existente para um novo espaço de trabalho

Para fazer o download de uma função para um novo espaço de trabalho, siga estas etapas:

  1. Clique em Cloud Code e, em seguida, expanda 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 a 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 processo, um indicador de progresso progress_activity vai aparecer. Depois disso, uma marca de seleção check_circle será exibida. Se falhar, aparecerá uma marca de erro error.

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

    Saída da mensagem de erro

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

    • Para ver arquivos somente leitura da função implantada, expanda a função e, em seguida, a pasta Código-fonte. Aqui é possível ver 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 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 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 a partir do 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. Na Seleção rápida Função de gatilho via HTTP exibida, selecione uma destas 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, transforma-o 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 precisar digitá-la várias vezes.

A seguir

Receber suporte

Para enviar feedback, informar problemas no GitHub ou fazer uma pergunta no Stack Overflow.