Criar um pipeline e uma versão no console Google Cloud

Criar um pipeline e uma versão no console Google Cloud

Nesta página, mostramos como usar o console Google Cloud para criar um pipeline de entrega do Cloud Deploy e, em seguida, criar um lançamento para esse pipeline.

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

1. Crie dois clusters do GKE ou configure dois serviços do Cloud Run.

2. Crie um pipeline de entrega e dois destinos usando o consoleGoogle Cloud .

3. Instancie o pipeline de entrega criando uma versão usando o Google Cloud console.

   Depois que você cria essa versão, o aplicativo é implantado automaticamente no destino.

4. Confira os resultados no console do Google Cloud .

Antes de começar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
Go to project selector
Verify that billing is enabled for your Google Cloud project.
Enable the Cloud Deploy, Cloud Build, GKE, Artifact Registry, Cloud Run, and Cloud Storage APIs.
Enable the APIs
Install the Google Cloud CLI.
Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.
Para inicializar a gcloud CLI, execute o seguinte comando:
gcloud init
Observação: execute a gcloud CLI no console do Google Cloud sem instalar a CLI do Google Cloud. Para executar a gcloud CLI no console do Google Cloud , use o Cloud Shell.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Deploy, Cloud Build, GKE, Artifact Registry, Cloud Run, and Cloud Storage APIs.

Enable the APIs

Install the Google Cloud CLI.

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

Para inicializar a gcloud CLI, execute o seguinte comando:

gcloud init

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

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

gcloud components update

Criar o ambiente de execução

Se você estiver implantando no Cloud Run, pule este comando.

Para o GKE, crie dois clusters: quickstart-cluster-for-console-staging e quickstart-cluster-for-console-prod, com configurações padrão. Os endpoints da API Kubernetes dos clusters precisam ser acessíveis pela rede da Internet pública. Por padrão, os clusters do GKE podem ser acessados externamente.

gcloud container clusters create-auto quickstart-cluster-for-console-staging \
                 --project=PROJECT_ID \
                 --region=us-central1 && \
gcloud container clusters create-auto quickstart-cluster-for-console-prod \
                 --project=PROJECT_ID \
                 --region=us-central1

Criar um pipeline de entrega e dois destinos

É possível usar o Cloud Deploy para criar um pipeline de entrega e destinos com base na configuração especificada em um ou mais arquivos YAML. Mas também é possível criar um pipeline de entrega usando o console Google Cloud .

Nesta seção, você vai usar o console Google Cloud para criar um pipeline de entrega e dois destinos. Ao usar o console Google Cloud , não é necessário criar arquivos YAML. O Cloud Deploy cria o skaffold.yaml e o manifesto para você.

1. No console Google Cloud , acesse a página principal do Cloud Deploy.

   Abrir a página "Pipelines de entrega"

2. Clique em Criar.

   

   O formulário Criar um pipeline de entrega é exibido.

3. No campo Nome do pipeline, substitua o texto padrão por in-console-quickstart-pipeline.

4. Opcionalmente, insira uma descrição para esse pipeline de entrega.

5. No menu suspenso Região, selecione us-central1.

6. Selecione o ambiente de execução.

   Se você estiver implantando no GKE, selecione Google Kubernetes Engine. Caso contrário, selecione Cloud Run.

7. Crie seus destinos:

   GKE

   1. Em Novo destino, no campo Nome do destino, substitua o texto padrão por console-staging.

   2. No menu suspenso Cluster do Kubernetes Engine, selecione quickstart-cluster-for-console-staging.

   3. Clique em Concluído.

   4. Clique em Adicionar destino.

      Substitua o texto padrão de Nome do destino por console-prod.

   5. Selecione quickstart-cluster-for-console-prod no menu suspenso Cluster do Kubernetes Engine.

   6. Selecione Exigir aprovação para lançamentos.

      Neste guia de início rápido, exigimos aprovação no segundo destino, mas não no primeiro.

   7. Clique em Criar para criar o pipeline de entrega.

      

   Cloud Run

   1. Em Novo destino, no campo Nome do destino, substitua o texto padrão por console-staging.

   2. No menu suspenso Região, selecione us-central1.

   3. Clique em Concluído.

   4. Clique em Adicionar destino.

   5. Substitua o texto padrão de Nome do destino por console-prod.

   6. Marque a caixa de seleção Exigir aprovação para lançamentos para esse destino.

      Neste guia de início rápido, exigimos aprovação no segundo destino, mas não no primeiro.

   7. Clique em Criar para criar o pipeline de entrega.

      

   Observação: se a conta de serviço padrão do Compute Engine não tiver as permissões necessárias, clique no botão Conceder para adicioná-las quando solicitado.

   Agora você tem um pipeline de entrega com dois destinos, pronto para criar uma versão.
   A página do pipeline é exibida, mostrando os dois destinos, sem rollouts.

   

