Crie uma função do Cloud Run com o Cloud Code para o Cloud Shell

Saiba como criar, implementar, invocar e transferir uma função HTTP do Cloud Run através do Cloud Code no editor da Cloud Shell.

O Cloud Code é uma extensão que traz muitos Google Cloud serviços, como o Google Kubernetes Engine e o Cloud Run, diretamente para o seu IDE, para que possa desenvolver as suas aplicações sem ter de mudar de contexto. O Cloud Code está disponível por predefinição no editor do Cloud Shell.

Pode instalar a extensão Cloud Code no VS Code, que também suporta a criação e a implementação de funções, ou no IntelliJ e noutros IDEs JetBrains suportados, que não suportam funções do Cloud Run.

Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:

Visita guiada

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.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

    6. Ligue-se a Google Cloud

    Nesta secção, vai iniciar o editor do Cloud Shell, estabelecer ligação ao Google Cloude selecionar um Google Cloud projeto.

    Para se ligar ao Google Cloud, siga estes passos:

    1. Inicie o editor do Cloud Shell.

    2. Se lhe for pedido que autorize o Cloud Code a usar as suas credenciais para fazer uma Google Cloud chamada de API, clique em Autorizar se concordar com os termos.

    3. Se ainda não tiver ligação ao Google Cloud, na barra de estado do Cloud Code, clique em Ligar ao Google Cloud.

      Ligue-se ao botão Google Cloud na barra de estado

    4. Se lhe for pedido que autorize o Cloud Code a usar as suas credenciais para fazer Google Cloud chamadas à API, clique em Autorizar se concordar com estes termos.

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

      Se já tiver um Google Cloud projeto selecionado, verá o nome do projeto na barra de estado do Cloud Code e pode avançar para criar a sua função.

    6. No menu de seleção rápida Selecionar um projeto do Google Cloud apresentado, selecione o seu Google Cloud projeto.

      O projeto é carregado e torna-se o projeto ativo no editor do Cloud Shell. Pode mudar este projeto em qualquer altura clicando no nome do projeto ativo na barra de estado do Cloud Code e selecionando um projeto diferente.

    Crie a sua função

    Use o Cloud Shell Editor como ambiente para criar e implementar a sua função. O editor é pré-carregado com as ferramentas necessárias para o desenvolvimento na nuvem.

    Para criar uma nova função com um exemplo, siga estes passos:

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

      Botão da barra de estado do Cloud Code

    2. No menu de seleção rápida apresentado, selecione Nova aplicação.

    3. Selecione Aplicação Cloud Functions como o tipo de aplicação de exemplo.

    4. Na lista de apps de funções do Cloud Run de exemplo, selecione Node.js: Hello World.

    5. Selecione uma pasta para a localização da app e, de seguida, clique em Criar nova aplicação.

      O editor do Cloud Shell carrega a sua app num novo espaço de trabalho. Depois de recarregar, a sua app fica acessível com a vista Explorador.

      O ficheiro launch.json, localizado na pasta .vscode, contém as configurações necessárias para a sua função:

      {
"configurations": [
    {
    "name": "Deploy Cloud Function",
    "type": "cloudcode.cloudfunctions",
    "request": "launch",
    "functionName": "function-hello-world",
    "gen": "GEN_2",
    "entryPoint": "helloHttp",
    }
]
}

    Implemente a sua função

    Agora que criou a sua função, pode implementá-la no Cloud Shell seguindo estes passos:

    1. Clique em Código na nuvem e, de seguida, expanda o explorador Cloud Functions.

    2. Clique numa função e, de seguida, clique em Implementar função.

    3. No menu de seleção rápida, selecione um Google Cloud projeto para implementar a sua função.

    4. Selecione a região para a qual a função vai ser implementada.

    5. Selecione Node.js 22.

      A implementação da função pode demorar alguns minutos. Se ainda estiver em curso, é apresentado um ícone de progresso . Após a conclusão, é apresentado o ícone de êxito se for bem-sucedido, o ícone de erro se falhar ou o ícone de aviso se a implementação falhar e reverter para uma implementação bem-sucedida anterior.

      Se a implementação falhar, consulte a vista Output (View > Output) para ver a mensagem de erro. Se clicar no link, acede aos registos de compilação na Google Cloud consola e são apresentados mais detalhes sobre o erro.

    6. (Opcional) Depois de implementar a função, pode realizar as seguintes ações:

      • Para ver ficheiros só de leitura da sua função implementada, expanda a função e, em seguida, expanda a pasta Código-fonte. Aqui, pode ver launch.json em .vscode, o código implementado e package.json.

      • Para ver a função na Google Cloud consola, clique com o botão direito do rato na função e selecione Abrir na Cloud Console e, se lhe for pedido, selecione Abrir.

      • Para editar os metadados da sua função, clique com o botão direito do rato na função e selecione Editar metadados na Cloud Console.

      • Para ver os registos da função implementada, clique com o botão direito do rato na função e selecione Ver registos.

    Invocar a sua função

    A invocação de uma função permite-lhe executar a função implementada na Google Cloud consola a partir do terminal do editor do Cloud Shell. Para invocar uma função, siga estes passos:

    1. Clique com o botão direito do rato na função e selecione Invocar função através de HTTP.

    2. No menu de seleção rápida Acionar função através de HTTP apresentado, selecione Invocar sem argumentos.

      É aberto um terminal no IDE e é executado um comando para executar a função em Google Cloud.

    Opcional: transfira uma função existente para um novo espaço de trabalho

    Para transferir uma função existente para um novo espaço de trabalho, siga estes passos:

    1. Clique em Código na nuvem e, de seguida, expanda o explorador Cloud Functions.

    2. Expanda o Google Cloud fragmento do projeto, clique com o botão direito do rato na função que quer transferir e selecione Transferir para novo espaço de trabalho.

    3. Quando lhe for pedido, introduza um nome para a nova aplicação e, de seguida, clique em Criar nova aplicação.

      Esta ação transfere a função para o seu computador local e abre-a num novo espaço de trabalho no editor do Cloud Shell.

    Limpar

    Para eliminar apenas a função que criou para este início rápido:

    1. No explorador Cloud Functions, clique com o botão direito do rato no nome da função e, de seguida, selecione Abrir na Cloud Console.

    2. Clique em Eliminar e, de seguida, em Eliminar.

    Para eliminar o seu projeto (e os recursos associados):

    1. Aceda à página Projetos na Google Cloud consola:

      Aceda à página Projetos

    2. Selecione o projeto que criou para este início rápido e, de seguida, clique em Eliminar.

    3. Introduza o ID do projeto para confirmar e, de seguida, clique em Encerrar.

      Esta ação encerra o projeto e agenda a sua eliminação.

    O que se segue?