Implantar um app no Cloud Run usando o Cloud Deploy
Nesta página, mostramos como usar o Cloud Deploy para fornecer uma imagem de aplicativo de amostra chamada hello
a uma sequência de dois serviços do Cloud Run ou dois jobs do Cloud Run.
Neste guia de início rápido, você fará o seguinte:
criar uma configuração do Skaffold;
Crie arquivos de configuração para dois serviços do Cloud Run ou dois jobs.
Esses arquivos definem os serviços ou jobs e especificam as imagens de contêiner (pré-criadas) a serem implantadas.
Defina o pipeline de entrega do Cloud Deploy e os destinos de implantação, que apontam para os dois serviços ou os dois jobs.
Instancie o pipeline de entrega criando uma versão, que implanta automaticamente no primeiro destino.
Promova a versão para a segunda segmentação.
Confira os dois lançamentos no console do Google Cloud.
Antes de começar
- 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.
-
No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Ative as APIs Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage.
- Instale a CLI do Google Cloud.
-
Para inicializar a CLI gcloud, execute o seguinte comando:
gcloud init
-
No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Ative as APIs Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage.
- Instale a CLI do Google Cloud.
-
Para inicializar a CLI gcloud, execute o seguinte comando:
gcloud init
- 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.
- Adicione o papel
clouddeploy.jobRunner
:gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:$(gcloud projects describe PROJECT_ID \ --format="value(projectNumber)")-compute@developer.gserviceaccount.com \ --role="roles/clouddeploy.jobRunner"
- Conceda à conta de serviço de execução padrão
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)")-compute@developer.gserviceaccount.com \ --member=serviceAccount:$(gcloud projects describe PROJECT_ID \ --format="value(projectNumber)")-compute@developer.gserviceaccount.com \ --role="roles/iam.serviceAccountUser" \ --project=PROJECT_ID
- 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)")-compute@developer.gserviceaccount.com \ --role="roles/run.developer"
Se você tiver problemas para adicionar um desses papéis, entre em contato com o administrador do projeto.
Se você já tiver a CLI instalada, verifique se está executando a versão mais recente:
gcloud components update
Preparar sua configuração do Skaffold
O Cloud Deploy usa o Skaffold para fornecer os detalhes sobre o que implantar e como implantá-lo corretamente para os destinos separados.
Para este guia de início rápido, crie um arquivo skaffold.yaml
, que identifica o
serviço do Cloud Run ou a definição do job a ser usado para implantar o
app de exemplo.
Abra uma janela de terminal.
Crie um novo diretório chamado
deploy-run-quickstart
e navegue até ele.mkdir deploy-run-quickstart cd deploy-run-quickstart
Crie um arquivo chamado
skaffold.yaml
com o seguinte conteúdo:Serviços
apiVersion: skaffold/v3alpha1 kind: Config metadata: name: deploy-run-quickstart profiles: - name: dev manifests: rawYaml: - run-service-dev.yaml - name: prod manifests: rawYaml: - run-service-prod.yaml deploy: cloudrun: {}
Jobs
apiVersion: skaffold/v3alpha1 kind: Config metadata: name: deploy-run-quickstart profiles: - name: dev manifests: rawYaml: - run-job-dev.yaml - name: prod manifests: rawYaml: - run-job-prod.yaml deploy: cloudrun: {}
Esse arquivo é uma configuração mínima do Skaffold que identifica seus serviços ou jobs do Cloud Run. Consulte a referência do
skaffold.yaml
para mais informações sobre esse arquivo.
Preparar seus serviços ou jobs do Cloud Run
Neste guia de início rápido, você criará dois serviços diferentes do Cloud Run ou dois jobs do Cloud Run no mesmo projeto. O Cloud Deploy também aceita implantações em vários projetos. Além disso, usamos os perfis do Skaffold para possibilitar a existência de dois serviços ou jobs no mesmo projeto. Ao usar projetos diferentes, talvez não seja necessário usar os perfis do Skaffold.
Serviços
Crie um arquivo chamado
run-service-dev.yaml
com o seguinte conteúdo:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: deploy-run-service-dev spec: template: spec: containers: - image: my-app-image
Esse arquivo define um serviço do Cloud Run. Como o nome
deploy-run-service-dev
indica, esse é seu serviçodev
e corresponde ao primeiro destino na progressão do pipeline de entrega.Crie um arquivo chamado
run-service-prod.yaml
com o seguinte conteúdo:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: deploy-run-service-prod spec: template: spec: containers: - image: my-app-image
Esse arquivo define outro serviço do Cloud Run e, como o nome
deploy-run-service-prod
indica, esse é seu serviçoprod
e corresponde ao segundo destino na progressão do pipeline de entrega.
Jobs
Crie um arquivo chamado
run-job-dev.yaml
com o seguinte conteúdo:apiVersion: run.googleapis.com/v1 kind: Job metadata: name: deploy-run-job-dev spec: template: spec: template: spec: containers: - image: my-app-image
Esse arquivo define um job do Cloud Run. Como o nome
deploy-run-job-dev
indica, esse é seu jobdev
e corresponde ao primeiro destino na progressão do pipeline de entrega.Crie um arquivo chamado
run-job-prod.yaml
com o seguinte conteúdo:apiVersion: run.googleapis.com/v1 kind: Job metadata: name: deploy-run-job-prod spec: template: spec: template: spec: containers: - image: my-app-image
Esse arquivo define outro job do Cloud Run. Como o nome
deploy-run-job-prod
indica, esse é seu jobprod
e corresponde ao segundo destino na progressão do pipeline de entrega.
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.
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
Registre o pipeline e os destinos com o serviço 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.
Confirme o pipeline e os destinos:
No console do Google Cloud, navegue até a página Pipelines de entrega do 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 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 do Cloud Deploy 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:
Serviços
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@sha256:98cdb98c2d97a67d5e9183beedfec98ca9d5967acd874409b4800bf4d1a51710
Jobs
gcloud deploy releases create test-release-001 \
--project=PROJECT_ID \
--region=us-central1 \
--delivery-pipeline=my-run-demo-app-1 \
--images=my-app-image=us-docker.pkg.dev/cloudrun/container/job@sha256:d7c33651fbad911a9a0a0c16f2f9b3a79f0b9e3e89afb205603af706067feac5
Como acontece com todas as versões, a menos que elas incluam --disable-initial-rollout
, o Cloud Deploy cria automaticamente um recurso de lançamento. O aplicativo é
implantado automaticamente no primeiro destino do progresso.
Promover a versão
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
.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.
Clique em Promover.
A versão agora está na fila para implantação em
run-qsprod
. Quando a implantação estiver concluída, a visualização do pipeline de entrega a mostrará como implantada:
Conferir os resultados no console do Google Cloud
No console do Google Cloud, acesse a página Pipelines de entrega do Cloud Deploy para ver seu pipeline de entrega my-run-demo-app-1.
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.
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. Isso não se aplica a jobs do Cloud Run.
Limpar
Para evitar cobranças na sua conta do Google Cloud pelos recursos usados nesta página, siga estas etapas.
Exclua o serviço ou job
deploy-qs-dev
do Cloud Run:Serviços
gcloud run services delete deploy-run-service-dev --region=us-central1 --project=PROJECT_ID
Jobs
gcloud run jobs delete deploy-run-job-dev --region=us-central1 --project=PROJECT_ID
Exclua o serviço
deploy-qs-prod
:Serviços
gcloud run services delete deploy-run-service-prod --region=us-central1 --project=PROJECT_ID
Jobs
gcloud run jobs delete deploy-run-job-prod --region=us-central1 --project=PROJECT_ID
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
Exclua os buckets do Cloud Storage criados pelo Cloud Deploy.
Uma termina com
_clouddeploy
, e a outra é[region].deploy-artifacts.[project].appspot.com
.
Pronto, você concluiu as etapas deste início rápido.