Você começou recentemente a trabalhar como desenvolvedor de nuvem em uma empresa de TI que usa o Google Cloud como principal provedor de serviços de nuvem (CSP). Você recebeu instruções para criar aplicativos da Web sem servidor e sem estado na nuvem. Portanto, você precisa adotar o serviço do Cloud Run oferecido pelo Google Cloud. Alguns dos seus focos de atenção são:

• Ativação da API Cloud Run
• Armazenamento de imagens de contêiner
• Implantação de apps conteinerizados sem servidor
• Práticas recomendadas de redução de custos

Como você trabalhou com o Azure no seu emprego anterior, você já usou os serviços de app do Azure para hospedar aplicativos da Web. O Azure cuida da configuração da infraestrutura que dá suporte a esses aplicativos, e você implementa seu código nos serviços de app do Azure de duas maneiras:

• Código (usando uma conexão FTP)
• Contêiner do Docker (usando uma imagem conteinerizada)

Para criar um serviço de app, você especificou uma categoria para definir uma potência computacional, recursos e outros atributos para seus apps.

Você criou imagens e as enviou para o Container Registry do Azure usando o Docker. Você implementou essas imagens em contêineres aplicando o mesmo processo que usou com o código.

Você adotou práticas recomendadas, como regras para reduzir e aumentar o escalonamento horizontal, para determinar o número de recursos e instâncias de computação associados aos seus aplicativos para minimizar o impacto nos custos.

Um aplicativo conteinerizado sem servidor hospedado nos serviços de app do Azure deve se parecer com o seguinte:

Agora você verá como implantar aplicativos no Google Cloud.

Visão geral

O Cloud Run é uma plataforma de computação gerenciada onde você executa contêineres sem estado que podem ser invocados usando solicitações HTTP. O Cloud Run não tem servidor. Ele cuida de todo o gerenciamento da infraestrutura para que você possa se concentrar no que mais importa: criar aplicativos incríveis.

O Cloud Run foi desenvolvido usando o Knative. Por isso, você pode executar contêineres de maneira totalmente gerenciada com o próprio Cloud Run ou em um cluster do Google Kubernetes Engine com o Cloud Run no GKE.

O objetivo deste laboratório é criar uma imagem de aplicativo conteinerizado simples que será implantada no Cloud Run.

Objetivos

Neste laboratório, você vai aprender a:

• ativar a API Cloud Run;
• criar um aplicativo simples em Node.js que pode ser implantado como um contêiner sem servidor e estado;
• conteinerizar seu aplicativo e fazer upload para o Container Registry, agora chamado de Artifact Registry;
• implantar um aplicativo conteinerizado no Cloud Run;
• excluir imagens desnecessárias para evitar cobranças adicionais de armazenamento.

Configuração e requisitos

Para cada laboratório, você recebe um novo projeto do Google Cloud e um conjunto de recursos por um determinado período e sem custos financeiros.

1. Faça login no Qwiklabs em uma janela anônima.

2. Confira o tempo de acesso do laboratório (por exemplo, 1:15:00) e finalize todas as atividades nesse prazo.
   Não é possível pausar o laboratório. Você pode reiniciar o desafio, mas vai precisar refazer todas as etapas.

3. Quando tudo estiver pronto, clique em Começar o laboratório.

4. Anote as credenciais (Nome de usuário e Senha). É com elas que você vai fazer login no Console do Google Cloud.

5. Clique em Abrir Console do Google.

6. Clique em Usar outra conta, depois copie e cole as credenciais deste laboratório nos locais indicados.
   Se você usar outras credenciais, vai receber mensagens de erro ou cobranças.

7. Aceite os termos e pule a página de recursos de recuperação.

Como começar o laboratório e fazer login no console

1. Clique no botão Começar o laboratório. Se for preciso pagar pelo laboratório, você verá um pop-up para selecionar a forma de pagamento. Um painel aparece à esquerda contendo as credenciais temporárias que você precisa usar no laboratório.

   

2. Copie o nome de usuário e clique em Abrir console do Google. O laboratório ativa os recursos e depois abre a página Escolha uma conta em outra guia.

   Observação: abra as guias em janelas separadas, lado a lado.

