Implantar um app no Cloud Run usando o Google Cloud Deploy

Guia de início rápido: implantar um app no Cloud Run usando o Google Cloud Deploy

Implantar um app no Cloud Run usando o Google Cloud Deploy

Nesta página, mostramos como usar o Google Cloud Deploy para fornecer uma imagem de aplicativo de amostra chamada hello a uma sequência de dois serviços do Cloud Run.

Neste guia de início rápido, você fará o seguinte:

1. Criar uma configuração do Skaffold

2. Criar arquivos de definição de serviço para dois serviços do Cloud Run.

   Esses arquivos definem os serviços e especificam a imagem de contêiner pré-criada a ser implantada.

3. Definir o pipeline de entrega do Google Cloud Deploy e os destinos de implantação, que apontam para os dois serviços.

4. Instancie o pipeline de entrega criando uma versão, que implanta automaticamente no primeiro destino.

5. Promova a versão para a segunda segmentação.

6. Veja os dois lançamentos no Console do Google Cloud.

Antes de começar

1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

2. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google 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 o seletor de projetos

3. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como verificar se o faturamento está ativado em um projeto.

4. Ative as APIs Google Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage.

   Ative as APIs

5. Instale a CLI do Google Cloud.

6. Para inicializar a CLI gcloud, execute o seguinte comando:

   gcloud init

   observação: execute a CLI gcloud no console do Google Cloud sem instalar a Google Cloud CLI. Para executar a gcloud CLI no console do Google Cloud, use o Cloud Shell .

7. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google 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 o seletor de projetos

8. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como verificar se o faturamento está ativado em um projeto.

9. Ative as APIs Google Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage.

   Ative as APIs

10. Instale a CLI do Google Cloud.

11. Para inicializar a CLI gcloud, execute o seguinte comando:

    gcloud init

    observação: execute a CLI gcloud no console do Google Cloud sem instalar a Google Cloud CLI. Para executar a gcloud CLI no console do Google Cloud, use o Cloud Shell .

Se a CLI já estiver instalada, verifique se você está executando a versão mais recente:

gcloud components update

12. Verifique se a conta de serviço padrão do Compute Engine tem permissões suficientes.

    A conta de serviço já pode ter as permissões necessárias. Essas etapas estão incluídas para projetos que desativam concessões automáticas de papéis para contas de serviço padrão.

1. Adicione o papel clouddeploy.jobRunner:

   gcloud projects add-iam-policy-binding PROJECT_ID \
       --member=serviceAccount:$(gcloud projects describe PROJECT_ID \
       --format="value(projectNumber)")[e-mail] \
       --role="roles/clouddeploy.jobRunner"
   

2. Conceda à conta de serviço de execução padrão a actAs permissão para implantar cargas de trabalho no Cloud Run:

   gcloud iam service-accounts add-iam-policy-binding $(gcloud projects describe PROJECT_ID \
       --format="value(projectNumber)")[e-mail] \
       --member=serviceAccount:$(gcloud projects describe PROJECT_ID \
       --format="value(projectNumber)")[e-mail] \
       --role="roles/iam.serviceAccountUser" \
       --project=PROJECT_ID
   

3. Adicione as permissões de desenvolvedor do Cloud Run:

   gcloud projects add-iam-policy-binding PROJECT_ID \
       --member=serviceAccount:$(gcloud projects describe PROJECT_ID \
       --format="value(projectNumber)")[e-mail] \
       --role="roles/run.developer"
   

   Se você tiver problemas para adicionar um desses papéis, entre em contato com o administrador do projeto.

Preparar a configuração do Skaffold

O Google Cloud Deploy usa o Skaffold para fornecer detalhes sobre o que implantar e como implantá-lo corretamente nos destinos separados.

Neste guia de início rápido, você cria um arquivo skaffold.yaml, que identifica o manifesto do Kubernetes a ser usado para implantar o aplicativo de amostra.

1. Abra uma janela de terminal.

2. Crie um novo diretório chamado deploy-run-quickstart e navegue até ele.

   mkdir deploy-run-quickstart
   cd deploy-run-quickstart
   

3. Crie um arquivo chamado skaffold.yaml com o seguinte conteúdo:

   apiVersion: skaffold/v3alpha1
   kind: Config
   metadata:
     name: deploy-run-quickstart
   profiles:
   - name: dev
     manifests:
       rawYaml:
       - run-dev.yaml
   - name: prod
     manifests:
       rawYaml:
       - run-prod.yaml
   deploy:
     cloudrun: {}
   

   Esse arquivo é uma configuração mínima do Skaffold, que identifica seus serviços do Cloud Run. Consulte a referência de skaffold.yaml para ver mais informações sobre esse arquivo.

Preparar os serviços do Cloud Run

Para este guia de início rápido, você criará dois serviços diferentes do Cloud Run no mesmo projeto. O Google Cloud Deploy também oferece suporte à implantação em vários projetos. Além disso, usamos perfis Skaffold para possibilitar dois serviços no mesmo projeto. Ao usar projetos diferentes, talvez não seja necessário usar perfis do Skaffold.

1. Crie um arquivo chamado run-dev.yaml com o seguinte conteúdo:

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: deploy-qs-dev
   spec:
     template:
       spec:
         containers:
         - image: my-app-image
   

   Esse arquivo define um serviço do Cloud Run. Como o nome deploy-qs-dev implica, esse é o serviço dev e vai corresponder ao primeiro destino na progressão do pipeline de entrega.

2. Crie um arquivo chamado run-prod.yaml com o seguinte conteúdo:

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: deploy-qs-prod
   spec:
     template:
       spec:
         containers:
         - image: my-app-image
   

   Esse arquivo define o serviço prod.

