Implantar um site com o Cloud Run

1. Antes de começar

Administrar sites pode ser trabalhoso. É preciso criar e gerenciar instâncias de máquina virtual (VM), clusters, pods, serviços e muito mais. Isso é bom para apps maiores e com vários níveis, mas se você estiver apenas tentando implantar e tornar seu site visível, isso vai gerar muita sobrecarga.

Com o Cloud Run, a implementação do Knative do Google Cloud, é possível gerenciar e implantar seu site sem o overhead necessário para implantações baseadas em VM ou no Kubernetes. Além de simplificar o gerenciamento, essa abordagem também permite a redução da escala a zero quando o site não está recebendo solicitações.

Neste codelab, você começa com uma imagem do Docker criada pelo Cloud Build, que é acionada no Cloud Shell. Em seguida, você implanta essa imagem no Cloud Run com um comando no Cloud Shell.

Pré-requisitos

• Familiaridade geral com o Docker (consulte a seção Introdução do site do Docker).

O que você vai aprender

• Criar uma imagem do Docker com o Cloud Build e fazer o upload dela para o gcr.io
• Implantar imagens do Docker no Cloud Run
• Gerenciar implantações do Cloud Run
• Como configurar um endpoint para um app no Cloud Run

O que você vai criar

• Um site estático executado em um contêiner do Docker
• Uma versão desse contêiner que fica no Container Registry
• Uma implantação do Cloud Run para seu site estático

O que é necessário

• Uma Conta do Google com acesso administrativo para criar projetos ou um projeto com o papel de proprietário do projeto

2. Configuração do ambiente

Configuração de ambiente personalizada

Se você ainda não tem uma Conta do Google, crie uma. Em seguida, faça login no console do Google Cloud e clique em Project > Create project.

Guarde o ID do projeto, que é preenchido automaticamente no nome do projeto. O ID do projeto é um nome exclusivo em todos os projetos do Google Cloud. Portanto, o nome na captura de tela já foi usado e não vai funcionar para você. Depois, ele será chamado de PROJECT_ID.

Em seguida, ative o faturamento no console do Cloud para usar os recursos do Google Cloud e ativar a API Cloud Run.

ativar a API Cloud Run

Clique em Menu de navegação ☰ > APIs e serviços > Painel > Ativar APIs e serviços. .

Pesquise "API Cloud Run" e clique em API Cloud Run > Ativar.

A execução por meio deste codelab não vai custar mais do que alguns dólares, mas pode ser mais se você decidir usar mais recursos ou se deixá-los em execução. Consulte a seção Limpeza no final. Para saber mais, consulte Preços.

Novos usuários do Google Cloud estão qualificados para um teste sem custo financeiro de US$300.

Cloud Shell

Embora o Google Cloud e o Cloud Run possam ser operados remotamente no seu laptop, você vai usar o Cloud Shell, um ambiente de linha de comando executado no Google Cloud. O ambiente é pré-configurado com todas as bibliotecas e frameworks de cliente necessários.

O Cloud Shell é uma máquina virtual com base em Debian que contém todas as ferramentas de desenvolvimento necessárias. Ela oferece um diretório principal persistente de 5 GB, além de ser executada no Google Cloud. Isso aprimora o desempenho e a autenticação da rede. Isso significa que tudo que você precisa para este codelab é um navegador (sim, funciona em um Chromebook).

1. Para ativar o Cloud Shell no Console do Cloud, basta clicar em Ativar o Cloud Shell . Leva apenas alguns instantes para provisionar e se conectar ao ambiente.

Depois de se conectar ao Cloud Shell, você já estará autenticado e o projeto estará configurado com seu PROJECT_ID.

gcloud auth list

Resposta ao comando

Credentialed accounts:
 - <myaccount>@<mydomain>.com (active)

Observação: a ferramenta de linha de comando gcloud vem pré-instalada no Cloud Shell, e você terá certeza de que a ferramenta aceita a conclusão da guia. Para mais informações, consulte a visão geral da ferramenta de linha de comando gcloud.

gcloud config list project

Resposta ao comando

[core]
project = <PROJECT_ID>

Se, por algum motivo, o projeto não estiver definido, basta emitir o seguinte comando:

gcloud config set project <PROJECT_ID>

Quer encontrar seu PROJECT_ID? Veja qual ID você usou nas etapas de configuração ou procure-o no painel do Console do Cloud:

