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

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

Nesta página, mostramos como usar o console do Google Cloud para criar um pipeline de entrega do Cloud Deploy e, em seguida, criar uma versão 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 console do Google Cloud.

3. Instância seu pipeline de entrega criando uma versão usando o console do Google Cloud.

   Depois de criar essa versão, o aplicativo é implantado automaticamente no destino.

4. Confira os resultados no console do Google Cloud.

Antes de começar

1. 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.

2. 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

3. Make sure that billing is enabled for your Google Cloud project.

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

   Enable the APIs

5. Install the Google Cloud CLI.

6. To initialize the gcloud CLI, run the following command:

   gcloud init

   Note: You can run the gcloud CLI in the Google Cloud console without installing the Google Cloud CLI. To run the gcloud CLI in the Google Cloud console, use Cloud Shell.

7. 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

8. Make sure that billing is enabled for your Google Cloud project.

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

   Enable the APIs

10. Install the Google Cloud CLI.

11. To initialize the gcloud CLI, run the following command:

    gcloud init

    Note: You can run the gcloud CLI in the Google Cloud console without installing the Google Cloud CLI. To run the gcloud CLI in the Google Cloud console, use 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. Os clusters do GKE são acessíveis externamente por padrão.

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. No entanto, também é possível criar um pipeline de entrega usando o console do Google Cloud.

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

1. No console do Google Cloud, navegue até 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 este 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, vamos exigir a aprovação no segundo destino, mas não no primeiro.

   7. Clique em Criar para criar esse 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. Ative a caixa de seleção Exigir aprovação para lançamentos para esse destino.

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

   7. Clique em Criar para criar esse 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 lançamentos.

   

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 uma versão 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é ela 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 é mostrada. A maioria dos campos é pré-preenchida. Mantenha esses valores padrão.

   

   Clique no botão View manifest para conferir o manifesto gerado automaticamente para qualquer destino. Clique em View Skaffold file 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 essa versão no campo Descrição.

4. Clique em Criar para iniciar a versão.

   A página de detalhes do lançamento é mostrada para o primeiro destino, e é possível acompanhar o progresso dele. Esse processo leva alguns minutos. Pode levar alguns segundos para que o lançamento comece.

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 Promote é mostrada.

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 Revisar novamente e, na caixa de diálogo de aprovação, clique em Aprovar.

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

Quando o segundo lançamento for concluído, 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 estas etapas.

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 CI/CD do Google Cloud para desenvolver e entregar software de maneira eficaz no GKE.