3. Na página "Escolha uma conta", clique em Usar outra conta. A página de login abre.

   

4. Cole o nome de usuário que foi copiado do painel "Detalhes da conexão". Em seguida, copie e cole a senha.

Observação: é necessário usar as credenciais do painel "Detalhes da conexão". Não use suas credenciais do Google Skills. Caso tenha sua própria conta do Google Cloud, não a use para este laboratório (isso evita cobranças).

5. Acesse as próximas páginas:

• Aceite os Termos e Condições.
• Não adicione opções de recuperação nem autenticação de dois fatores (porque essa é uma conta temporária).
• Não se inscreva em testes sem custo financeiro.

Depois de alguns instantes, o console do Cloud abre nesta guia.

Observação: para acessar a lista dos produtos e serviços do Google Cloud, clique no Menu de navegação no canto superior esquerdo.

Ative o Google Cloud Shell

O Google Cloud Shell é uma máquina virtual com ferramentas de desenvolvimento. Ele tem um diretório principal permanente de 5 GB e é executado no Google Cloud.

O Cloud Shell oferece acesso de linha de comando aos recursos do Google Cloud.

1. No console do Cloud, clique no botão "Abrir o Cloud Shell" na barra de ferramentas superior direita.

   

2. Clique em Continuar.

O provisionamento e a conexão do ambiente podem demorar um pouco. Quando você estiver conectado, já estará autenticado, e o projeto estará definido com seu PROJECT_ID. Exemplo:

A gcloud é a ferramenta de linha de comando do Google Cloud. Ela vem pré-instalada no Cloud Shell e aceita preenchimento com tabulação.

• Para listar o nome da conta ativa, use este comando:

gcloud auth list

Saída:

Credentialed accounts: - @.com (active)

Exemplo de saída:

Credentialed accounts: - google1623327_student@qwiklabs.net

• Para listar o ID do projeto, use este comando:

gcloud config list project

Saída:

[core] project =

Exemplo de saída:

[core] project = qwiklabs-gcp-44776a13dea667a6 Observação: a documentação completa da gcloud está disponível no guia com informações gerais sobre a gcloud CLI .

Referência

Comandos básicos do Linux

Abaixo, você encontra uma lista de referências com alguns dos comandos mais básicos do Linux que podem aparecer nas instruções ou blocos de código deste laboratório.

Comando -->	Ação	.	Comando -->	Ação
mkdir (criar diretório)	cria uma nova pasta	.	cd (mudar diretório)	muda o local para outra pasta
ls (listar )	lista arquivos e pastas no diretório	.	cat (concatenar)	lê o conteúdo de um arquivo sem usar um editor
apt-get update	atualiza a biblioteca do gerenciador de pacotes	.	ping	sinal para testar a acessibilidade de um host
mv (mover )	move um arquivo	.	cp (copiar)	cria uma cópia do arquivo
pwd (apresentar diretório de trabalho)	retorna o local atual	.	sudo (ação de superusuário)	concede privilégios de administração

Tarefa 1: ativar a API Cloud Run e configurar seu ambiente shell

1. No Cloud Shell, ative a API Cloud Run:

gcloud services enable run.googleapis.com

2. Se for solicitado, autorize o uso das suas credenciais. Depois, você verá uma mensagem de sucesso parecida com esta:

Operation "operations/acf.cc11852d-40af-47ad-9d59-477a12847c9e" finished successfully. Observação: também é possível ativar a API na seção APIs e serviços do console.

3. Defina a região de computação:

gcloud config set compute/region {{{ project_0.default_region| "Region" }}}

4. Crie uma variável de ambiente "LOCATION":

LOCATION="{{{ project_0.default_region| "Region" }}}"

Tarefa 2: criar o aplicativo de exemplo

Nesta tarefa, você vai criar um aplicativo simples em Node.js baseado no Express que responde a solicitações HTTP.

1. No Cloud Shell, crie um novo diretório chamado helloworld e depois mova sua visualização para ele:

mkdir helloworld && cd helloworld

2. Agora, você vai criar e editar os arquivos. Para fazer mudanças, use vi, emac, nano ou clique no botão Abrir editor no Cloud Shell para usar o editor de código dessa ferramenta.