O Cloud Shell também define algumas variáveis de ambiente por padrão, o que pode ser útil ao executar comandos futuros.

echo $GOOGLE_CLOUD_PROJECT

Resposta ao comando

<PROJECT_ID>

2. Defina a zona padrão e a configuração do projeto:

gcloud config set compute/zone us-central1-f

É possível escolher uma variedade de zonas diferentes. Para mais informações, consulte Regiões e zonas.

Observação: quando você executava o gcloud na sua própria máquina, as definições de configuração permaneceriam entre as sessões. No Cloud Shell, você precisará configurá-lo para cada nova sessão ou reconexão.

3. clonar o repositório de origem

Como você está implantando um site que já existe, basta clonar a origem do repositório para se concentrar na criação de imagens do Docker e na implantação no Cloud Run.

Execute os comandos abaixo para clonar o repositório na sua instância do Cloud Shell e acessar o diretório correto. Você também vai instalar as dependências do Node.js para testar o app antes da implantação.

cd ~
git clone https://github.com/googlecodelabs/monolith-to-microservices.git
cd ~/monolith-to-microservices
./setup.sh

Isso clona seu repositório, muda para o diretório e instala as dependências necessárias para executar o app localmente. A execução do script pode levar alguns minutos.

Faça a devida diligência e teste o app. Execute o seguinte comando para iniciar o servidor da Web:

cd ~/monolith-to-microservices/monolith
npm start

Saída:

Monolith listening on port 8080!

Para conferir o app, clique em Visualização na Web e selecione Visualizar na porta 8080.

Isso abre uma nova janela onde você pode conferir a Fancy Store em ação.

Você pode fechar esta janela depois de acessar o site. Para interromper o processo do servidor da Web, pressione CONTROL+C (Command+C no Macintosh) na janela do terminal.

4. criar o contêiner do Docker com o Cloud Build

Agora que os arquivos de origem estão prontos, é hora de colocar o app no Docker.

Normalmente, você precisa seguir uma abordagem de duas etapas: criar um contêiner do Docker e enviá-lo para um registro, onde a imagem é armazenada e pode ser extraída pelo GKE. No entanto, você pode facilitar sua vida usando o Cloud Build para criar o contêiner do Docker e colocar a imagem no Container Registry com um único comando. Para conferir o processo manual de criação e envio de um Dockerfile, consulte o Guia de início rápido do Container Registry.

O Cloud Build compacta e envia os arquivos do diretório para um bucket do Cloud Storage. Em seguida, todos os arquivos do bucket e o Dockerfile no mesmo diretório são usados para executar o processo de build no Docker. Como você especificou a flag --tag com o host como gcr.io para a imagem do Docker, a imagem resultante será enviada ao Container Registry.

Primeiro, verifique se a API Cloud Build está ativada. Para isso, execute o seguinte comando:

gcloud services enable cloudbuild.googleapis.com

Depois de ativar a API, execute o seguinte comando no Cloud Shell para iniciar o processo de build:

gcloud builds submit --tag gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 .

Esse processo leva alguns minutos. Quando a compilação estiver pronta, o terminal vai mostrar o seguinte:

-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
ID                                    CREATE_TIME                DURATION  SOURCE                                                                                  IMAGES                              STATUS
1ae295d9-63cb-482c-959b-bc52e9644d53  2019-08-29T01:56:35+00:00  33S       gs://<PROJECT_ID>_cloudbuild/source/1567043793.94-abfd382011724422bf49af1558b894aa.tgz  gcr.io/<PROJECT_ID>/monolith:1.0.0  SUCCESS

Para acessar o histórico de builds ou acompanhar o processo em tempo real, acesse o console do Cloud e clique em Menu de navegação ☰ > Cloud Build > Histórico. Nela, você encontra uma lista de todos os builds anteriores, mas só vai aparecer o que você criou.

Se você clicar no ID do build, vai encontrar todos os detalhes do build, incluindo a saída do registro. Para conferir a imagem do contêiner criada, clique no link ao lado de Imagem.

5. Implantar o contêiner no Cloud Run

Agora que você já fez a conteinerização do site e enviou o contêiner para o Container Registry, é hora de implantar no Cloud Run.

Há duas abordagens de implantação no Cloud Run:

