Guia de início rápido: compilar e implantar

Nesta página, mostramos como criar um aplicativo Hello World simples, empacotá-lo em uma imagem de contêiner, carregar a imagem do contêiner no Container Registry e, em seguida, implantar a imagem do contêiner no Cloud Run. O exemplo é mostrado em várias linguagens, mas é possível usar outras além das mostradas.

Também é possível seguir este guia de início rápido com uma conta de demonstração no Qwiklabs.

Antes de começar

1. Faça login na sua conta do Google.

   Se você ainda não tiver uma, inscreva-se.

2. No Console do Cloud, na página do seletor de projetos, selecione ou crie um projeto do Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar a página do seletor de projetos

3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud. Saiba como confirmar se a cobrança está ativada para o seu projeto.

4. Instale e inicialize o SDK do Cloud..

Como gravar o aplicativo de amostra

Para instruções sobre como criar um exemplo do aplicativo hello world que é executado no Cloud Run, clique na guia da sua linguagem:

Go

1. Crie um novo diretório com o nome helloworld e altere o diretório nele:

   mkdir helloworld
   cd helloworld
   

2. Inicialize um arquivo go.mod para declarar o módulo go (em inglês):

   run/helloworld/go.mod

   Ver no GitHub (em inglês)

   module github.com/GoogleCloudPlatform/golang-samples/run/helloworld
   
   go 1.13
   

3. Crie um novo arquivo chamado main.go e cole o código a seguir nele:

   run/helloworld/main.go

   Ver no GitHub (em inglês) Feedback

   
   // Sample run-helloworld is a minimal Cloud Run service.
   package main
   
   import (
   	"fmt"
   	"log"
   	"net/http"
   	"os"
   )
   
   func main() {
   	log.Print("starting server...")
   	http.HandleFunc("/", handler)
   
   	// Determine port for HTTP service.
   	port := os.Getenv("PORT")
   	if port == "" {
   		port = "8080"
   		log.Printf("defaulting to port %s", port)
   	}
   
   	// Start HTTP server.
   	log.Printf("listening on port %s", port)
   	if err := http.ListenAndServe(":"+port, nil); err != nil {
   		log.Fatal(err)
   	}
   }
   
   func handler(w http.ResponseWriter, r *http.Request) {
   	name := os.Getenv("NAME")
   	if name == "" {
   		name = "World"
   	}
   	fmt.Fprintf(w, "Hello %s!\n", name)
   }
   

   Esse código cria um servidor da Web básico que realiza detecções na porta definida pela variável de ambiente PORT.

O app está concluído, pronto para ficar em contêiner e ser enviado ao Container Registry.

Node.js

1. Crie um novo diretório com o nome helloworld e altere o diretório nele:

   mkdir helloworld
   cd helloworld
   

2. Crie um arquivo package.json com os seguintes conteúdos:

   run/helloworld/package.json

   Ver no GitHub (em inglês) Feedback

   {
     "name": "helloworld",
     "description": "Simple hello world sample in Node",
     "version": "1.0.0",
     "private": true,
     "main": "index.js",
     "scripts": {
       "start": "node index.js",
       "test": "mocha test/index.test.js --exit",
       "system-test": "NAME=Cloud test/runner.sh mocha test/system.test.js --timeout=30000",
       "lint": "eslint '**/*.js'",
       "fix": "eslint --fix '**/*.js'"
     },
     "author": "Google LLC",
     "license": "Apache-2.0",
     "dependencies": {
       "express": "^4.17.1"
     },
     "devDependencies": {
       "got": "^11.0.0",
       "mocha": "^8.0.0",
       "supertest": "^4.0.2"
     }
   }
   

3. No mesmo diretório, crie um arquivo index.js e copie as seguintes linhas nele:

   run/helloworld/index.js

   Ver no GitHub (em inglês) Feedback

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

   Esse código cria um servidor da Web básico que realiza detecções na porta definida pela variável de ambiente PORT.

O app está concluído, pronto para ficar em contêiner e ser enviado ao Container Registry.

Python

