Criar um pipeline e lançar no console do Google Cloud

Criar um pipeline e lançar 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. Criar dois clusters do GKE ou configurar dois serviços do Cloud Run.

2. Crie um pipeline de entrega. e dois destinos usando o console do Google Cloud.

3. Instancie seu pipeline de entrega criando uma versão com 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 as configurações padrão. Os endpoints da API Kubernetes dos clusters precisam ser acessíveis pela rede da Internet pública. 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. Mas você também pode 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 dois destinos. Quando você usa o console do Google Cloud, não é necessário criar todos os arquivos YAML; O Cloud Deploy cria seu skaffold.yaml e manifestar 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.

      Para este guia de início rápido, exigimos 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é-preenchidas. Mantenha esses valores padrão.

   

   Clique no botão Ver manifesto para exibir o arquivo. gerado automaticamente para qualquer destino, e você pode clicar Acesse o arquivo do 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 a versão no campo Descrição.

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

   A página de detalhes do lançamento é exibida para o primeiro destino. acompanhe o progresso desse lançamento. Levará alguns minutos para concluído. Pode levar alguns segundos para que o lançamento seja iniciado.

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

   

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

   

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

   A caixa de diálogo Promote é mostrada.

7. Mantenha os valores padrão, adicione uma descrição de 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 é exibida.

   

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 remover a entrega. pipeline, a versão e os lançamentos.

   Digite o nome do pipeline no campo fornecido e clique em Confirmar para termine de excluir os 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 que o Cloud Deploy criou.

   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.

• Confira o tutorial do Cloud Deploy.

• Saiba como gerenciar seus manifestos.

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