Ver los clústeres

Si te interesan los clústeres de entrenamiento de Gemini Enterprise Agent Platform, comunícate con tu representante de ventas para obtener acceso.

En esta página, se muestra cómo enumerar y ver los clústeres de entrenamiento en tu proyecto con la consola de Google Cloud o la API de Agent Platform (no se admite Google Cloud CLI).

Ver un clúster te permite confirmar lo siguiente:

  • Configuración del clúster
  • Estado del clúster y del nodo
  • Información del nodo de acceso
  • Uso de recursos del clúster

Si buscas instrucciones para actualizar un clúster, consulta Administra un clúster.

Antes de comenzar

Autentícate en Gemini Enterprise Agent Platform, a menos que ya lo hayas hecho.

Selecciona la pestaña que corresponda a la forma en que planeas usar las muestras de esta página:

Console

Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud , no necesitas configurar la autenticación.

REST

Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.

    Instala Google Cloud CLI.

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

Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Google Cloud .

Roles obligatorios

Para obtener los permisos que necesitas para ver clústeres de entrenamiento, pídele a tu administrador que te otorgue el rol de IAM Visualizador de Agent Platform (roles/aiplatform.viewer) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver los clústeres de entrenamiento. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver los clústeres de entrenamiento:

  • Para ver una lista de clústeres, haz lo siguiente: aiplatform.modelDevelopmentClusters.list
  • Para ver los detalles de un solo clúster, haz lo siguiente: aiplatform.modelDevelopmentClusters.get

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Visibilidad de la consola

Los permisos de IAM por sí solos no hacen que los clústeres de entrenamiento sean visibles en la consola de Google Cloud . La página Clústeres de entrenamiento solo aparece para los proyectos inscritos en los clústeres de entrenamiento de Gemini Enterprise Agent Platform. Si no ves la página, comunícate con tu representante de ventas.

La consola de Google Cloud también requiere que se habiliten las siguientes APIs en tu proyecto. Si falta alguno de ellos, en la página Clústeres de entrenamiento, se mostrará el botón Habilitar APIs en lugar de tus clústeres:

  • aiplatform.googleapis.com
  • compute.googleapis.com
  • file.googleapis.com
  • hypercomputecluster.googleapis.com
  • lustre.googleapis.com
  • servicenetworking.googleapis.com
  • storage.googleapis.com

Autenticación para la API

Los ejemplos de la API de Agent Platform en esta página usan el siguiente alias, que llama a Google Cloud CLI para generar un token de acceso:

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

Cómo ver una lista de clústeres

Ambas interfaces muestran los clústeres de una región a la vez. En la consola de Google Cloud , eliges la región de una lista, y con la API de Agent Platform, la región forma parte de la URL de la solicitud.

Console

  1. En la consola de Google Cloud , ve a la página Clústeres de entrenamiento.

    Ir a Clústeres de entrenamiento

  2. En la lista Región, selecciona la región en la que deseas ver los clústeres.

    En la página, se enumeran los clústeres de esa región. Cada columna de la tabla describe una propiedad del clúster:

    Columna Descripción
    ID Es el ID del clúster, que usas como CLUSTER_ID en las solicitudes a la API de Agent Platform.
    Nombre Es el nombre visible del clúster.
    Estado Estado del clúster: Creating, Running, Updating, Stopping o Error.
    Nodos La cantidad de nodos del clúster.
    Fecha de creación Indica cuándo se creó el clúster.
    Tipos de máquinas Son los tipos de máquinas que usan los grupos de nodos del clúster.
    Modelos de consumo Cómo se obtiene la capacidad del clúster: Reservation, Spot, Flex-start o On-demand.

  3. Para abrir un clúster, haz clic en su nombre en la columna Nombre.

REST

Para ver una lista de los clústeres en una región, envía una solicitud GET a la colección modelDevelopmentClusters:

gcurl -X GET https://REGION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/modelDevelopmentClusters

