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 de tu proyecto con la Google Cloud consola de 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 clústeres.

Antes de comenzar

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

Selecciona la pestaña según cómo planeas usar las muestras de esta página:

Console

Cuando usas la Google Cloud consola de para acceder a los Google Cloud servicios y las APIs, 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 Google Cloud documentación de autenticación de.

Roles obligatorios

Para obtener los permisos que necesitas para ver los clústeres de entrenamiento, pídele a tu administrador que te otorgue el rol de IAM Lector 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: aiplatform.modelDevelopmentClusters.list
  • Para ver los detalles de un solo clúster: aiplatform.modelDevelopmentClusters.get

También puedes obtener estos permisos con roles personalizados o 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 Google Cloud consola. 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 Google Cloud consola de también requiere que las siguientes APIs estén habilitadas en tu proyecto. Si falta alguna de ellas, la página Clústeres de entrenamiento muestra un 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

En los ejemplos de la API de Agent Platform de esta página, se usa 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"'

Visualiza una lista de clústeres

Ambas interfaces muestran los clústeres de una región a la vez. En la Google Cloud consola de, 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 Google Cloud consola de, 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 de la API de Agent Platform.
    Nombre Es el nombre visible del clúster.
    Estado Es el estado del clúster: Creating, Running, Updating, Stopping o Error.
    Nodos Es la cantidad de nodos del clúster.
    Fecha de creación Es la fecha en la que 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 Es la forma en que 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 de 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: 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 (entero, opcional): Es la cantidad máxima de clústeres que se mostrarán en la respuesta. El servicio puede mostrar 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 recibido de una llamada de lista anterior. Proporciona este token para recuperar la página siguiente 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.

Visualiza los detalles de un clúster

Tanto la Google Cloud consola 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 Google Cloud consola.

Console

  1. En la Google Cloud consola de, 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. La página Detalles del clúster se abre 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 la configuración de procesamiento, red y organizació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 de Cloud Monitoring precompilados 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: la región en la que existe tu clúster.
  • CLUSTER_ID: el ID del clúster que deseas ver. Este es el valor que se muestra en la columna ID de la página Clústeres de entrenamiento en la Google Cloud consola.

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: el estado del clúster, uno de PROVISIONING, RUNNING, UPDATING, STOPPING o ERROR. La Google Cloud consola de muestra PROVISIONING como Creando.
  • clusterStatus.nodesStatus[]: una entrada para cada nodo del clúster, que proporciona el nodeState del nodo (PREPARING, RUNNING, UPDATING o ERROR), el nombre de la instancia de Compute Engine, su grupo de nodos y la hora en que cambió su estado por última vez.
  • clusterStatus.detail: una descripción legible 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?