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

Importante: La integración de Gemini Cloud Assist con herramientas de terceros mediante MCP está en versión preliminar privada. Para solicitar acceso, comunícate con tu Google Cloud equipo de cuentas.

El uso de esta oferta de versión preliminar de Gemini Cloud Assist está sujeto a el Google Cloud Acuerdo, incluidas las Condiciones de la oferta previa a la DG de las Google Cloud Condiciones específicas del servicio, que se complementan con las condiciones del programa de Verificadores de confianza de Google Cloud Gemini para.

Usa los servidores de Protocolo de contexto del modelo (MCP) de Gemini Cloud Assist y App Design Center para diseñar, implementar y solucionar problemas Google Cloud de infraestructura directamente en Gemini CLI.

Objetivos

Este instructivo te ayudará a hacer lo siguiente:

• Configurar Gemini CLI para usar los servidores de MCP de Gemini Cloud Assist y App Design Center
• Diseñar e implementar Google Cloud infraestructura optimizada para ejecutar el código de la aplicación existente
• Analizar y solucionar problemas técnicos

Costos

En este documento, usarás los siguientes componentes facturables de Google Cloud:

• App Design Center.
• Google Cloud resources that you create as part of your application infrastructure.

Para generar una estimación de costos en función del uso previsto, usa la calculadora de precios.

Es posible que los usuarios de Google Cloud nuevos cumplan con los requisitos para acceder a una prueba gratuita.

Cuando completes las tareas que se describen en este documento, podrás borrar los recursos que creaste para evitar que se te siga facturando. Para obtener más información, consulta Realiza una limpieza.

Antes de comenzar

Accede a tu Google Cloud cuenta. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

Instala Google Cloud CLI.

Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

Crea o selecciona un Google Cloud proyecto.

Roles necesarios para seleccionar o crear un proyecto

• Seleccionar un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
• Crear un proyecto: Para crear un proyecto, necesitas el rol de Creador de proyectos (roles/resourcemanager.projectCreator), que contiene el resourcemanager.projects.create permiso. Obtén más información para otorgar roles.

Nota: Si no planeas conservar los recursos que creas en este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

• Crea un Google Cloud proyecto:

  gcloud projects create PROJECT_ID

  Reemplaza PROJECT_ID por un nombre para el Google Cloud proyecto que estás creando.

• Selecciona el Google Cloud proyecto que creaste:

  gcloud config set project PROJECT_ID

  Reemplaza PROJECT_ID por el nombre de tu Google Cloud proyecto.

Verifica que la facturación esté habilitada para tu Google Cloud proyecto.

Instala Google Cloud CLI.

Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

Crea o selecciona un Google Cloud proyecto.

Roles necesarios para seleccionar o crear un proyecto

• Seleccionar un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
• Crear un proyecto: Para crear un proyecto, necesitas el rol de Creador de proyectos (roles/resourcemanager.projectCreator), que contiene el resourcemanager.projects.create permiso. Obtén más información para otorgar roles.

Nota: Si no planeas conservar los recursos que creas en este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

• Crea un Google Cloud proyecto:

  gcloud projects create PROJECT_ID

  Reemplaza PROJECT_ID por un nombre para el Google Cloud proyecto que estás creando.

• Selecciona el Google Cloud proyecto que creaste:

  gcloud config set project PROJECT_ID

  Reemplaza PROJECT_ID por el nombre de tu Google Cloud proyecto.

Verifica que la facturación esté habilitada para tu Google Cloud proyecto.

1. Para acceder a Gemini Cloud Assist a través de MCP, debes estar en el programa de Verificadores de confianza. Comunícate con tu equipo de cuentas para solicitar acceso.
2. Instala Gemini CLI.
3. Asegúrate de tener el rol de Administrador de App Design Center (roles/designcenter.admin) en tu proyecto.
4. Asegúrate de tener un rol que incluya el permiso mcp.googleapis.com/tools.call, como uno de los siguientes roles de Gemini Cloud Assist:
• Administrador de Gemini Cloud Assist (roles/geminicloudassist.admin)
• Editor de Gemini Cloud Assist (roles/geminicloudassist.editor)
• Usuario de Gemini Cloud Assist (roles/geminicloudassist.user)

Prepare el entorno

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

Autentica en Google Cloud

Autentica en Google Cloud ejecutando 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 App 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 Google Cloud infraestructura con 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 usar 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 Gemini CLI, abre ~/.gemini/settings.json.
   • Alcance del lugar de trabajo: Para aplicar la configuración a un proyecto específico de Gemini CLI, abre .gemini/settings.json.

   Si el archivo de configuración no existe, 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 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 SKILL.md archivo 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 habilidades.

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

   /skills list
   

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

Diseña tu Google Cloud infraestructura

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 Google Cloud infraestructura.

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

   El agente solicita que actives las habilidades que configuraste. El agente crea un plan de diseño de infraestructura y solicita tu aprobación.

3. Aprueba el plan.

   Continue with the plan.
   

   El agente identifica las herramientas que se usarán para crear la infraestructura. El agente 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 pregunta si estás listo para implementar.

5. Itera en 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 pregunta si deseas una explicación de los cambios o si deseas 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 frameworks de seguridad específicos que informen 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 en función de los frameworks de seguridad que especificó el administrador de tu organización en Security Command Center. Si la auditoría encuentra 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 pregunta si estás listo para aprobar el diseño.

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

Implementa el diseño de la infraestructura

Implementa el diseño de la infraestructura en Google Cloud.

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

   Deploy the infrastructure design to my Google Cloud project.
   

   El agente implementa el diseño final en tu Google Cloud proyecto. El agente te solicita 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 muestra 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 las configuraciones 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 en Google Cloud.

Limpia

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos usados en este instructivo, borra el proyecto que contiene los recursos o conserva el proyecto y borra los recursos individuales.

Precaución: Borrar un proyecto tiene los siguientes efectos:

• Se borra todo su contenido. Si usaste un proyecto existente para las tareas de este documento, cuando lo borres, también se borrará cualquier otro trabajo que hayas realizado en el proyecto.
• Se pierden los IDs personalizados de los proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID personalizado del proyecto que desees utilizar en el futuro. Para conservar las URLs que usan el ID del proyecto, como una URL appspot.com, borra los recursos seleccionados dentro del proyecto, en lugar de todo el proyecto.

Si planeas explorar varios instructivos, arquitecturas o guías de inicio rápido, reutilizar proyectos puede ser útil para no exceder los límites de cuota de los proyectos.

Borra un Google Cloud proyecto:

gcloud projects delete PROJECT_ID

¿Qué sigue?

• Aprende a supervisar el estado y el rendimiento de las aplicaciones.
• Explora arquitecturas de referencia, diagramas y prácticas recomendadas sobre Google Cloud. Consulta nuestro Cloud Architecture Center.