Configura un entorno de desarrollo local

Obtén más información para configurar un entorno de desarrollo local paraCloud de Confiance by S3NS. En este documento, se describen las herramientas principales necesarias para compilar, probar y ejecutar aplicaciones con los servicios de Cloud de Confiance :

  • CLI de gcloud: Administra recursos de Cloud, configura proyectos y establece credenciales predeterminadas de la aplicación (ADC) locales.
  • Bibliotecas cliente de Cloud: Accede a las Cloud de Confiance APIs de forma programática con bibliotecas idiomáticas en tu lenguaje de programación preferido.

En este documento, también se muestra cómo instalar el complemento de google-cloud-developer para obtener ayuda con las tareas de Cloud de Confiance y la programación en varios agentes diferentes.

Para obtener una descripción general de otras herramientas y otras interfaces en Cloud de Confiance, consulta Formas de interactuar con Cloud de Confiance.

Antes de comenzar

Pídele al administrador de tu organización que complete los siguientes requisitos previos:

  • Aprovisiona tu identidad de usuario: Asigna una cuenta de Cloud Identity o Google Workspace.
  • Otorga acceso al proyecto y roles de IAM: Asigna los roles de Identity and Access Management (IAM) necesarios para tu proyecto.
  • Habilita la facturación: Verifica que la Facturación de Cloud esté habilitada en tu proyecto.

Para la configuración en toda la organización, consulta el flujo guiado de configuración deCloud de Confiance .

Configura gcloud CLI y la autenticación

Configura gcloud CLI (gcloud) para administrar recursos y autenticar tu entorno local:

  1. Instala gcloud CLI en tu estación de trabajo local.
  2. Ejecuta gcloud init en tu terminal para acceder y seleccionar tu proyecto predeterminado.
  3. Ejecuta gcloud auth application-default login para configurar las credenciales predeterminadas de la aplicación (ADC). Las ADC permiten que las bibliotecas cliente locales se autentiquen automáticamente en tu proyecto.

Instala las bibliotecas cliente de Cloud

Para acceder a los Cloud de Confiance servicios de forma programática desde el código de tu aplicación, haz lo siguiente:

  1. Habilita las APIs de Cloud necesarias para tu proyecto.
  2. Instala las bibliotecas cliente de Cloud para tu lenguaje de programación (como Java, Python o Go). Tu código se autentica automáticamente con ADC.

Instala el complemento de google-cloud-developer

Si usas un agente como Claude Code, Antigravity CLI o Codex CLI para ayudarte en tu trabajo de desarrollo, puedes instalar el complemento de google-cloud-developer para obtener ayuda con las tareas de Cloud de Confiance y la programación. Este complemento incluye lo siguiente:

  • Habilidades para ayudar con la creación de cuentas, la configuración de facturación, la administración de proyectos y la autenticación en las APIs y los servicios de Cloud de Confiance
  • La habilidad finding-google-skills, que localiza y ejecuta la habilidad del producto de Google adecuada a pedido, lo que evita la necesidad de precargar las habilidades de Google.
  • El servidor de MCP remoto de Developer Knowledge, que permite buscar la documentación oficial para desarrolladores de Google y recuperar información sobre los productos de Google, como Google Cloud, Firebase, Android, Maps y muchos más.

Instala el complemento google-cloud-developer siguiendo las instrucciones que se indican a continuación según tu agente.

CLI de Antigravity

  1. Instala el complemento especificando su ubicación en el repositorio de Google Agent Skills:

    agy plugin install https://github.com/google/skills/plugins/cloud/google-cloud-developer
    
  2. Habilita la API de Developer Knowledge en tu proyecto de Cloud de Confiance con la gcloud CLI:

    gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID
    

Claude Code

  1. Agrega el mercado de complementos de Google y, luego, instala el complemento:

    claude plugin marketplace add google/skills
    claude plugin install google-cloud-developer@google-plugins
    
  2. Habilita la API de Developer Knowledge en tu proyecto de Cloud de Confiance con la gcloud CLI:

    gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID
    
  3. Crea una clave de API para la API de Developer Knowledge siguiendo las instrucciones de Crea y protege la clave de API. Guarda la clave que crees en una ubicación segura.

  4. Exporta la clave de API a tu entorno antes de iniciar Claude Code:

    export DEVELOPERKNOWLEDGE_API_KEY=YOUR_API_KEY
    

CLI de Codex

  1. Agrega el mercado de complementos de Google y, luego, instala el complemento:

    codex plugin marketplace add google/skills
    codex plugin add google-cloud-developer@google-plugins
    
  2. Habilita la API de Developer Knowledge en tu proyecto de Cloud de Confiance con la gcloud CLI:

    gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID
    
  3. Crea una clave de API para la API de Developer Knowledge siguiendo las instrucciones de Crea y protege la clave de API. Guarda la clave que crees en una ubicación segura.

  4. Actualiza ~/.codex/config.toml (o el .codex/config.toml de tu proyecto) para incluir las siguientes líneas y habilitar el acceso autenticado al servidor de MCP de Developer Knowledge:

    [mcp_servers.developer-knowledge]
      url = "https://developerknowledge.googleapis.com/mcp"
      env_http_headers = { "X-Goog-Api-Key" = "DEVELOPERKNOWLEDGE_API_KEY" }
    
  5. Exporta la clave de API a tu entorno antes de iniciar Codex:

    export DEVELOPERKNOWLEDGE_API_KEY=YOUR_API_KEY
    

Herramientas y entornos alternativos

Si tu flujo de trabajo requiere entornos de desarrollo o herramientas de infraestructura específicos, ten en cuenta lo siguiente:

¿Qué sigue?