ARC109

Visão geral

Nos laboratórios com desafio, apresentamos uma situação e um conjunto de tarefas. Para concluí-las, em vez de seguir instruções detalhadas, você usará o que aprendeu nos laboratórios do curso. Um sistema automático de pontuação (mostrado nesta página) vai avaliar seu desempenho.

Nos laboratórios com desafio, não ensinamos novos conceitos do Google Cloud. O objetivo dessas tarefas é aprimorar aquilo que você já aprendeu, como a alteração de valores padrão ou a leitura e pesquisa de mensagens para corrigir seus próprios erros.

Para alcançar a pontuação de 100%, você precisa concluir todas as tarefas no tempo definido.

Configuração

Antes de clicar no botão Começar o Laboratório

Leia estas instruções. Os laboratórios são cronometrados e não podem ser pausados. O timer é ativado quando você clica em Iniciar laboratório e mostra por quanto tempo os recursos do Google Cloud vão ficar disponíveis.

Este laboratório prático permite que você realize as atividades em um ambiente real de nuvem, e não em uma simulação ou demonstração. Você vai receber novas credenciais temporárias para fazer login e acessar o Google Cloud durante o laboratório.

Confira os requisitos para concluir o laboratório:

• Acesso a um navegador de Internet padrão (recomendamos o Chrome).

Observação: para executar este laboratório, use o modo de navegação anônima (recomendado) ou uma janela anônima do navegador. Isso evita conflitos entre sua conta pessoal e de estudante, o que poderia causar cobranças extras na sua conta pessoal.

• Tempo para concluir o laboratório: não se esqueça que, depois de começar, não será possível pausar o laboratório.

Observação: use apenas a conta de estudante neste laboratório. Se usar outra conta do Google Cloud, você poderá receber cobranças nela.

Cenário do desafio

Você começou a trabalhar como analista de dados júnior. Até agora, tem ajudado as equipes a criar, gerenciar e acessar recursos de dados de back-end.

Seu conhecimento precisa ser suficiente para realizar essas tarefas.

Seu desafio

Você precisa ajudar uma nova equipe de desenvolvimento com as tarefas iniciais de um projeto que envolve expor serviços de back-end como APIs. Você ficou responsável por ajudar a equipe a usar o API Gateway. Para isso, precisará fazer o seguinte:

• Desenvolver o sistema de back-end usando uma função do Cloud Run.
• Implantar e gerenciar uma API que expõe o serviço de back-end com um gateway totalmente gerenciado.
• Inscrever-se nas mensagens publicadas em um tópico do Pub/Sub para reagir a eventos.

Cada tarefa está descrita abaixo. Boa sorte!

Tarefa 1: criar uma função do Cloud Run

Observação: o Cloud Run functions (2ª geração) depende das APIs Cloud Run Admin. Essas APIs foram ativadas para você no início deste laboratório. No entanto, pode levar alguns minutos para que todos os serviços ativados sejam propagados. Se você tiver problemas ao implantar sua função do Cloud Run, aguarde alguns minutos antes de tentar novamente.

Crie uma função do Cloud Run (2ª geração) chamada gcfunction na região usando o Node.js 22 e permitindo invocações não autenticadas. Por enquanto, faça com que a função retorne "Hello World!" quando invocada.

Clique em Verificar meu progresso para conferir o objetivo. Criar uma função do Cloud Run

Tarefa 2: criar um API Gateway

Depois que a função do Cloud Run for implantada, configure um API Gateway para encaminhar as solicitações ao back-end.

Crie um arquivo chamado openapispec.yaml (usando o código abaixo), que faz referência à função do Cloud Run implantada na Tarefa 1.

Use openapispec.yaml ao implantar o API Gateway com as seguintes propriedades:

Nome	Valor
Nome de exibição	gcfunction API (onde solicitado)
ID da API	gcfunction-api
Selecione uma conta de serviço	Conta de serviço padrão do Compute Engine
Localização
Nome de configuração	gcfunction-api