1. Crie um novo diretório com o nome helloworld e altere o diretório nele:

   mkdir helloworld
   cd helloworld
   

2. Crie um arquivo chamado main.py e cole o seguinte código nele:

   run/helloworld/main.py

   Ver no GitHub (em inglês) Feedback

   import os
   
   from flask import Flask
   
   app = Flask(__name__)
   
   @app.route('/')
   def hello_world():
       name = os.environ.get('NAME', 'World')
       return 'Hello {}!'.format(name)
   
   if __name__ == "__main__":
       app.run(debug=True, host='0.0.0.0', port=int(os.environ.get('PORT', 8080)))

   Esse código responde às solicitações com a saudação "Hello World". A manipulação de HTTP é feita por um servidor da Web Gunicorn no contêiner. Quando invocado diretamente para uso local, este código cria um servidor da Web básico que atende na porta definida pela variável de ambiente PORT.

O app está concluído, pronto para ficar em contêiner e ser enviado ao Container Registry.

Java

Crie um aplicativo Spring Boot.

1. No console, crie um novo projeto da Web vazio usando os comandos cURL e descompactar:

   curl https://start.spring.io/starter.zip \
       -d dependencies=web \
       -d javaVersion=1.8 \
       -d bootVersion=2.1.3.RELEASE \
       -d name=helloworld \
       -d artifactId=helloworld \
       -d baseDir=helloworld \
       -o helloworld.zip
   unzip helloworld.zip
   cd helloworld
   

   Isso cria um projeto Spring Boot.

2. Atualize a classe HelloworldApplication em src/main/java/com/example/helloworld/HelloworldApplication.java adicionando um @RestController para processar o mapeamento / e adicione também um campo @Value para fornecer a variável de ambiente NAME:

   run/helloworld/src/main/java/com/example/helloworld/HelloworldApplication.java

   Ver no GitHub (em inglês) Feedback

   
   package com.example.helloworld;
   
   import org.springframework.beans.factory.annotation.Value;
   import org.springframework.boot.SpringApplication;
   import org.springframework.boot.autoconfigure.SpringBootApplication;
   import org.springframework.web.bind.annotation.GetMapping;
   import org.springframework.web.bind.annotation.RestController;
   
   @SpringBootApplication
   public class HelloworldApplication {
   
     @Value("${NAME:World}")
     String name;
   
     @RestController
     class HelloworldController {
       @GetMapping("/")
       String hello() {
         return "Hello " + name + "!";
       }
     }
   
     public static void main(String[] args) {
       SpringApplication.run(HelloworldApplication.class, args);
     }
   }

3. Configure a porta do servidor para ser definida pela variável de ambiente PORT em application.properties:

   run/helloworld/src/main/resources/application.properties

   Ver no GitHub (em inglês) Feedback

   server.port=${PORT:8080}

Esse código cria um servidor da Web básico que realiza detecções na porta definida pela variável de ambiente PORT.

O app está concluído, pronto para ficar em contêiner e ser enviado ao Container Registry.

Para implantar o Java no Cloud Run com outros frameworks, revise as amostras Knative para Spark e Vert.x.

C#

1. Instale o SDK do .NET Core 3.1. Observe que precisamos fazer isso para criar o novo projeto da Web apenas na próxima etapa: o Dockerfile, descrito posteriormente, carregará todas as dependências no contêiner.

2. No console, crie um novo projeto da Web vazio usando o comando dotnet:

   dotnet new web -o helloworld-csharp
   

3. Altere o diretório para helloworld-csharp.

4. Atualize a definição de CreateHostBuilder em Program.cs para detectar a porta definida pela variável de ambiente PORT:

   docs/serving/samples/hello-world/helloworld-csharp/Program.cs

   using System;
   using Microsoft.AspNetCore.Hosting;
   using Microsoft.Extensions.Hosting;
   
   namespace helloworld_csharp
   {
       public class Program
       {
           public static void Main(string[] args)
           {
               CreateHostBuilder(args).Build().Run();
           }
   
           public static IHostBuilder CreateHostBuilder(string[] args)
           {
               string port = Environment.GetEnvironmentVariable("PORT") ?? "8080";
               string url = String.Concat("http://0.0.0.0:", port);
   
               return Host.CreateDefaultBuilder(args)
                   .ConfigureWebHostDefaults(webBuilder =>
                   {
                       webBuilder.UseStartup<Startup>().UseUrls(url);
                   });
           }
       }
   }

   Esse código cria um servidor da Web básico que realiza detecções na porta definida pela variável de ambiente PORT.

