Criar um pipeline e lançar usando o console do Google Cloud

Criar um pipeline e lançar usando o 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. Instancie 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. 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 a cobrança está ativada para o seu projeto do Google Cloud.

4. Ative as APIs Cloud Deploy, Cloud Build, GKE, Artifact Registry, 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 a cobrança está ativada para o seu projeto do Google Cloud.

9. Ative as APIs Cloud Deploy, Cloud Build, GKE, Artifact Registry, 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 você já tiver a CLI instalada, verifique se está executando a versão mais recente:

gcloud components update

Criar seu 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 em rede pela Internet pública. Por padrão, os clusters do GKE são acessíveis 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

Use o Cloud Deploy para criar um pipeline de entrega e destinos com base na configuração especificada em um ou mais arquivos YAML. 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 dois destinos. Quando você usa o console do Google Cloud, não precisa criar arquivos YAML. O Cloud Deploy cria o 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 Create.

   

   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. Se quiser, 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 suas segmentações:

   GKE;

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

   2. Na lista suspensa 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.

      Para este guia de início rápido, precisamos de 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. Marque a caixa de seleção Exigir aprovação para lançamentos para esse destino.

      Para este guia de início rápido, precisamos de 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 prontos 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 seu 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á.

   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 vai ser mostrada. A maioria dos campos é pré-preenchido. Mantenha esses valores como o padrão.

   

   Clique no botão View manifest para conferir o manifesto gerado automaticamente para qualquer destino. Você também pode clicar em View Skaffold file para ver o skaffold.yaml gerado. Também é possível editá-los, mas, neste 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 é mostrada para o lançamento do primeiro destino, e você pode acompanhar o progresso desse lançamento. Ela levará alguns minutos para ser concluída. Pode levar alguns segundos para o lançamento começar.

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 para o primeiro destino.

   

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

   A caixa de diálogo Promover vai aparecer.

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 quando criamos o segundo destino, a promoção está aguardando aprovação.

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

   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 do segundo destino foi iniciado. É possível clicar novamente no nome do pipeline de entrega 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 sua 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.

• 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 fornecer software ao GKE.