• O Cloud Run (totalmente gerenciado) é o modelo de PaaS em que todo o ciclo de vida do contêiner é gerenciado. Você vai usar essa abordagem neste codelab.
• O Cloud Run para Anthos é o Cloud Run com uma camada adicional de controle, que permite integrar clusters e pods do GKE. Para mais informações, consulte Como configurar o Cloud Run for Anthos no Google Cloud.

Os exemplos de linha de comando vão estar no Cloud Shell usando as variáveis de ambiente que você configurou anteriormente.

Linha de comando

Execute o comando a seguir para implantar o app:

gcloud run deploy --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 --platform managed 

Você vai precisar especificar em qual região quer executar. Selecione a região mais próxima a você e aceite o nome de serviço sugerido padrão (monolith).

Para fins de teste, permita solicitações não autenticadas no app. Digite y no prompt.

Verifique a implantação

Para verificar se a implantação foi criada, execute o seguinte comando. Pode levar alguns instantes para que o Pod status seja Running:

gcloud run services list

Selecione [1] Cloud Run (totalmente gerenciado).

Saída:

SERVICE   REGION    URL  LAST DEPLOYED BY          LAST DEPLOYED AT
✔  monolith  us-east1 <your url>  <your email>  2019-09-16T21:07:38.267Z

A saída mostra várias informações. Você pode conferir a implantação, o usuário que a executou (seu endereço de e-mail) e o URL para acessar o app. Parece que tudo foi criado corretamente.

Abra o URL fornecido na lista de serviços no seu navegador da Web e confira o mesmo site que você visualizou localmente.

**Observação:**também é possível conferir suas implantações do Cloud Run no console do Cloud. Clique em Menu de navegação ☰ > Cloud Run para acessar o painel com o serviço implantado.

6. Criar uma revisão com simultaneidade menor

Agora, implante o app novamente. Desta vez, ajuste um dos parâmetros.

Por padrão, os apps do Cloud Run têm o valor de simultaneidade "80". Isso significa que cada instância do contêiner processará até 80 solicitações por vez. Isso é uma grande mudança em relação ao modelo de funções como serviço (FaaS), em que uma instância processa uma solicitação por vez.

Implante novamente a mesma imagem de contêiner com um valor de simultaneidade de 1 (apenas para fins de teste) e veja o que acontece.

gcloud run deploy --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 --platform managed --concurrency 1

Responda às próximas perguntas como fez na primeira vez. Depois que o comando for concluído, verifique o Cloud Console para conferir o resultado.

No painel do Cloud Run, clique no serviço monolith para conferir os detalhes.

Clique na guia Revisões. Duas revisões serão criadas. Clique em monolith-00002 e confira os detalhes. O valor de simultaneidade vai ser reduzido para 1.

]

Essa configuração é suficiente para testes, mas, na maioria dos cenários de produção, os contêineres processam várias solicitações simultâneas.

Agora, restaure a simultaneidade original sem fazer outra implantação. Você pode definir o valor de simultaneidade como o padrão 80 ou 0, o que removerá as restrições de simultaneidade e definirá o valor máximo padrão (que é 80 no momento em que este artigo foi escrito).

Execute o seguinte comando no Cloud Shell para atualizar a revisão atual:

gcloud run deploy --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 --platform managed --concurrency 80

Você vai perceber que outra revisão foi criada, que o tráfego foi redirecionado e que a simultaneidade voltou para "80".

7. Faça mudanças no site

Sua equipe de marketing pediu que você mudasse a página inicial do site da empresa. Ela acha que o site deve oferecer mais informações sobre o que a empresa é e vende. Nesta seção, você vai adicionar um texto à página inicial para atender ao pedido da equipe de marketing.

Parece que um dos desenvolvedores já criou as alterações. O nome do arquivo atualizado é index.js.new. Basta copiar esse arquivo para index.js, e as mudanças vão aparecer na página. Siga as instruções para fazer as mudanças necessárias.

Execute os comandos a seguir, copie o arquivo atualizado para o nome de arquivo correto e imprima o conteúdo para verificar as mudanças:

cd ~/monolith-to-microservices/react-app/src/pages/Home
mv index.js.new index.js
cat ~/monolith-to-microservices/react-app/src/pages/Home/index.js

O código resultante será parecido com este:

