Crie um pipeline e faça o lançamento na Google Cloud consola

Esta página mostra como usar a Google Cloud consola para criar um pipeline de fornecimento do Cloud Deploy e, em seguida, criar um lançamento para esse pipeline.

Neste início rápido, vai fazer o seguinte:

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

  2. Crie um pipeline de entrega e dois alvos através da Google Cloud consola.

  3. Instancie o pipeline de fornecimento criando um lançamento através da Google Cloud consola.

    Depois de criar esta versão, a aplicação é implementada automaticamente no destino.

  4. Veja os resultados na Google Cloud consola.

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.

    Go to project selector

  3. Verify 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. Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro, tem de iniciar sessão na CLI gcloud com a sua identidade federada.

  7. Para inicializar a CLI gcloud, execute o seguinte comando:

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

    Go to project selector

  9. Verify that billing is enabled for your Google Cloud project.

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

    Enable the APIs

  11. Install the Google Cloud CLI.

  12. Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro, tem de iniciar sessão na CLI gcloud com a sua identidade federada.

  13. Para inicializar a CLI gcloud, execute o seguinte comando:

    gcloud init
  14. Se já tiver a CLI instalada, certifique-se de que está a executar a versão mais recente:

    gcloud components update
    

    Crie o seu ambiente de tempo de execução

    Se estiver a implementar no Cloud Run, pode ignorar este comando.

    Para o GKE, crie dois clusters: quickstart-cluster-for-console-staging e quickstart-cluster-for-console-prod, com as predefinições. Os pontos finais da API Kubernetes dos clusters têm de ser acessíveis através da rede a partir da Internet pública. Os clusters do GKE são acessíveis externamente por predefiniçã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
    

    Crie um pipeline de entrega e duas segmentações

    Pode usar o Cloud Deploy para criar um pipeline de entrega e destinos com base na configuração especificada num ou mais ficheiros YAML. No entanto, também pode criar um pipeline de entrega através da Google Cloud consola.

    Nesta secção, vai usar a Google Cloud consola para criar um pipeline de fornecimento e dois alvos. Quando usa a Google Cloud consola, não precisa de criar nenhum ficheiro YAML. O Cloud Deploy cria o seu skaffold.yaml e manifesto por si.

    1. Na Google Cloud consola, navegue para a página principal do Cloud Deploy.

      Abra a página Pipelines de fornecimento

    2. Clique em Criar

      Página principal do Cloud Deploy na consola Google Cloud

      É apresentado o formulário Crie um pipeline de entrega.

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

    4. Opcionalmente, introduza uma descrição para este pipeline de entrega.

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

    6. Selecione o tempo de execução.

      Se estiver a implementar no GKE, selecione Google Kubernetes Engine. Caso contrário, selecione Cloud Run.

    7. Crie as suas segmentações:

      GKE

      1. Em Novo alvo, no campo Nome do alvo, substitua o texto predefinido por console-staging.

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

      3. Clique em Concluído.

      4. Clique em Adicionar alvo.

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

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

      6. Selecione Exigir aprovação para implementações.

        Para este início rápido, estamos a exigir aprovação no segundo destino, mas não no primeiro.

      7. Clique em Criar para criar este pipeline de fornecimento.

        Página principal do Cloud Deploy na consola Google Cloud

      Cloud Run

      1. Em Novo alvo, no campo Nome do alvo, substitua o texto predefinido por console-staging.

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

      3. Clique em Concluído.

      4. Clique em Adicionar alvo.

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

      6. Ative a caixa de verificação Exigir aprovação para implementações para este destino.

        Para este início rápido, estamos a exigir aprovação no segundo destino, mas não no primeiro.

      7. Clique em Criar para criar este pipeline de fornecimento.

        Página principal do Cloud Deploy na consola Google Cloud

      Agora, tem um pipeline de entrega com dois destinos, pronto para criar um lançamento.
      É apresentada a página do pipeline, que mostra ambos os alvos, sem implementações.

      Novo pipeline de entrega criado na consola Google Cloud

    Crie um lançamento

    Agora que tem um pipeline de entrega, com dois alvos, que apontam para dois clusters do GKE ou dois serviços do Cloud Run, pode criar um lançamento para implementar a sua aplicação no primeiro alvo.

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

      A visualização do pipeline é apresentada sem implementações.

    2. Clique no botão Criar lançamento.

      É apresentada a caixa de diálogo Crie um lançamento. A maioria dos campos está pré-preenchida. Mantenha estes valores predefinidos.

      A caixa de diálogo **Crie um lançamento**

      Pode clicar no botão Ver manifesto para ver o manifesto gerado automaticamente para qualquer destino e pode clicar em Ver ficheiro Skaffold para ver o skaffold.yaml gerado. Também pode editá-los, mas, para este início rápido, deixe-os como estão.

    3. Opcionalmente, adicione uma descrição para este lançamento no campo Descrição.

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

      É apresentada a página de detalhes da implementação para o primeiro alvo e pode ver o progresso desta implementação. Este processo vai demorar alguns minutos. O lançamento pode demorar alguns segundos a começar.

    5. Após a conclusão da primeira implementação, clique no nome do pipeline de fornecimento para aceder à página do pipeline de fornecimento.

      Clique no nome do pipeline para ver a visualização

      É apresentada a visualização do pipeline, com a implementação concluída para o primeiro alvo.

      Visualização do pipeline de fornecimento com a primeira segmentação concluída

    6. Clique em Promover para iniciar a implementação no destino seguinte.

      É apresentada a caixa de diálogo Promover.

    7. Mantenha os valores predefinidos, adicione uma Descrição da implementação, se quiser, e, em seguida, clique em Promover.

      Como selecionámos Exigir aprovação para implementações quando criámos o segundo alvo, esta promoção está a aguardar aprovação.

    8. Clique em Rever na visualização do pipeline de fornecimento.

      É apresentada a página de aprovação.

      Aprovação necessária para a promoção ao segundo alvo

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

      A implementação é iniciada para o segundo alvo. Pode clicar novamente no nome do pipeline de entrega para ver o progresso na visualização do pipeline.

    Quando a segunda implementação estiver concluída, a aplicação é implementada no segundo destino e o pipeline de entrega é concluído.

    Pipeline de entrega concluído.

    Limpar

    Para evitar incorrer em cobranças na sua Google Cloud conta pelos recursos usados nesta página, siga estes passos.

    1. Elimine 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 envio, clique em Eliminar para eliminar o pipeline de envio, o lançamento e as implementações.

      Escreva o nome do pipeline no campo fornecido e clique em Confirmar para terminar de eliminar os recursos.

      Caixa de diálogo de confirmação para eliminar o pipeline e os recursos subordinados. target

    3. Elimine ambos os destinos:

      gcloud deploy targets delete console-staging --region=us-central1  && \
      gcloud deploy targets delete console-prod --region=us-central1
      
    4. Elimine os contentores do Cloud Storage que o Cloud Deploy criou.

      Uma termina com _clouddeploy e a outra é [region].deploy-artifacts.[project].appspot.com.

      Abra a página do navegador do Cloud Storage

    É tudo. Concluiu este início rápido!

    O que se segue?