Implementa una aplicación con Gemini CLI y habilidades de CI/CD

1. Introducción

En este codelab, experimentarás el flujo de trabajo "de cero a héroe" para la ingeniería de plataformas con la Gemini CLI y la extensión de CI/CD. Asumirás el rol de un desarrollador empresarial que creó una aplicación (como la demostración de Spring Petclinic o una app de Python Flask) y que ahora quiere implementarla en Google Cloud para compartirla.

En lugar de configurar manualmente canalizaciones complejas, usarás el lenguaje natural para guiar a Gemini. El agente analizará tu proyecto, sugerirá entornos de ejecución de destino a pequeña escala, como Google Cloud Run, realizará análisis de seguridad para detectar secretos filtrados y controlará la implementación, lo que te proporcionará una URL en funcionamiento.

Actividades

Clona un repositorio (puedes usar el tuyo o una app de demostración como Spring Petclinic).
Instala y configura la CLI de Gemini y la extensión de CI/CD.
Usa una instrucción como deploy my application para activar la habilidad de implementación.
Observa cómo Gemini analiza el proyecto, sugiere Cloud Run, ejecuta verificaciones de seguridad y, luego, implementa la aplicación.
Verifica la aplicación en ejecución.

Requisitos

Un navegador web, como Chrome
Un proyecto de Google Cloud con facturación habilitada

Este codelab está dirigido a desarrolladores de todos los niveles, incluidos principiantes.

2. Antes de comenzar

Configuración de facturación

Crea o selecciona un proyecto de Google Cloud

Cómo crear un proyecto de Google Cloud

En la consola de Google Cloud, en la página del selector de proyectos, selecciona o crea un proyecto de Google Cloud.
Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Obtén información para verificar si la facturación está habilitada en un proyecto.

Inicie Cloud Shell

Cloud Shell es un entorno de línea de comandos que se ejecuta en Google Cloud y que viene precargado con las herramientas necesarias.

Haz clic en Activar Cloud Shell en la parte superior de la consola de Google Cloud.
Una vez que te conectes a Cloud Shell, verifica tu autenticación:
```
gcloud auth list
```
Confirma que tu proyecto esté configurado:
```
gcloud config get project
```

Si tu proyecto no está configurado como se espera, configúralo:

export PROJECT_ID=<YOUR_PROJECT_ID>
gcloud config set project $PROJECT_ID

Habilita las APIs

Ejecuta este comando en Cloud Shell para habilitar todas las APIs necesarias para este lab:

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

3. Configura la CLI de Gemini

En este paso, instalarás y configurarás la CLI de Gemini y la extensión de CI/CD.

Asegúrate de que la CLI de Gemini esté instalada. Si aún no la instalaste, sigue las instrucciones de la Guía de introducción a la CLI de Gemini.
Accede: Te recomendamos que accedas con tu Cuenta de Google. Consulta la Guía de autenticación para obtener más detalles.
Instala la extensión de CI/CD: Ejecuta el siguiente comando para instalar la extensión desde GitHub:
```
gemini extensions install https://github.com/gemini-cli-extensions/cicd
```
Puedes validar la instalación de la extensión enumerando las extensiones instaladas:
```
gemini extensions list
```
Configura las credenciales predeterminadas de la aplicación (ADC): La extensión de CI/CD requiere que se configure la ADC. Ejecuta lo siguiente:
```
gcloud auth login
gcloud auth application-default login
```
Establece el proyecto y la región predeterminados: Es útil tener configurado gcloud con un proyecto predeterminado y un proyecto de cuota para ADC. Reemplaza por tus valores reales (p.ej., my-project):
```
gcloud config set project <PROJECT_ID>
gcloud auth application-default set-quota-project <PROJECT_ID>
```

4. Implementa la aplicación

Ahora puedes usar la CLI de Gemini y la extensión de CI/CD para implementar la aplicación.

Clona el repositorio

En este lab, usaremos la popular aplicación de muestra Spring Petclinic. También puedes usar tu propia aplicación si tienes una lista que use un entorno de ejecución compatible (como Python/Flask, Java/Spring Boot, etcétera).

Clona el repositorio y navega hasta el directorio:

git clone https://github.com/spring-projects/spring-petclinic.git
cd spring-petclinic

Pídele a Gemini que implemente

Inicia la CLI de Gemini desde el directorio del proyecto:
```
gemini
```
Una vez dentro del shell de la CLI de Gemini, usa la extensión de CI/CD para implementar tu aplicación. Puedes usar una instrucción simple en lenguaje natural:
```
deploy my application
```

Qué sucede después

Gemini activará la habilidad google-cicd-deploy y realizará varias acciones:

Analizar el proyecto: Identificará el tipo de aplicación (p.ej., Spring Boot).
Sugerir entorno de ejecución: Sugerirá un entorno de ejecución adecuado, como Google Cloud Run.
Análisis de seguridad: Analizará los secretos filtrados con las herramientas de MCP. Debes permitir que se ejecuten las herramientas si se te solicita.
Extraer configuración: Usará gcloud para leer el entorno actual de tu proyecto.
Proponer parámetros: Presentará valores predeterminados razonables para los parámetros de implementación y te pedirá que los confirmes.

Revisa la configuración propuesta y confirma la implementación.

Una vez completada, Gemini te proporcionará la URL de tu aplicación en ejecución.

5. Limpia

Para evitar que se apliquen cargos a tu cuenta de Google Cloud, borra los recursos creados durante este codelab.

Si realizaste la implementación en Cloud Run, puedes borrar el servicio con el siguiente comando (reemplaza por tu región de procesamiento, p.ej., us-central1):

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

Como alternativa, si creaste un proyecto dedicado para este codelab, puedes borrar todo el proyecto:

gcloud projects delete <YOUR_PROJECT_ID>

6. Felicitaciones

¡Felicitaciones! Usaste correctamente la CLI de Gemini y la extensión de CI/CD para implementar una aplicación en Google Cloud Run con instrucciones en lenguaje natural.

Qué aprendiste

Cómo instalar y configurar la CLI de Gemini y la extensión de CI/CD
Cómo usar el lenguaje natural para activar un flujo de implementación
Cómo Gemini analiza tu proyecto, controla los análisis de seguridad y sugiere entornos de ejecución

Próximos pasos

Explora instrucciones más avanzadas con la extensión de CI/CD, como diseñar canalizaciones completas o generar Terraform.
Consulta la extensión de CI/CD.
Obtén más información sobre Developer Connect.