5. Crie um arquivo chamado Startup.cs e cole o seguinte código nele:

   docs/serving/samples/hello-world/helloworld-csharp/Startup.cs

   using System;
   using Microsoft.AspNetCore.Builder;
   using Microsoft.AspNetCore.Hosting;
   using Microsoft.AspNetCore.Http;
   using Microsoft.Extensions.DependencyInjection;
   using Microsoft.Extensions.Hosting;
   
   namespace helloworld_csharp
   {
       public class Startup
       {
           // This method gets called by the runtime. Use this method to add services to the container.
           // For more information on how to configure your application, visit https://go.microsoft.com/fwlink/?LinkID=398940
           public void ConfigureServices(IServiceCollection services)
           {
           }
   
           // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
           public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
           {
               if (env.IsDevelopment())
               {
                   app.UseDeveloperExceptionPage();
               }
   
               app.UseRouting();
   
               app.UseEndpoints(endpoints =>
               {
                   endpoints.MapGet("/", async context =>
                   {
                       var target = Environment.GetEnvironmentVariable("TARGET") ?? "World";
                       await context.Response.WriteAsync($"Hello {target}!\n");
                   });
               });
           }
       }
   }

   Esse código responde às solicitações com a saudação "Hello World".

O app está concluído, pronto para ficar em contêiner e ser enviado ao Container Registry.

PHP

1. Crie um novo diretório com o nome helloworld-php e altere o diretório nele:

   mkdir helloworld-php
   cd helloworld-php
   

2. Crie um arquivo chamado index.php e cole o seguinte código nele:

   docs/serving/samples/hello-world/helloworld-php/index.php

   <?php
   $target = getenv('TARGET', true) ?: 'World';
   echo sprintf("Hello %s!", $target);
   

   Esse código responde às solicitações com a saudação "Hello World". O processamento de HTTP é feito por um servidor da Web Apache no contêiner.

O app está concluído, pronto para ficar em contêiner e ser enviado ao Container Registry.

Ruby

1. Crie um novo diretório com o nome helloworld e altere o diretório nele:

   mkdir helloworld
   cd helloworld
   

2. Crie um arquivo chamado app.rb e cole o seguinte código nele:

   run/helloworld/app.rb

   Ver no GitHub (em inglês) Feedback

   require "sinatra"
   
   set :bind, "0.0.0.0"
   port = ENV["PORT"] || "8080"
   set :port, port
   
   get "/" do
     name = ENV["NAME"] || "World"
     "Hello #{name}!"
   end

   Esse código cria um servidor da Web básico que realiza detecções na porta definida pela variável de ambiente PORT.

3. Crie um nome de arquivo Gemfile e copie o seguinte nele:

   run/helloworld/Gemfile

   Ver no GitHub (em inglês) Feedback

   source "https://rubygems.org"
   
   gem "sinatra", "~>2.0"
   
   group :test do
     gem "rack-test"
     gem "rest-client"
     gem "rspec"
     gem "rspec_junit_formatter"
     gem "rubysl-securerandom"
   end
   

4. Se você não tiver o Bundler 2.0 ou superior instalado, instale o Bundler.

5. Gere um arquivo Gemfile.lock executando:

   bundle install

O app está concluído, pronto para ficar em contêiner e ser enviado ao Container Registry.

Shell

1. Crie um novo diretório com o nome helloworld-shell e altere o diretório nele:

   mkdir helloworld-shell
   cd helloworld-shell
   

2. Crie um arquivo script.sh com os seguintes conteúdos:

   helloworld-shell/script.sh

   Ver no GitHub (em inglês) Feedback

   
   set -e
   echo "Hello ${NAME:-World}!"
   

   Para executar esse script de shell em todas as solicitações recebidas, esse exemplo usa um pequeno programa Go que inicia um servidor da Web básico e realiza detecções na porta definida pela variável de ambiente PORT.