Criar pipelines e entregas de entrega

É possível definir o pipeline e os destinos em um arquivo ou em arquivos separados. Neste guia de início rápido, você cria um único arquivo.

1. No diretório deploy-run-quickstart, crie um novo arquivo: clouddeploy.yaml, com o seguinte conteúdo:

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
    name: my-run-demo-app-1
   description: main application pipeline
   serialPipeline:
    stages:
    - targetId: run-qsdev
      profiles: [dev]
    - targetId: run-qsprod
      profiles: [prod]
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
    name: run-qsdev
   description: Cloud Run development service
   run:
    location: projects/PROJECT_ID/locations/us-central1
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
    name: run-qsprod
   description: Cloud Run production service
   run:
    location: projects/PROJECT_ID/locations/us-central1
   

   Observação: Nesse arquivo, os destinos são incluídos no pipeline de entrega, mas é possível definir destinos em um arquivo separado ou em vários arquivos separados.

2. Registre seu pipeline e destinos com o serviço do Google Cloud Deploy:

   gcloud deploy apply --file=clouddeploy.yaml --region=us-central1 --project=PROJECT_ID
   

   Agora você tem um pipeline com destinos prontos para implantar seu aplicativo no primeiro destino.

3. Confirme o pipeline e os destinos:

   No console do Google Cloud, acesse a página Pipelines de entrega do Google Cloud Deploy para visualizar a lista de pipelines de entrega disponíveis.

   Abrir a página "Pipelines de entrega"

   O pipeline de entrega que você acabou de criar é exibido, e os dois destinos são listados na coluna Destinos.

   

Criar uma versão

Uma versão é o recurso central do Google Cloud Deploy que representa as alterações que estão sendo implantadas. O pipeline de entrega define o ciclo de vida dessa versão. Consulte Arquitetura de serviço de implantação do Google Cloud para ver detalhes sobre esse ciclo de vida.

Execute o seguinte comando no diretório deploy-run-quickstart para criar um recurso release que representa a imagem do contêiner a ser implantada:

gcloud deploy releases create test-release-001 \
  --project=PROJECT_ID \
  --region=us-central1 \
  --delivery-pipeline=my-run-demo-app-1 \
  --images=my-app-image=gcr.io/cloudrun/hello

Como essa versão é a primeira, implantando no primeiro destino da progressão, o Google Cloud Deploy também cria automaticamente um recurso rollout. O aplicativo é implantado automaticamente no primeiro destino da progressão.

Promover a versão

Observação: depois de criar a versão, talvez seja necessário aguardar alguns minutos antes de continuar com esta etapa.

1. Na página Pipelines de entrega, clique no pipeline my-run-demo-app-1.

   Abrir a página "Pipelines de entrega"

   A página de detalhes do pipeline de entrega mostra uma representação gráfica do progresso do pipeline de entrega. Neste caso, ele mostra que a versão foi implantada no destino run-qsdev.

   

2. No primeiro destino na visualização do pipeline de exibição, clique em Promover.

   A caixa de diálogo Promover versão é exibida. Ela mostra os detalhes do destino que você está promovendo.

3. Clique em Promover.

   A versão agora está na fila para implantação em qsprod. Quando a implantação estiver concluída, a visualização do pipeline de entrega a mostrará como implantada:

   

Ver os resultados no console do Google Cloud

1. No Console do Google Cloud, acesse a página Pipelines de entrega do Google Cloud Deploy para ver o pipeline de entrega my-run-demo-app-1.

   Abrir a página "Pipelines de entrega"

2. Clique no nome do pipeline de entrega "my-run-demo-app-1".

   A visualização do pipeline mostra o progresso do aplicativo por meio do pipeline.

   

   E sua versão é listada na guia Versões em Detalhes do pipeline de entrega.

3. Clique no nome da versão, test-release-001.

   Seus lançamentos aparecem em Lançamentos. É possível clicar em um lançamento para ver os detalhes dele, incluindo o registro de implantação.

   

Como acessar o serviço do Cloud Run

Por padrão, você precisa estar autenticado para acessar os serviços recém-criados do Cloud Run. Consulte a Visão geral da autenticação do Cloud Run para saber como fornecer credenciais e descobrir qual configuração do Identity and Access Management é necessária para acessar o serviço sem autenticação.

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados nesta página, siga estas etapas.

1. Exclua o serviço deploy-qs-dev do Cloud Run:

   gcloud run services delete deploy-qs-dev --region=us-central1 --project=PROJECT_ID
   

2. Exclua o serviço deploy-qs-prod:

   gcloud run services delete deploy-qs-prod --region=us-central1 --project=PROJECT_ID
   

3. Exclua o pipeline de entrega, os destinos, a versão e os lançamentos:

   gcloud deploy delete --file=clouddeploy.yaml --force --region=us-central1 --project=PROJECT_ID
   

4. Exclua os buckets do Cloud Storage criados pelo Google Cloud Deploy.

   Uma termina com _clouddeploy, e a outra é [region].deploy-artifacts.[project].appspot.com.

   Abrir a página "Procurar" do Cloud Storage

Pronto, você concluiu as etapas deste início rápido.

A seguir

• Saiba mais sobre o Google Cloud Deploy.

• Aprenda as noções básicas sobre a implantação de aplicativos.

• Leia o artigo de instruções para implantação no Cloud Run

• Saiba como gerenciar seus manifestos.

• Aprenda a combinar ferramentas de CI/CD do Google Cloud para desenvolver e fornecer softwares de maneira eficaz para o GKE.