Criar e implantar uma função com o Cloud Shell

Saiba como criar, implantar, invocar e fazer o download de uma função HTTP de 2a geração usando o Cloud Functions com o Cloud Code no editor do Cloud Shell.

---

Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientação:

Orientações

---

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.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

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

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

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

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

Conectar-se ao Google Cloud

Nesta seção, você vai iniciar o editor do Cloud Shell, conectar-se ao Google Cloud e selecionar um projeto do Google Cloud.

Para se conectar ao Google Cloud, siga estas etapas:

1. Inicie o editor do Cloud Shell

2. Se for preciso autorizar o Cloud Code a usar suas credenciais para fazer uma chamada de API do Google Cloud, clique em Autorizar se você concordar com os termos.

3. Se você ainda não estiver conectado ao Google Cloud, na barra de status do Cloud Code, clique em Conectar ao Google Cloud.

   

4. Se for preciso autorizar o Cloud Code a usar suas credenciais para fazer chamadas da API Google Cloud, clique em Autorizar se você concordar com esses termos.

5. Se você ainda não tiver um projeto do Google Cloud selecionado, na barra de status do Cloud Code, clique em Selecionar um projeto do Google Cloud.

   Se você já tiver um projeto do Google Cloud selecionado, o nome dele vai aparecer na barra de status do Cloud Code e será possível criar a função.

6. No menu de escolha rápida Selecionar um projeto do Google Cloud, selecione seu projeto do Google Cloud.

   O projeto é carregado e se torna o projeto ativo no editor do Cloud Shell. É possível alternar esse projeto a qualquer momento clicando no nome do projeto ativo na barra de status do Cloud Code e selecionando um projeto diferente.

Criar a função

Use o editor do Cloud Shell como ambiente para criar e implantar a função. Ele vem pré-carregado com as ferramentas necessárias para desenvolvimento na nuvem.

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

1. Na barra de status do Cloud Code, clique em Cloud Code.

   

2. No menu "Escolha rápida" que aparece, selecione Novo aplicativo.

3. Selecione Aplicativo do Cloud Functions como o tipo de aplicativo de amostra.

4. Na lista de apps de amostra do Cloud Functions, selecione Node.js: Hello World.

5. Selecione uma pasta para ser o local do app e clique em Criar novo aplicativo.

   O editor do Cloud Shell vai carregar seu app em um novo espaço de trabalho. Após a atualização, seu app pode ser acessado pela visualização de explorador.

   O arquivo launch.json, localizado na pasta .vscode, 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 Shell.

implante a função

Agora que você criou sua função, é possível implantá-la no Cloud Shell seguindo estas etapas:

1. Clique em Cloud Code e expanda o explorador Cloud Functions.

2. Clique em uma função e depois em Implantar função.

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

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

5. Selecione Node.js 20.

   A implantação da função pode levar alguns minutos. Você vai encontrar um ícone de progresso , se ele ainda estiver em andamento. Depois que ela for concluída, você vai ver o ícone de sucesso se for bem-sucedida, o ícone de erro se falhar ou o ícone de aviso se a implantação falhar e reverter para uma implantação anteriormente bem-sucedida.

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

6. (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 expanda a pasta Código-fonte. Aqui é possível ver launch.json em .vscode, o código implantado e package.json.

   • Para ver 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 a função

Invocar uma função permite que você execute a função implantada no console do Google Cloud a partir do terminal do editor do Cloud Shell. 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 Invocar sem argumentos.

   Um terminal é aberto no ambiente de desenvolvimento integrado e executa um comando para executar a função no Google Cloud.

Opcional: 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 o explorador 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 editor do Cloud Shell.

Limpar

Para excluir apenas a função que você criou para este guia de início rápido:

1. No explorador Cloud Functions, clique com o botão direito do mouse no nome da função e selecione Abrir no console do Cloud.

2. Clique em Excluir e em Excluir.

Para excluir seu projeto e recursos associados, faça o seguinte:

1. Acesse a página "Projetos" no Console do Google Cloud.

   Acessar a página "Projetos"

2. Selecione o projeto que você criou para este guia de início rápido e clique em Excluir.

3. Digite o ID do projeto para confirmar e clique em Encerrar.

   Isso encerrará o projeto e programará a remoção dele.

A seguir

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