Diseña e implementa una aplicación con Gemini CLI

Prepare el entorno

Para preparar tu entorno, autentícate en Google Cloud y habilita los servicios requeridos.

Autentícate en Google Cloud

Para autenticarte en Google Cloud , ejecuta el siguiente comando en la terminal:

1. Configura las credenciales predeterminadas de la aplicación para permitir que los servidores de MCP realicen llamadas a la API.

    gcloud auth application-default login
   

Habilita las APIs

Habilita los servicios de Gemini Cloud Assist y Application Design Center en tu proyecto.

1. Habilita el servicio de Gemini Cloud Assist en tu proyecto:

    gcloud services enable geminicloudassist.googleapis.com
   

2. Habilita el servicio de App Design Center en tu proyecto:

    gcloud services enable designcenter.googleapis.com
   

Configura los servidores de MCP

Los servidores de MCP de Gemini Cloud Assist y App Design Center te ayudan a diseñar, evaluar, implementar y solucionar problemas de la infraestructura Google Cloudcon instrucciones en lenguaje natural. Para conectarte a los servidores de MCP, configura los parámetros de configuración de Gemini CLI.

Para configurar Gemini CLI para que use servidores de MCP, haz lo siguiente:

1. Abre el archivo de configuración de Gemini CLI en una de las siguientes ubicaciones:

   • Alcance del usuario: Para aplicar la configuración en todos tus proyectos de la CLI de Gemini, abre ~/.gemini/settings.json.
   • Alcance del espacio de trabajo: Para aplicar la configuración de un proyecto específico de Gemini CLI, abre .gemini/settings.json.

   Si no existe tu archivo de configuración, crea uno nuevo.

2. En settings.json, agrega o combina el siguiente bloque de configuración en la clave mcpServers.

     {
       "mcpServers": {
         "gemini-cloud-assist": {
           "httpUrl": "https://geminicloudassist.googleapis.com/mcp",
           "authProviderType": "google_credentials",
           "oauth": {
             "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
           },
           "timeout": 600000
         },
         "application-design-center": {
           "httpUrl": "https://designcenter.googleapis.com/mcp",
           "authProviderType": "google_credentials",
           "oauth": {
             "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
           },
           "timeout": 600000
         }
       }
     }
   

   Esta configuración usa automáticamente tus credenciales predeterminadas de la aplicación.

3. Guarda y cierra el archivo de configuración.

4. Inicia Gemini CLI.

   gemini
   

5. Verifica que los servidores de MCP estén conectados.

   /mcp list
   

Instala archivos SKILL.md

Los archivos SKILL.md proporcionan a los servidores de MCP de App Design Center y Gemini Cloud Assist instrucciones y flujos de trabajo para el diseño, la implementación y la solución de problemas de la infraestructura.

Para agregar archivos SKILL.md a Gemini CLI, haz lo siguiente:

1. Crea un directorio skills/design-and-deploy en una de las siguientes ubicaciones:

   • Alcance del usuario: Para aplicar la configuración en todos tus proyectos de Gemini CLI, crea ~/.gemini/skills/design-and-deploy/.
   • Alcance del lugar de trabajo: Para aplicar la configuración a un proyecto específico de Gemini CLI, crea .gemini/skills/design-and-deploy/.

2. En el directorio skills/design-and-deploy/, crea un archivo SKILL.md con el contenido de designing-and-deploying-infrastructure.

3. Crea un directorio skills/google-gemini-cloud-assist en una de las siguientes ubicaciones:

   • Alcance del usuario: Para aplicar la configuración en todos tus proyectos de Gemini CLI, crea ~/.gemini/skills/google-gemini-cloud-assist/.
   • Alcance del lugar de trabajo: Para aplicar la configuración a un proyecto específico de Gemini CLI, crea .gemini/skills/google-gemini-cloud-assist/.

4. En el directorio skills/google-gemini-cloud-assist/, crea un archivo SKILL.md con el contenido de operating-google-cloud.

5. Sal de Gemini CLI y reiníciala.

   /quit
   

   Cuando vuelvas a iniciar Gemini CLI, descubrirá automáticamente tu archivo de habilidad.

6. Verifica que el archivo de skill se haya descubierto automáticamente.

   /skills list
   

Configuraste correctamente Gemini CLI para que se conecte a los servidores de MCP de App Design Center y Gemini Cloud Assist, y creaste archivos de habilidades.

Diseña tu infraestructura Google Cloud

Diseña una infraestructura personalizada para almacenar y ejecutar el código de tu aplicación.

1. Configura el proyecto que deseas usar:

   gcloud config set project PROJECT_ID
   

2. Solicita el diseño de la infraestructura Google Cloud .

    My application code is in REPOSITORY_URL. Design the Google Cloud infrastructure required for my application.
   

   El agente te pedirá que actives las habilidades que configuraste. El agente crea un plan de diseño de infraestructura y te pide que lo apruebes.

3. Aprobar el plan

   Continue with the plan.
   

   El agente identifica las herramientas que se usarán para crear la infraestructura y solicita usar la herramienta setup_adc, que configura App Design Center en tu proyecto.

4. Permite que Gemini Cloud Assist use las herramientas propuestas.

   El agente propone un diseño y te pregunta si está todo listo para la implementación.

5. Itera el diseño propuesto.

   The infrastructure looks good, but I want to add a cache for frequently accessed data.
   

   El agente actualiza el diseño para integrar tu requisito. El agente te preguntará si quieres una explicación de los cambios o si quieres probarlos.

Creaste tu diseño de infraestructura inicial y lo iteraste para mejorarlo.

Evalúa el cumplimiento de los estándares de seguridad

Es probable que los administradores de tu organización hayan configurado marcos de seguridad específicos que influyen en el diseño y la implementación de la infraestructura. En esta sección, verifica que tu diseño cumpla con los estándares de seguridad configurados.

1. Asegúrate de que el diseño de la infraestructura cumpla con los estándares de seguridad de tu organización.

   I want to make sure that infrastructure design is compliant with my organization's security standards.
   

   El agente analiza el diseño de la infraestructura según los marcos de seguridad que especificó el administrador de tu organización en Security Command Center. Si la auditoría detecta problemas de cumplimiento, el agente sugiere mejoras de seguridad y solicita tu aprobación.

2. Aplica las mejoras de seguridad recomendadas

   Apply the recommended security enhancements.
   

   El agente aplica los cambios y te pregunta si quieres aprobar el diseño.

El diseño de tu infraestructura cumple con los marcos de seguridad de tu organización.

Implementa el diseño de la infraestructura

Implementa el diseño de infraestructura en Google Cloud.

1. Aprueba el diseño y realiza la implementación.

   Deploy the infrastructure design to my Google Cloud project.
   

   El agente implementa el diseño final en tu proyecto Google Cloud . El agente te pide que apruebes los cambios en tu proyecto. Por ejemplo, es posible que debas habilitar una API.

   Si la aplicación se implementa correctamente, el agente mostrará los detalles de la implementación, los componentes de la arquitectura y los pasos para usar la aplicación.

2. Si falla la implementación, obtén ayuda para solucionar problemas. Por ejemplo, es posible que debas corregir los detalles de configuración de los componentes o los permisos de Identity and Access Management (IAM).

   Fix the component configuration errors.
   

   El agente proporciona recomendaciones para la configuración de los componentes y crea una vista de diferencias para que la revises y aceptes.

3. Para volver a intentar la implementación después de realizar cambios, repite los pasos de esta sección.

Implementaste el código de la aplicación y el diseño de la infraestructura enGoogle Cloud.