3. Crie um arquivo invoke.go com os seguintes conteúdos:

   helloworld-shell/invoke.go

   Ver no GitHub (em inglês) Feedback

   
   // Sample helloworld-shell is a Cloud Run shell-script-as-a-service.
   package main
   
   import (
   	"log"
   	"net/http"
   	"os"
   	"os/exec"
   )
   
   func main() {
   	http.HandleFunc("/", scriptHandler)
   
   	// Determine port for HTTP service.
   	port := os.Getenv("PORT")
   	if port == "" {
   		port = "8080"
   		log.Printf("Defaulting to port %s", port)
   	}
   
   	// Start HTTP server.
   	log.Printf("Listening on port %s", port)
   	if err := http.ListenAndServe(":"+port, nil); err != nil {
   		log.Fatal(err)
   	}
   }
   
   func scriptHandler(w http.ResponseWriter, r *http.Request) {
   	cmd := exec.CommandContext(r.Context(), "/bin/sh", "script.sh")
   	cmd.Stderr = os.Stderr
   	out, err := cmd.Output()
   	if err != nil {
   		w.WriteHeader(500)
   	}
   	w.Write(out)
   }
   

O app está concluído, pronto para ficar em contêiner e ser enviado ao Container Registry.

Outra

O Cloud Run é compatível com a maioria das linguagens. Para amostras simples em linguagens diferentes das que aparecem nesta tabela, consulte estes links (em inglês):

• Kotlin
• Swift
• Dart
• Rust
• Elixir
• C++
• Deno
• Outra

No entanto, em todas essas amostras, ignore e omita o material sobre service.yaml e o Docker Hub porque o Cloud Run não utiliza isso.

Como colocar um aplicativo em contêiner e enviá-lo ao Container Registry

Para contentorizar o aplicativo de amostra, crie um novo arquivo chamado Dockerfile no mesmo diretório dos arquivos de origem e copie o seguinte conteúdo:

Go

run/helloworld/Dockerfile

Ver no GitHub (em inglês) Feedback

# Use the offical golang image to create a binary.
# This is based on Debian and sets the GOPATH to /go.
# https://hub.docker.com/_/golang
FROM golang:1.15-buster as builder

# Create and change to the app directory.
WORKDIR /app

# Retrieve application dependencies.
# This allows the container build to reuse cached dependencies.
# Expecting to copy go.mod and if present go.sum.
COPY go.* ./
RUN go mod download

# Copy local code to the container image.
COPY . ./

# Build the binary.
RUN go build -mod=readonly -v -o server