3. Crie um arquivo package.json e adicione este conteúdo a ele:

nano package.json { "name": "helloworld", "description": "Simple hello world sample in Node", "version": "1.0.0", "main": "index.js", "scripts": { "start": "node index.js" }, "author": "Google LLC", "license": "Apache-2.0", "dependencies": { "express": "^4.17.1" } }

O arquivo acima contém principalmente um comando de script de início e uma dependência no framework Express para aplicativos da Web.

4. Pressione CTRL+X, depois Y para salvar o arquivo package.json.

5. No mesmo diretório, crie um arquivo index.js e cole estas linhas nele:

nano index.js const express = require('express'); const app = express(); const port = process.env.PORT || 8080; app.get('/', (req, res) => { const name = process.env.NAME || 'World'; res.send(`Hello ${name}!`); }); app.listen(port, () => { console.log(`helloworld: listening on port ${port}`); });

Esse código cria um servidor da Web básico que detecta na porta definida pela variável de ambiente PORT. O app está concluído e pronto para conteinerização e upload no Container Registry.

6. Pressione CTRL+X, depois Y para salvar o arquivo index.js.

Observação: você pode começar a usar o Cloud Run com outras linguagens também. Acesse o Guia de início rápido para conferir instruções para Go, Python, Java, PHP, Ruby, scripts de shell, entre outros.

Tarefa 3: conteinerizar seu app e fazer upload dele para o Artifact Registry

1. Para conteinerizar o app de exemplo, crie um novo arquivo chamado Dockerfile no mesmo diretório dos arquivos de origem e adicione o seguinte:

nano Dockerfile # Usa a imagem oficial lightweight do Node.js 12. # https://hub.docker.com/_/node FROM node:12-slim # Cria o diretório do app e entra nele. WORKDIR /usr/src/app # Copia os manifestos de dependências da aplicação para a imagem do contêiner. # Um caractere curinga é usado para garantir a cópia tanto de package.json quanto de package-lock.json (caso esteja disponível). # Copiar isso antes evita que npm install seja re-executado a cada mudança no código. COPY package*.json ./ # Instala dependências de produção. # Caso você adicione um package-lock.json, acelere seu build trocando para 'npm ci'. # RUN npm ci --only=production RUN npm install --only=production # Copia o código local para a imagem do contêiner. COPY . ./ # Executa o web service na inicialização do contêiner. CMD [ "npm", "start" ]

2. Pressione CTRL+X, depois Y para salvar o arquivo Dockerfile.

3. Crie a imagem do contêiner usando o Cloud Build. Para isso, execute o comando a seguir no diretório que tem seu Dockerfile. A variável de ambiente $GOOGLE_CLOUD_PROJECT no comando contém o ID do projeto do laboratório:

gcloud builds submit --tag gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld

O Cloud Build é um serviço que executa seus builds no GCP. Ele executa uma série de etapas do build, cada uma em um contêiner do Docker, para produzir o contêiner do seu aplicativo (ou outros artefatos) e enviá-lo ao Cloud Registry, tudo em um comando.

Depois disso, a mensagem "SUCCESS" vai aparecer com o nome da imagem (gcr.io/[PROJECT-ID]/helloworld). A imagem é armazenada no Artifact Registry e pode ser reutilizada se você quiser.

4. Liste todas as imagens do contêiner associadas ao projeto atual usando este comando:

gcloud container images list

5. Para executar e testar o aplicativo localmente no Cloud Shell, inicie-o usando este comando padrão do docker:

docker run -d -p 8080:8080 gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld

6. Na janela do Cloud Shell, clique em Visualização na Web e selecione Visualizar na porta 8080.

Uma janela do navegador será aberta com a mensagem "Hello World!". Também é possível usar curl localhost:8080.

Observação: se o comando docker não extrair a imagem remota do contêiner, execute este comando: gcloud auth configure-docker

Tarefa 4: implantar no Cloud Run

1. Para implantar seu aplicativo conteinerizado no Cloud Run, use o seguinte comando com o ID do projeto:

gcloud run deploy --image gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld --allow-unauthenticated --region=$LOCATION

A flag "allow-unauthenticated" no comando acima torna seu serviço disponível publicamente.

