Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Diseña e implementa una aplicación con la CLI de Antigravity

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 la CLI de Antigravity.

Objetivos

En este instructivo, aprenderás a hacer lo siguiente:

Configurar la CLI de Antigravity 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

Instala Google Cloud CLI.
Configura gcloud CLI para usar tu identidad federada.

Para obtener más información, consulta Accede 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 creados durante este procedimiento, crea un proyecto en lugar de seleccionar un proyecto existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.
- Crea un Google Cloud proyecto de:
```
gcloud projects create PROJECT_ID
```
  Reemplaza PROJECT_ID por un nombre para el Google Cloud proyecto de que estás creando.
- Selecciona el Google Cloud proyecto de que creaste:
```
gcloud config set project PROJECT_ID
```
  Reemplaza PROJECT_ID por el nombre del proyecto de Google Cloud .
Verifica que la facturación esté habilitada para tu Google Cloud proyecto.
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.
Instala la CLI de Antigravity

Para implementar y ejecutar comandos de la CLI de Antigravity, pídele a tu administrador que te otorgue los roles necesarios dentro del límite de tu proyecto, como se indica en la siguiente tabla:

Tarea	Roles obligatorios
Configura App Design Center en tu proyecto	Administrador de App Design Center (`roles/designcenter.admin`)
Accede a Gemini Cloud Assist y llámalo a través de MCP	Administrador de Gemini Cloud Assist (`roles/geminicloudassist.admin`), o Editor de Gemini Cloud Assist (`roles/geminicloudassist.editor`), o Usuario de Gemini Cloud Assist (`roles/geminicloudassist.user`)

Prepare el entorno

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

Autentícate en Google Cloud

Para autenticarte en Google Cloud ejecuta el siguiente comando en tu terminal:

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.

Habilita el servicio de Gemini Cloud Assist en tu proyecto:

 gcloud services enable geminicloudassist.googleapis.com

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 Antigravity.

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

Abre el archivo de configuración de MCP en una de las siguientes ubicaciones:
- Alcance del usuario: Para aplicar la configuración en todos tus proyectos de la CLI de Antigravity, abre ~/.gemini/config/mcp_config.json.
- Alcance del lugar de trabajo: Para aplicar la configuración a un proyecto específico de la CLI de Antigravity proyecto, abre .agents/mcp_config.json.
Si no existe el archivo de configuración, crea uno nuevo.

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

  {
    "mcpServers": {
      "gemini-cloud-assist": {
        "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
        "authProviderType": "google_credentials"
      },
      "application-design-center": {
        "serverUrl": "https://designcenter.googleapis.com/mcp",
        "authProviderType": "google_credentials"
      }
    }
  }

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

Guarda y cierra el archivo de configuración.
Inicia la CLI de Antigravity.
```
agy
```
Verifica que los servidores de MCP estén conectados.
```
/mcp list
```

Instala archivos `SKILL.md`

Los archivos SKILL.md proporcionan al App Design Center y a los servidores de MCP de 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 la CLI de Antigravity, haz lo siguiente:

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 la CLI de Antigravity, crea ~/.gemini/config/skills/design-and-deploy/.
- Alcance del lugar de trabajo: Para aplicar la configuración a un proyecto específico de la CLI de Antigravity, crea .agents/skills/design-and-deploy/.
En el directorio skills/design-and-deploy/, crea un archivo SKILL.md con el contenido de designing-and-deploying-infrastructure.
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 la CLI de Antigravity, crea ~/.gemini/config/skills/google-gemini-cloud-assist/.
- Alcance del lugar de trabajo: Para aplicar la configuración a un proyecto específico de la CLI de Antigravity, crea .agents/skills/google-gemini-cloud-assist/.
En el directorio skills/google-gemini-cloud-assist/, crea un SKILL.md archivo con el contenido de operating-google-cloud.
Sal de la sesión de la CLI de Antigravity y reiníciala.
```
/quit
```
Cuando vuelvas a iniciar la CLI de Antigravity con agy, descubrirá automáticamente tus archivos de habilidades.
Verifica que los archivos de habilidades se hayan descubierto automáticamente.
```
/skills list
```

Configuraste correctamente la CLI de Antigravity 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.

Configura el proyecto que deseas usar:
```
gcloud config set project PROJECT_ID
```
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.
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.
Permite que Gemini Cloud Assist use las herramientas propuestas.

El agente propone un diseño y pregunta si estás listo para implementarlo.
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 pregunta si deseas una explicación de los cambios o si deseas probarlos.

Creaste el diseño inicial de la infraestructura 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.

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 el administrador de tu organización especificó en Security Command Center. Si la auditoría encuentra problemas de cumplimiento, el agente sugiere mejoras de seguridad y solicita tu aprobación.
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.

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.
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.
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 estas consecuencias:

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 de:

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.