# Use the official Debian slim image for a lean production container.
# https://hub.docker.com/_/debian
# https://docs.docker.com/develop/develop-images/multistage-build/#use-multi-stage-builds
FROM debian:buster-slim
RUN set -x && apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -y \
    ca-certificates && \
    rm -rf /var/lib/apt/lists/*

# Copy the binary to the production image from the builder stage.
COPY --from=builder /app/server /app/server

# Run the web service on container startup.
CMD ["/app/server"]

Adicione um arquivo .dockerignore para excluir arquivos da imagem do contêiner.

run/helloworld/.dockerignore

Ver no GitHub (em inglês) Feedback

# The .dockerignore file excludes files from the container build process.
#
# https://docs.docker.com/engine/reference/builder/#dockerignore-file

# Exclude locally vendored dependencies.
vendor/

# Exclude "build-time" ignore files.
.dockerignore
.gcloudignore

# Exclude git history and configuration.
.gitignore

Node.js

run/helloworld/Dockerfile

Ver no GitHub (em inglês) Feedback

# Use the official lightweight Node.js 10 image.
# https://hub.docker.com/_/node
FROM node:12-slim

# Create and change to the app directory.
WORKDIR /usr/src/app

# Copy application dependency manifests to the container image.
# A wildcard is used to ensure copying both package.json AND package-lock.json (when available).
# Copying this first prevents re-running npm install on every code change.
COPY package*.json ./

# Install production dependencies.
# If you add a package-lock.json, speed your build by switching to 'npm ci'.
# RUN npm ci --only=production
RUN npm install --only=production

# Copy local code to the container image.
COPY . ./

# Run the web service on container startup.
CMD [ "node", "index.js" ]

Adicione um arquivo .dockerignore para excluir arquivos da imagem do contêiner.

run/helloworld/.dockerignore

Ver no GitHub (em inglês) Feedback

Dockerfile
.dockerignore
node_modules
npm-debug.log

Python

O Dockerfile do Python inicia um servidor da Web do Gunicorn que detecta na porta definida pela variável de ambiente PORT:

run/helloworld/Dockerfile

Ver no GitHub (em inglês) Feedback

# Use the official lightweight Python image.
# https://hub.docker.com/_/python
FROM python:3.8-slim

# Allow statements and log messages to immediately appear in the Knative logs
ENV PYTHONUNBUFFERED True

# Copy local code to the container image.
ENV APP_HOME /app
WORKDIR $APP_HOME
COPY . ./

# Install production dependencies.
RUN pip install Flask gunicorn

# Run the web service on container startup. Here we use the gunicorn
# webserver, with one worker process and 8 threads.
# For environments with multiple CPU cores, increase the number of workers
# to be equal to the cores available.
CMD exec gunicorn --bind :$PORT --workers 1 --threads 8 --timeout 0 main:app

Adicione um arquivo .dockerignore para excluir arquivos da imagem do contêiner.

run/helloworld/.dockerignore

Ver no GitHub Feedback

Dockerfile
README.md
*.pyc
*.pyo
*.pyd
__pycache__
.pytest_cache

Java

run/helloworld/Dockerfile

Ver no GitHub (em inglês) Feedback

# Use the official maven/Java 8 image to create a build artifact.
# https://hub.docker.com/_/maven
FROM maven:3.6-jdk-11 as builder

# Copy local code to the container image.
WORKDIR /app
COPY pom.xml .
COPY src ./src

# Build a release artifact.
RUN mvn package -DskipTests

# Use AdoptOpenJDK for base image.
# It's important to use OpenJDK 8u191 or above that has container support enabled.
# https://hub.docker.com/r/adoptopenjdk/openjdk8
# https://docs.docker.com/develop/develop-images/multistage-build/#use-multi-stage-builds
FROM adoptopenjdk/openjdk11:alpine-slim

# Copy the jar to the production image from the builder stage.
COPY --from=builder /app/target/helloworld-*.jar /helloworld.jar

# Run the web service on container startup.
CMD ["java", "-Djava.security.egd=file:/dev/./urandom", "-jar", "/helloworld.jar"]

Adicione um arquivo .dockerignore para excluir arquivos da imagem do contêiner.

run/helloworld/.dockerignore

Ver no GitHub (em inglês) Feedback

Dockerfile
.dockerignore
target/

C#

docs/serving/samples/hello-world/helloworld-csharp/Dockerfile

# Use Microsoft's official build .NET image.
# https://hub.docker.com/_/microsoft-dotnet-core-sdk/
FROM mcr.microsoft.com/dotnet/core/sdk:3.1-alpine AS build
WORKDIR /app

# Install production dependencies.
# Copy csproj and restore as distinct layers.
COPY *.csproj ./
RUN dotnet restore

# Copy local code to the container image.
COPY . ./
WORKDIR /app

# Build a release artifact.
RUN dotnet publish -c Release -o out

# Use Microsoft's official runtime .NET image.
# https://hub.docker.com/_/microsoft-dotnet-core-aspnet/
FROM mcr.microsoft.com/dotnet/core/aspnet:3.1-alpine AS runtime
WORKDIR /app
COPY --from=build /app/out ./

# Run the web service on container startup.
ENTRYPOINT ["dotnet", "helloworld-csharp.dll"]

Para excluir arquivos produzidos por meio de operações de build dotnet locais do upload para o Cloud Build, adicione um arquivo .gcloudignore no mesmo diretório dos arquivos de origem do aplicativo de amostra:

run/.gcloudignore

**/obj/
**/bin/