2. Se for solicitado, confirme o service name pressionando Enter.

Aguarde alguns instantes até a implantação terminar.

Em caso de sucesso, a linha de comando vai exibir o URL de serviço:

Service [helloworld] revision [helloworld-00001-xit] has been deployed and is serving 100 percent of traffic. Service URL: https://helloworld-h6cp412q3a-uc.a.run.app

Agora você pode acessar o contêiner implantado abrindo o URL de serviço em qualquer janela do navegador.

Parabéns! Você acabou de implantar um aplicativo empacotado em uma imagem de contêiner no Cloud Run. O Cloud Run escalona de maneira automática e horizontal a imagem do contêiner para processar as solicitações recebidas, depois reduz o escalonamento quando a demanda diminui. No seu ambiente, você paga apenas pela CPU, memória e rede consumidas durante o processamento de solicitações.

Neste laboratório, você usou a linha de comando gcloud. O Cloud Run também está disponível no console do Cloud.

• No Menu de navegação, na seção "Sem servidor", clique em Cloud Run. Você vai encontrar seu serviço helloworld na lista.

Tarefa 5: limpeza

O Cloud Run não gera custos quando o serviço não está em uso, mas você ainda vai receber cobranças pelo armazenamento da imagem de contêiner que você criou.

1. Para evitar cobranças, exclua seu projeto do GCP para interromper o faturamento de todos os recursos usados ou exclua sua imagem helloworld usando este comando:

gcloud container images delete gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld

2. Quando for solicitado que você prossiga, digite Y e pressione Enter.

3. Para excluir o serviço do Cloud Run, use este comando:

gcloud run services delete helloworld --region={{{ project_0.default_region| "Region" }}}

4. Quando for solicitado que você prossiga, digite Y e pressione Enter.

Parabéns!

Você concluiu este laboratório!

O Google Cloud Run e os serviços de app do Azure são serviços de computação sem servidor que permitem que os desenvolvedores executem aplicativos conteinerizados de maneira escalonável e econômica. No entanto, há algumas distinções entre esses dois serviços.

Aqui estão algumas das principais semelhanças e diferenças:

Semelhanças:

• Ambos são serviços de computação totalmente gerenciados, o que significa que o provedor de nuvem cuida da maior parte da infraestrutura.
• Os dois usam a conteinerização para empacotar aplicativos.
• Ambos são compatíveis com contêineres Docker como formato de implantação.
• Os dois serviços são compatíveis com Python, .NET, Java, Ruby, Node.js e PHP.
• Ambos os serviços podem ser escalonados verticalmente de forma automática, de acordo com a demanda.
• Os dois permitem a implementação do comando “build” na interface de linha de comando (CLI) correspondente.

Diferenças:

• Os processos de ativação do Cloud Run e do Azure são diferentes, já que neste último é preciso criar uma instância de um serviço de app para criar e fazer upload do código.
• Para enviar uma imagem conteinerizada no Cloud Run, você pode executar todas as etapas em uma instrução de linha de comando. No Azure, você precisa primeiro criar um Container Registry da plataforma para conseguir enviar a imagem.
• A automação é implementada de forma diferente nos dois serviços. No Cloud Run, ela é ativada por padrão. No Azure, você precisa ativar a automação manualmente ou estabelecer regras de dimensionamento para que a ativação seja automática.
• Ambos os serviços trabalham com as linguagens de programação mais conhecidas e são compatíveis com linguagens específicas como GO, mas no caso dos serviços de app do Azure os aplicativos são executados no .NET Core.

Finalize o laboratório

Clique em Terminar o laboratório após a conclusão. O Google Cloud Ensina remove os recursos usados e limpa a conta por você.

Você vai poder avaliar sua experiência no laboratório. Basta selecionar o número de estrelas, digitar um comentário e clicar em Enviar.

O número de estrelas indica o seguinte:

• 1 estrela = muito insatisfeito
• 2 estrelas = insatisfeito
• 3 estrelas = neutro
• 4 estrelas = satisfeito
• 5 estrelas = muito satisfeito

Feche a caixa de diálogo se não quiser enviar feedback.

Para enviar seu feedback, fazer sugestões ou correções, use a guia Suporte.

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