swagger: '2.0' info: title: gcfunction API description: Sample API on API Gateway with a Google Cloud Run functions backend version: 1.0.0 schemes: - https produces: - application/json x-google-backend: address: https://gcfunction-{{{ project_0.startup_script.project_number | PROJECT_NUMBER }}}.{{{project_0.default_region | REGION}}}.run.app paths: /gcfunction: get: summary: gcfunction operationId: gcfunction responses: '200': description: A successful response schema: type: string Observação: a criação do gateway leva cerca de 10 minutos. Para verificar o status do processo de criação e implantação, clique no ícone Notificações (o sino) na barra de navegação principal superior para exibir uma notificação de status. Antes de prosseguir, verifique se há uma marca de seleção verde ao lado do ícone de Criação do gateway "gcfunction API".

Clique em Verificar meu progresso para conferir o objetivo. Criar um API Gateway.

Tarefa 3: criar um tópico do Pub/Sub e publicar mensagens usando o back-end com API

A equipe de desenvolvimento quer que o back-end com API publique mensagens em um novo tópico do Pub/Sub chamado demo-topic.

Crie um novo tópico do Pub/Sub (demo-topic) e envie mensagens para ele na função do Cloud Run já implantada. Mantenha a opção de criar uma assinatura padrão ativada ao criar o tópico.

Use o snippet abaixo para atualizar o arquivo package.json e o código index.js na função do Cloud Run implantada na Tarefa 1.

package.json

{ "dependencies": { "@google-cloud/functions-framework": "^3.0.0", "@google-cloud/pubsub": "^3.4.1" } }

index.js

/** * Responde a qualquer solicitação HTTP. * * @param {!express:Request} req HTTP request context. * @param {!express:Response} res HTTP response context. */ const {PubSub} = require('@google-cloud/pubsub'); const pubsub = new PubSub(); const topic = pubsub.topic('demo-topic'); const functions = require('@google-cloud/functions-framework'); exports.helloHttp = functions.http('helloHttp', (req, res) => { // Envia uma mensagem ao tópico topic.publishMessage({data: Buffer.from('Hello from Cloud Run functions!')}); res.status(200).send("Message sent to Topic demo-topic!"); });

Implante novamente a função do Cloud Run depois que os arquivos index.js e package.json forem atualizados.

Em seguida, invoque a função do Cloud Run usando o API Gateway. Se tudo for feito corretamente, uma mensagem será publicada no tópico demo-topic que você criou nesta tarefa.

Observação: vai levar cerca de 5 minutos para que as mensagens publicadas apareçam na seção "Mensagens" da assinatura depois de você invocar o endpoint do API Gateway.

Clique em Verificar meu progresso para conferir o objetivo. Criar um tópico do Pub/Sub e publicar mensagens usando o back-end com API.

Parabéns!

Você concluiu o desafio de implantar e gerenciar uma API que expõe o serviço de back-end com um gateway totalmente gerenciado.

Treinamento e certificação do Google Cloud

Esses treinamentos ajudam você a aproveitar as tecnologias do Google Cloud ao máximo. Nossas aulas incluem habilidades técnicas e práticas recomendadas para ajudar você a alcançar rapidamente o nível esperado e continuar sua jornada de aprendizado. Oferecemos treinamentos que vão do nível básico ao avançado, com opções de aulas virtuais, sob demanda e por meio de transmissões ao vivo para que você possa encaixá-las na correria do seu dia a dia. As certificações validam sua experiência e comprovam suas habilidades com as tecnologias do Google Cloud.

Manual atualizado em 1º de abril de 2025

Laboratório testado em 1º de abril de 2025

Copyright 2025 Google LLC. Todos os direitos reservados. Google e o logotipo do Google são marcas registradas da Google LLC. Todos os outros nomes de produtos e empresas podem ser marcas registradas das respectivas empresas a que estão associados.