Criar uma Cloud Run function usando o Cloud Code para Cloud Shell

Criar uma Cloud Run function usando o Cloud Code para Cloud Shell

Saiba como criar, implantar, invocar e fazer o download de uma Cloud Run function HTTP usando o Cloud Code no editor do Cloud Shell.

O Cloud Code é uma extensão que leva muitos serviços do Google Cloud, como o Google Kubernetes Engine e o Cloud Run, diretamente para seu ambiente de desenvolvimento integrado, para que você possa desenvolver seus aplicativos sem precisar mudar de contexto. O Cloud Code está disponível por padrão no Editor do Cloud Shell.

É possível instalar a extensão do Cloud Code no VS Code, que também oferece suporte à criação e implantação de funções ou ao IntelliJ e outros ambientes de desenvolvimento integrado da JetBrains com suporte, que não oferecem suporte às funções do Cloud Run.

---

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

Orientações

---

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. 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. Make sure that billing is enabled for your Google Cloud project.

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

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

• Saiba mais sobre como gerenciar funções no espaço de trabalho do Cloud Shell ou como executar localmente com o Functions Framework.
• Saiba mais sobre como gravar usando as funções do Cloud Run
• Saiba mais sobre como implantar funções do Cloud Run.
• Saiba mais sobre como chamar as funções do Cloud Run.
• Saiba mais sobre como monitorar as funções do Cloud Run.
• Saiba mais sobre como executar as funções do Cloud Run localmente.
• Explore os tutoriais mais avançados das funções do Cloud Run.