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

Saiba como criar, implantar, invocar e fazer o download de uma função do Cloud Run HTTP usando as funções do Cloud Run 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. 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. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

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

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

Implantar 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 abra o explorador do 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 22.

   A implantação da função pode levar alguns minutos. Você vai encontrar um ícone de progresso , se ele ainda estiver em andamento. Depois disso, Ícone de sucesso se der certo, o ícone de erro em caso de falha ou o Ícone de aviso se a implantação falhar e for revertida para uma que já foi 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. Abra o snippet do projeto do Google Cloud, 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 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 do trabalho com o Cloud Run functions} para saber mais sobre como gerenciar seu espaço de trabalho ou configurar um ambiente de desenvolvimento local.