Se essas linhas estiverem em um arquivo .gitignore, pule esta etapa porque .gitignore é uma fonte padrão para a configuração .gcloudignore.

Copie essas linhas para um arquivo .dockerignore para builds de contêiner local com a CLI docker.

PHP

O Dockerfile do PHP inicia um servidor da Web Apache que detecta na porta definida pela variável de ambiente PORT:

docs/serving/samples/hello-world/helloworld-php/Dockerfile

# Use the official PHP 7.3 image.
# https://hub.docker.com/_/php
FROM php:7.3-apache

# Copy local code to the container image.
COPY index.php /var/www/html/

# Use the PORT environment variable in Apache configuration files.
RUN sed -i 's/80/${PORT}/g' /etc/apache2/sites-available/000-default.conf /etc/apache2/ports.conf

# Configure PHP for development.
# Switch to the production php.ini for production operations.
# RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"
# https://hub.docker.com/_/php#configuration
RUN mv "$PHP_INI_DIR/php.ini-development" "$PHP_INI_DIR/php.ini"

Adicione um arquivo .dockerignore para excluir arquivos da imagem do contêiner.

docs/serving/samples/hello-world/helloworld-php/.dockerignore

Dockerfile
README.md
vendor

Ruby

run/helloworld/Dockerfile

Ver no GitHub (em inglês) Feedback

# Use the official lightweight Ruby image.
# https://hub.docker.com/_/ruby
FROM ruby:2.7-slim

# Install production dependencies.
WORKDIR /usr/src/app
COPY Gemfile Gemfile.lock ./
ENV BUNDLE_FROZEN=true
RUN gem install bundler && bundle install --without test

# Copy local code to the container image.
COPY . ./

# Run the web service on container startup.
CMD ["ruby", "./app.rb"]

Adicione um arquivo .dockerignore para excluir arquivos da imagem do contêiner.

run/helloworld/.dockerignore

Ver no GitHub (em inglês) Feedback

Dockerfile
README.md
.ruby-version
.bundle/
vendor/

Shell

helloworld-shell/Dockerfile

Ver no GitHub (em inglês) Feedback

# Use the offical golang image to create a binary.
# This is based on Debian and sets the GOPATH to /go.
# https://hub.docker.com/_/golang
FROM golang:1.14-buster as builder

# Create and change to the app directory.
WORKDIR /app

# Retrieve application dependencies.
# This allows the container build to reuse cached dependencies.
# Expecting to copy go.mod and if present go.sum.
COPY go.* ./
RUN go mod download

# Copy local code to the container image.
COPY invoke.go ./

# Build the binary.
RUN go build -mod=readonly -v -o server

