Configurar un proyecto para Vertex AI

Para ejecutar servicios de Vertex AI en Google Distributed Cloud (GDC) aislado, prepara un proyecto específico y configura tu entorno de desarrollo. Configura la CLI gdcloud y las cuentas de servicio para poder integrar el aprendizaje automático en tus aplicaciones y flujos de trabajo aislados.

Este documento está dirigido a desarrolladores de aplicaciones de grupos de operadores de aplicaciones que optimizan aplicaciones y flujos de trabajo aislados con funciones de IA. Para obtener más información, consulta la documentación sobre las audiencias de GDC aislado.

Pedir a un administrador que configure un proyecto para ti

La mayoría de las tareas para configurar un proyecto requieren acceso de administrador de la plataforma. Un administrador debe determinar un nombre y un ID de proyecto que sean significativos para identificar el proyecto. Si formas parte de una organización o tienes previsto crear varios proyectos, ten en cuenta qué convenciones de nomenclatura y entidades se reconocen en Distributed Cloud. Para obtener más información, consulta Jerarquía de recursos.

Si no tienes los permisos necesarios, pide a tu administrador que configure el proyecto en tu nombre.

Configura un proyecto siguiendo las instrucciones de este documento.

Antes de empezar

Para obtener los permisos que necesitas para crear un proyecto y configurar cuentas de servicio, pide al administrador de la organización o del proyecto de gestión de identidades y accesos que te conceda los siguientes roles en el espacio de nombres de tu proyecto:

  • Para crear un proyecto, obtén el rol de creador de proyectos (project-creator).
  • Para crear cuentas de servicio, obtén el rol de administrador de proyectos de gestión de identidades y accesos (project-iam-admin).

Para obtener información sobre estos roles, consulta Preparar permisos de gestión de identidades y accesos. Para saber cómo conceder permisos a un sujeto, consulta Conceder y revocar el acceso.

A continuación, crea un proyecto para agrupar tus servicios de Vertex AI. Asegúrate de que la facturación esté habilitada en tu proyecto de Distributed Cloud.

Instalar la CLI gdcloud

Para activar los servicios de Distributed Cloud y acceder a las herramientas y los componentes, instala la CLI gdcloud.

Sigue estos pasos para instalar la CLI gdcloud:

  1. Descarga la CLI gdcloud.
  2. Inicializa la CLI gdcloud:

    gdcloud init
    

    Para obtener más información, consulta Instalar la CLI gdcloud.

  3. Autentica con la CLI gdcloud:

    gdcloud auth login
    

    Para obtener más información sobre cómo autenticarte con tu proveedor de identidades configurado y obtener un archivo kubeconfig para tu identidad de usuario y tu clúster de Kubernetes, consulta la autenticación de la CLI gdcloud.

Configurar cuentas de servicio

Las cuentas de servicio, también denominadas "identidades de servicio", desempeñan un papel crucial en la gestión de tus servicios de Vertex AI. Son las cuentas que usan tus cargas de trabajo para acceder a los servicios y modelos de IA de Vertex AI, así como para hacer llamadas a la API autorizadas de forma programática. Por ejemplo, las cuentas de servicio pueden gestionar tu cuaderno de Vertex AI Workbench para transcribir archivos de audio con la API Speech-to-Text. Al igual que las cuentas de usuario, a las cuentas de servicio se les pueden conceder permisos y roles, lo que proporciona un entorno seguro y controlado, pero no pueden iniciar sesión como un usuario humano.

Puedes configurar cuentas de servicio para los servicios de Vertex AI especificando el nombre de tu cuenta de servicio, el ID del proyecto y el nombre de un archivo JSON para los pares de claves.

Para obtener más información sobre cómo crear una cuenta de servicio, asignarle vinculaciones de roles y crear y añadir pares de claves, consulta Gestionar cuentas de servicio.

Sigue estos pasos para configurar cuentas de servicio con la CLI gdcloud:

  1. Crea una cuenta de servicio:

    gdcloud iam service-accounts create SERVICE_ACCOUNT --project=PROJECT_ID
    

    Haz los cambios siguientes:

    • SERVICE_ACCOUNT: el nombre de la cuenta de servicio. El nombre debe ser único en el espacio de nombres del proyecto.
    • PROJECT_ID: el ID del proyecto en el que quieres crear la cuenta de servicio. Si gdcloud init ya está definido, puedes omitir la marca --project.
  2. Crea el archivo JSON de credenciales predeterminadas de la aplicación y los pares de claves públicas y privadas:

    gdcloud iam service-accounts keys create APPLICATION_DEFAULT_CREDENTIALS_FILENAME \
        --project=PROJECT_ID \
        --iam-account=SERVICE_ACCOUNT \
        --ca-cert-path=CA_CERTIFICATE_PATH
    

    Haz los cambios siguientes:

    • APPLICATION_DEFAULT_CREDENTIALS_FILENAME: el nombre del archivo JSON, como my-service-key.json.
    • PROJECT_ID: el proyecto para el que se va a crear la clave.
    • SERVICE_ACCOUNT: el nombre de la cuenta de servicio a la que se va a añadir la clave.
    • CA_CERTIFICATE_PATH: marca opcional de la ruta al certificado de la autoridad de certificación (AC) que verifica el endpoint de autenticación. Si no especificas esta ruta, se usarán los certificados de AC del sistema. Debes instalar la AC en los certificados AC del sistema.

    Distributed Cloud añade la clave pública a las claves de la cuenta de servicio que usas para verificar los tokens web JSON (JWT) que firma la clave privada. La clave privada se escribe en el archivo JSON de credenciales predeterminadas de la aplicación.

  3. Concede a la cuenta de servicio acceso a los recursos del proyecto asignando una vinculación de rol. El nombre del rol depende del servicio de Vertex AI para el que quieras usar la cuenta de servicio.

    gdcloud iam service-accounts add-iam-policy-binding \
        --project=PROJECT_ID \
        --iam-account=SERVICE_ACCOUNT \
        --role=ROLE
    

    Haz los cambios siguientes:

    • PROJECT_ID: el proyecto en el que se creará la vinculación de roles.
    • SERVICE_ACCOUNT: el nombre de la cuenta de servicio que se va a usar.
    • ROLE: el rol predefinido que se asignará a la cuenta de servicio. Especifica los roles con el formato Role/name, donde Role es el tipo de Kubernetes, como Role o ProjectRole, y name es el nombre del recurso de Kubernetes del rol predefinido. Por ejemplo, estos son los roles que puedes asignar a las cuentas de servicio para usar algunas de las APIs preentrenadas de Vertex AI:

      • Para asignar el rol de desarrollador de OCR de Vertex AI (ai-ocr-developer), define el rol como Role/ai-ocr-developer.
      • Para asignar el rol de desarrollador de Vertex AI Speech (ai-speech-developer), define el rol como Role/ai-speech-developer.
      • Para asignar el rol de desarrollador de Vertex AI Translation (ai-translation-developer), define el rol como Role/ai-translation-developer.