Reemplaza lo siguiente:

  • PROJECT_ID: el ID de tu proyecto.
  • REGION: Es la región en la que existen tus clústeres.

El método list admite los siguientes parámetros de consulta opcionales para controlar la paginación:

  • pageSize (número entero, opcional): Es la cantidad máxima de clústeres que se devolverán en la respuesta. El servicio puede devolver menos que este valor, incluso si existen más elementos. Si no se especifica, se usa un tamaño de página predeterminado.
  • pageToken (cadena, opcional): Es un token que se recibió de una llamada a lista anterior. Proporciona este token para recuperar la siguiente página de resultados.

En el siguiente ejemplo, se solicita la primera página de resultados, con un máximo de cinco clústeres por página:

gcurl "https://REGION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/modelDevelopmentClusters?pageSize=5"

Una respuesta correcta contiene un array modelDevelopmentClusters con hasta cinco recursos de clúster y también puede incluir una cadena nextPageToken.

Cómo ver los detalles de un clúster

Tanto la consola de Google Cloud como la API de Agent Platform informan la configuración de un clúster y su estado actual, incluido el estado de cada uno de sus nodos. Los paneles de Cloud Monitoring solo están disponibles en la consola de Google Cloud .

Console

  1. En la consola de Google Cloud , ve a la página Clústeres de entrenamiento.

    Ir a Clústeres de entrenamiento

  2. En la lista Región, selecciona la región en la que se encuentra el clúster.

  3. En la columna Nombre, haz clic en el nombre del clúster que deseas ver. Se abrirá la página Detalles del clúster en la pestaña Descripción general.

  4. Selecciona una pestaña para ver los detalles correspondientes:

    • Descripción general: El nombre, la descripción y la ubicación del clúster, junto con su configuración de procesamiento, red y orquestación, su nodo de acceso y sus particiones de Slurm

    • Nodos: Dos tablas que describen los nodos del clúster.

    • Nodos de acceso, con las columnas Estado, Nombre, Zona, Tipo de máquina, IP interna, IP externa y Conectar Usa Conectar para abrir una sesión de SSH en un nodo de acceso.

    • Nodos de procesamiento, con las columnas Estado, Nombre, Zona, Tipo de máquina, IP interna y Partición

    • Observabilidad: Paneles precompilados de Cloud Monitoring que abarcan el uso de CPU, memoria y red en todo el clúster, junto con el uso de GPU, las métricas del administrador de GPU del centro de datos de NVIDIA (DCGM), la red de GPU y el estado de la GPU.

Para volver a cargar la página con el estado actual del clúster, haz clic en Actualizar. Para borrar el clúster, haz clic en Borrar.

REST

Para ver los detalles de un solo clúster, envía una solicitud GET al recurso del clúster:

gcurl -X GET https://REGION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/modelDevelopmentClusters/CLUSTER_ID

Reemplaza lo siguiente:

  • PROJECT_ID: el ID de tu proyecto.
  • REGION: Es la región en la que existe el clúster.
  • CLUSTER_ID: Es el ID del clúster que deseas ver. Este es el valor que se muestra en la columna ID de la página Training Clusters en la consola deGoogle Cloud .

La respuesta es un recurso ModelDevelopmentCluster. Junto con la configuración del clúster, su campo clusterStatus informa el estado actual del clúster y de cada uno de sus nodos:

  • clusterStatus.state: Es el estado del clúster, uno de PROVISIONING, RUNNING, UPDATING, STOPPING o ERROR. La consola de Google Cloud muestraPROVISIONINGcomo Creando.
  • clusterStatus.nodesStatus[]: Una entrada para cada nodo del clúster, que indica el nodeState del nodo (PREPARING, RUNNING, UPDATING o ERROR), el nombre de la instancia de Compute Engine, el grupo de nodos y la hora en la que cambió su estado por última vez.
  • clusterStatus.detail: Es una descripción legible por humanos del estado del clúster, cuando está disponible.

Para obtener una descripción de los campos de configuración, consulta la referencia de parámetros.

¿Qué sigue?