/*
Copyright 2019 Google LLC

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

import React from "react";
import { makeStyles } from "@material-ui/core/styles";
import Paper from "@material-ui/core/Paper";
import Typography from "@material-ui/core/Typography";
const useStyles = makeStyles(theme => ({
  root: {
    flexGrow: 1
  },
  paper: {
    width: "800px",
    margin: "0 auto",
    padding: theme.spacing(3, 2)
  }
}));
export default function Home() {
  const classes = useStyles();
  return (
    <div className={classes.root}>
      <Paper className={classes.paper}>
        <Typography variant="h5">
          Fancy Fashion &amp; Style Online
        </Typography>
        <br />
        <Typography variant="body1">
          Tired of mainstream fashion ideas, popular trends and societal norms?
          This line of lifestyle products will help you catch up with the Fancy trend and express your personal style.
          Start shopping Fancy items now!
        </Typography>
      </Paper>
    </div>
  );
}

Os componentes do React foram atualizados, mas você precisa criar o app React para gerar os arquivos estáticos. Execute o comando a seguir para criar o app React e copiar no diretório público monolith:

cd ~/monolith-to-microservices/react-app
npm run build:monolith

Agora que o código está atualizado, é necessário recriar o contêiner do Docker e publicá-lo no Container Registry. Você pode usar o mesmo comando de antes, mas atualizará o rótulo da versão desta vez.

Execute este comando para acionar o Cloud Build de novo com a imagem atualizada na versão 2.0.0:

cd ~/monolith-to-microservices/monolith

#Feel free to test your application
npm start

gcloud builds submit --tag gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:2.0.0 .

Na próxima seção, você vai usar essa imagem para atualizar o app sem inatividade.

8. Atualizar o site sem inatividade

As alterações foram feitas, e a equipe de marketing adorou a nova versão. É hora de atualizar o site sem interromper o serviço para os usuários.

O Cloud Run trata cada implantação como uma nova revisão, que será ativada e depois o tráfego será redirecionado para ela.

Observação:por padrão, 100% do tráfego de entrada de um serviço é atribuído à revisão mais recente. É possível usar rotas para alocar porcentagens diferentes de tráfego para revisões específicas em um serviço.

Siga os próximos conjuntos de instruções para atualizar seu site.

Linha de comando

Na linha de comando, é possível implantar novamente o serviço para atualizar a imagem para uma nova versão com o seguinte comando:

gcloud run deploy --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:2.0.0 --platform managed

Verifique a implantação

Para validar a atualização da implantação, execute o seguinte comando:

gcloud run services describe monolith --platform managed 

A saída será semelhante ao seguinte:

apiVersion: serving.knative.dev/v1alpha1
kind: Service
metadata:
  annotations:
    client.knative.dev/user-image: gcr.io/my-cloudrun-codelab/monolith:2.0.0
...

O serviço agora está usando a versão mais recente da imagem implantada em uma nova revisão.

Para verificar as mudanças, acesse o URL externo do serviço do Cloud Run novamente e observe que o título do app foi atualizado.

Execute o comando a seguir para listar os serviços e conferir o endereço IP, caso você tenha esquecido:

gcloud run services list

O site agora mostra o texto que você adicionou ao componente da página inicial.

9. Limpar

Excluir imagens do Container Registry

Observação:se você criou outras versões, use a mesma sintaxe para excluir essas imagens também. Este codelab pressupõe que você o seguiu exatamente e tem apenas duas tags.

# Delete the container image for version 1.0.0 of our monolith
gcloud container images delete gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 --quiet

# Delete the container image for version 2.0.0 of our monolith
gcloud container images delete gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:2.0.0 --quiet

Excluir artefatos do Cloud Build do Cloud Storage

Observação:se você usou o Cloud Build para outros artefatos além dos usados neste codelab, será necessário excluir manualmente a origem em gs://<PROJECT_ID>_cloudbuild/source.

# The following command will take all source archives from all builds and delete them from cloud storage

# Run this command to print all sources:
# gcloud builds list | awk 'NR > 1 {print $4}' 

gcloud builds list | awk 'NR > 1 {print $4}' | while read line; do gsutil rm $line; done

Excluir serviço do Cloud Run

gcloud run services delete monolith --platform managed

10. Parabéns

Você implantou, escalonou e atualizou seu site com o Cloud Run.

Saiba mais

• Documentação do Docker
• Documentação do Google Kubernetes Engine
• Documentação do Cloud Build
• Documentação do Container Registry