# Use the official Debian slim image for a lean production container.
# https://hub.docker.com/_/debian
# https://docs.docker.com/develop/develop-images/multistage-build/#use-multi-stage-builds
FROM debian:buster-slim
RUN set -x && apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -y \
    --no-install-recommends \
    ca-certificates && \
    rm -rf /var/lib/apt/lists/*

# Copy the binary to the production image from the builder stage.
COPY --from=builder /app/server /app/server
COPY script.sh ./

# Run the web service on container startup.
CMD ["/app/server"]

Outra

O Cloud Run é compatível com a maioria das linguagens. Para amostras do Dockerfiles em linguagens diferentes das que aparecem na tabela, consulte estes links (em inglês):

• Kotlin
• Swift
• Dart
• Rust
• Elixir
• C++
• Deno
• Outra

No entanto, nessas amostras, ignore e omita o material sobre service.yaml e o Docker Hub porque o Cloud Run não os usa.

Compile a imagem de contêiner usando o Cloud Build. Para isso, execute o comando a seguir no diretório que contém seu Dockerfile:

gcloud builds submit --tag gcr.io/PROJECT-ID/helloworld

em que PROJECT-ID é o ID do projeto do GCP. É possível consegui-lo executando gcloud config get-value project.

Após a conclusão, você verá uma mensagem de "SUCESSO" contendo o nome da imagem (gcr.io/PROJECT-ID/helloworld). A imagem é armazenada no Container Registry e pode ser reutilizada, se você quiser.

Como implantar no Cloud Run

Para implantar a imagem do contêiner, siga estas etapas:

1. Implante usando o comando a seguir:

   gcloud run deploy --image gcr.io/PROJECT-ID/helloworld --platform managed

   Substitua PROJECT-ID pelo ID do projeto do GCP. Para ver o ID do projeto, execute o comando gcloud config get-value project.

   1. O nome do serviço será solicitado: pressione Enter para aceitar o nome padrão, helloworld.
   2. Você receberá uma solicitação de região: selecione a região de sua escolha, por exemplo, us-central1.
   3. Você receberá uma solicitação para permitir chamadas não autenticadas: responda y.

   Aguarde alguns instantes até a conclusão da implantação. Em caso de sucesso, a linha de comando exibe o URL de serviço.

2. Consulte o contêiner implantado. Para isso, abra o URL de serviço em um navegador da Web.

Locais do Cloud Run

O Cloud Run é regional, o que significa que a infraestrutura que executa seus serviços do Cloud Run está localizada em uma região específica e é gerenciada pelo Google para estar disponível de maneira redundante em todas as zonas da região.

Atender aos seus requisitos de latência, disponibilidade ou durabilidade são os principais fatores para selecionar a região em que seus serviços do Cloud Run são executados. Geralmente, é possível selecionar a região mais próxima de seus usuários, mas considere a localização dos outros produtos do Google Cloud usados pelo serviço do Cloud Run. O uso de produtos do Google Cloud em vários locais pode afetar a latência e o custo do serviço.

O Cloud Run está disponível nas regiões a seguir:

Sujeitas aos preços do nível 1

• asia-east1 (Taiwan)
• asia-northeast1 (Tóquio)
• asia-northeast2 (Osaka)
• europe-north1 (Finlândia)
• europe-west1 (Bélgica)
• europe-west4 (Países Baixos)
• us-central1 (Iowa)
• us-east1 (Carolina do Sul)
• us-east4 (Norte da Virgínia)
• us-west1 (Oregon)

Sujeitas aos preços do nível 2

• asia-southeast1 (Singapura)
• australia-southeast1 (Sydney)
• northamerica-northeast1 (Montreal)

Não é possível usar o recurso de mapeamento de domínio do Cloud Run (totalmente gerenciado) para serviços em asia-northeast2, australia-southeast1 ou northamerica-northeast1. Use o Cloud Load Balancing com um NEG sem servidor para correlacionar um domínio personalizado a serviços do Cloud Run totalmente gerenciados nessas regiões.

Se você já criou um serviço do Cloud Run, poderá ver a região no painel do Cloud Run no Console do Cloud.

OK

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 seu contêiner para lidar com as solicitações recebidas, e reduz o escalonamento quando a demanda diminui. Você paga apenas pela CPU, memória e rede consumida durante o processamento da solicitação.

Limpar

Como remover seu projeto de teste

Ainda que o Cloud Run não gere custos quando o serviço não estiver em uso, é possível receber cobranças pelo armazenamento da imagem do contêiner no Container Registry. É possível excluir sua imagem ou excluir seu projeto do Cloud para evitar cobranças. A exclusão do projeto do Cloud interrompe o faturamento de todos os recursos usados nesse projeto.

Cuidado: excluir um projeto tem os seguintes efeitos:
• Tudo no projeto é excluído. Se você tiver usado um projeto atual para seguir este tutorial, a exclusão dele incluirá quaisquer outras ações feitas no projeto.
• Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um código do projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, exclua recursos específicos do projeto, em vez de excluir o projeto inteiro.
1. No Console do Cloud, acesse a página Gerenciar recursos:

   Acessar a página "Gerenciar recursos"

2. Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir .
3. Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluí-lo.

A seguir

Para mais informações sobre como compilar um contêiner da origem do código e enviar para o Container Registry, consulte estes tópicos:

• Como desenvolver serviços do Cloud Run
• Como criar contêineres