Criar uma versão

Agora que você tem um pipeline de entrega com dois destinos, apontando para dois clusters do GKE ou dois serviços do Cloud Run, é possível criar um lançamento para implantar o aplicativo no primeiro destino.

1. Se você ainda não estiver na página do pipeline de entrega, mostrando o novo pipeline de entrega in-console-quickstart-pipeline, navegue até lá agora.

   A visualização do pipeline é mostrada, sem lançamentos.

2. Clique no botão Criar versão.

   A caixa de diálogo Criar uma versão é exibida. A maioria dos campos é preenchida automaticamente. Mantenha esses valores padrão.

   

   Clique no botão Ver manifesto para conferir o manifesto gerado automaticamente para qualquer um dos destinos. Clique em Ver arquivo Skaffold para conferir o skaffold.yaml gerado. Você também pode editá-los, mas para este guia de início rápido, deixe-os como estão.

3. Se quiser, adicione uma descrição para esta versão no campo Descrição.

4. Clique em Criar para iniciar o lançamento.

   A página de detalhes do lançamento é mostrada para o lançamento no primeiro destino, e você pode acompanhar o progresso desse lançamento. Esse processo leva alguns minutos. O lançamento pode levar alguns segundos para começar.

5. Depois que o primeiro lançamento terminar, clique no nome do pipeline de entrega para acessar a página dele.

   

   A visualização do pipeline é mostrada, com o lançamento concluído para o primeiro destino.

   

6. Clique em Promover para iniciar o lançamento para o próximo destino.

   A caixa de diálogo Promover é exibida.

7. Mantenha os valores padrão, adicione uma Descrição do lançamento se quiser e clique em Promover.

   Como selecionamos Exigir aprovação para lançamentos ao criar o segundo destino, essa promoção está aguardando aprovação.

8. Clique em Revisar na visualização do pipeline de exibição.

   A página de aprovação é mostrada.

   

9. Clique em Analisar novamente e, na caixa de diálogo de aprovação, clique em Aprovar.

   O lançamento é iniciado para a segunda segmentação. Clique novamente no nome do pipeline de entrega para acompanhar o progresso na visualização.

Quando a segunda implantação for concluída, o aplicativo será implantado no segundo destino, e o pipeline de entrega será concluído.



Limpar

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

1. Exclua os clusters do GKE ou os serviços do Cloud Run:

   GKE

   gcloud container clusters delete quickstart-cluster-for-console-staging --region=us-central1 --project=PROJECT_ID \
   && gcloud container clusters delete quickstart-cluster-for-console-prod --region=us-central1 --project=PROJECT_ID
   

   Cloud Run

   gcloud run services delete in-console-quickstart-pipeline-target-1 --region=us-central1 --project=PROJECT_ID \
   && gcloud run services delete in-console-quickstart-pipeline-target-2 --region=us-central1 --project=PROJECT_ID
   

2. Na página do pipeline de entrega, clique em Excluir para excluir o pipeline de entrega, a versão e os lançamentos.

   Digite o nome do pipeline no campo fornecido e clique em Confirmar para concluir a exclusão dos recursos.

   

3. Exclua os dois destinos:

   gcloud deploy targets delete console-staging --region=us-central1  && \
   gcloud deploy targets delete console-prod --region=us-central1
   

4. Exclua os buckets do Cloud Storage criados pelo 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 Cloud Deploy.

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

• Teste o tutorial do Cloud Deploy.

• Saiba como gerenciar seus manifestos.

• Saiba como combinar ferramentas de Google Cloud CI/CD para desenvolver e entregar software de maneira eficaz ao GKE.