Implantar um aplicativo com a CLI do Gemini e habilidades de CI/CD

1. Introdução

Neste codelab, você vai conhecer o fluxo de trabalho "do zero ao herói" para engenharia de plataforma usando a CLI do Gemini e a extensão de CI/CD. Você vai assumir a função de um desenvolvedor corporativo que criou um aplicativo (como a demonstração do Spring Petclinic ou um app Python Flask) e agora quer implantá-lo no Google Cloud para compartilhar.

Em vez de configurar manualmente pipelines complexos, você vai usar a linguagem natural para orientar o Gemini. O agente vai analisar seu projeto, sugerir pequenos tempos de execução de destino, como o Google Cloud Run, realizar verificações de segurança para segredos vazados e processar a implantação, fornecendo um URL funcional.

Atividades deste laboratório

  • Clone um repositório (você pode usar o seu ou um app de demonstração como o Spring Petclinic).
  • Instale e configure a CLI do Gemini e a extensão de CI/CD.
  • Use um comando como deploy my application para acionar a habilidade de implantação.
  • Veja o Gemini analisar o projeto, sugerir o Cloud Run, executar verificações de segurança e implantar o aplicativo.
  • Verifique o aplicativo em execução.

O que é necessário

  • Um navegador da Web, como o Chrome.
  • Ter um projeto do Google Cloud com o faturamento ativado.

Este codelab é destinado a desenvolvedores de todos os níveis, incluindo iniciantes.

2. Antes de começar

Configuração de faturamento

Criar ou selecionar um projeto do Google Cloud

Criar um projeto do Google Cloud

  1. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto na nuvem do Google Cloud.
  2. Verifique se o faturamento está ativado para seu projeto do Cloud. Saiba como verificar se o faturamento está ativado em um projeto.

Iniciar o Cloud Shell

O Cloud Shell é um ambiente de linha de comando executado no Google Cloud que vem pré-carregado com as ferramentas necessárias.

  1. Clique em Ativar o Cloud Shell na parte de cima do console do Google Cloud.
  2. Depois de se conectar ao Cloud Shell, verifique sua autenticação:
    gcloud auth list
  3. Confirme se o projeto está configurado:
    gcloud config get project
  4. Se o projeto não estiver definido como esperado, faça o seguinte:
    export PROJECT_ID=<YOUR_PROJECT_ID>
gcloud config set project $PROJECT_ID

Ativar APIs

Execute este comando no Cloud Shell para ativar todas as APIs necessárias para este laboratório:

gcloud services enable \
  cloudbuild.googleapis.com \
  run.googleapis.com \
  artifactregistry.googleapis.com

3. Configurar a CLI do Gemini

Nesta etapa, você vai instalar e configurar a CLI do Gemini e a extensão de CI/CD.

  1. Verifique se a CLI do Gemini está instalada. Se você ainda não a instalou, siga as instruções no Guia de primeiros passos da CLI do Gemini.
  2. Faça login: recomendamos que você faça login com sua Conta do Google. Consulte o Guia de autenticação para mais detalhes.
  3. Instale a extensão de CI/CD: execute o comando a seguir para instalar a extensão do GitHub:
    gemini extensions install https://github.com/gemini-cli-extensions/cicd
    Para validar a instalação da extensão, liste as extensões instaladas:
    gemini extensions list
  4. Configure o Application Default Credentials (ADC): a extensão de CI/CD exige que o ADC seja configurado. Execute:
    gcloud auth login
gcloud auth application-default login
  5. Definir projeto e região padrão: é útil ter o gcloud configurado com um projeto padrão e um projeto de cota para ADC. Substitua pelos seus valores reais (por exemplo, my-project):
    gcloud config set project <PROJECT_ID>
gcloud auth application-default set-quota-project <PROJECT_ID>

4. Implantar o aplicativo

Agora você pode usar a CLI do Gemini e a extensão de CI/CD para implantar o aplicativo.

Clonar o repositório

Neste laboratório, vamos usar o aplicativo de exemplo Spring Petclinic. Você também pode usar seu próprio aplicativo se tiver um pronto que use um ambiente de execução compatível (como Python/Flask, Java/Spring Boot etc.).

  1. Clone o repositório e navegue até o diretório: 
    git clone https://github.com/spring-projects/spring-petclinic.git
cd spring-petclinic

Pedir para o Gemini fazer a implantação

  1. Inicie a CLI do Gemini no diretório do projeto:
    gemini
  2. Na shell da CLI do Gemini, use a extensão de CI/CD para implantar o aplicativo. Você pode usar um comando simples em linguagem natural:
    deploy my application

Próximas etapas

O Gemini vai ativar a habilidade google-cicd-deploy e realizar várias ações:

  • Analise o projeto: ele vai identificar o tipo de aplicativo (por exemplo, Spring Boot).
  • Sugerir ambiente de execução: sugere um ambiente de execução adequado, como o Google Cloud Run.
  • Verificação de segurança: ela vai verificar se há secrets vazados usando as ferramentas do MCP. Permita que as ferramentas sejam executadas se for solicitado.
  • Extrair configuração: usa gcloud para ler o ambiente do projeto atual.
  • Propor parâmetros: apresenta padrões razoáveis para parâmetros de implantação e pede sua confirmação.

Revise a configuração proposta e confirme a implantação.

Quando terminar, o Gemini vai fornecer o URL do aplicativo em execução.

5. Limpar

Para evitar cobranças contínuas na sua conta do Google Cloud, exclua os recursos criados durante este codelab.

Se você fez a implantação no Cloud Run, exclua o serviço usando o comando a seguir. Substitua pela sua região de computação, por exemplo, us-central1:

gcloud run services delete spring-petclinic --region <REGION>

Se você criou um projeto dedicado para este codelab, exclua o projeto inteiro:

gcloud projects delete <YOUR_PROJECT_ID>

6. Parabéns

Parabéns! Você usou a CLI do Gemini e a extensão de CI/CD para implantar um aplicativo no Google Cloud Run usando comandos de linguagem natural.

O que você aprendeu

  • Como instalar e configurar a CLI do Gemini e a extensão de CI/CD.
  • Como usar linguagem natural para acionar um fluxo de implantação.
  • Como o Gemini analisa seu projeto, processa verificações de segurança e sugere tempos de execução.

Próximas etapas

  • Confira comandos mais avançados com a extensão de CI/CD, como criar pipelines completos ou gerar Terraform.
  • Confira a extensão de CI/CD.
  • Saiba mais sobre o Developer Connect.

Documentos de referência