클러스터 보기

Gemini Enterprise Agent Platform 학습 클러스터에 관심이 있으면 영업 담당자에게 문의하여 액세스 권한을 받으세요.

이 페이지에서는 콘솔 또는 Agent Platform API (Google Cloud CLI는 지원되지 않음)를 사용하여 프로젝트의 학습 클러스터를 나열하고 보는 방법을 보여줍니다. Google Cloud

클러스터를 보면 다음을 확인할 수 있습니다.

  • 클러스터 구성
  • 클러스터 및 노드 상태
  • 로그인 노드 정보
  • 클러스터 리소스 사용량

클러스터 업데이트에 관한 안내를 찾고 있다면 클러스터 관리를 참고하세요.

시작하기 전에

Gemini Enterprise Agent Platform에 아직 인증하지 않았다면 인증을 진행하세요.

이 페이지의 샘플 사용 방법에 대한 탭을 선택하세요.

콘솔

콘솔을 사용하여서비스 및 API에 액세스하는 경우 인증을 설정할 필요가 없습니다. Google Cloud Google Cloud

REST

로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.

    Google Cloud CLI를 설치한 후 제휴 ID로 gcloud CLI에 로그인합니다.

자세한 내용은 인증 문서의 REST 사용을 위한 인증 을 참조하세요. Google Cloud

필요한 역할

학습 클러스터를 보는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Agent Platform 뷰어 (roles/aiplatform.viewer) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 학습 클러스터를 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

학습 클러스터를 보려면 다음 권한이 필요합니다.

  • 클러스터 목록을 보려면 aiplatform.modelDevelopmentClusters.list
  • 단일 클러스터의 세부정보를 보려면 aiplatform.modelDevelopmentClusters.get

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

콘솔 공개 상태

IAM 권한만으로는 콘솔에서 학습 클러스터를 볼 수 없습니다. Google Cloud 학습 클러스터 페이지는 Gemini Enterprise Agent Platform 학습 클러스터에 등록된 프로젝트에만 표시됩니다. 페이지가 표시되지 않으면 영업 담당자에게 문의하세요.

Google Cloud 콘솔에서는 프로젝트에서 다음 API도 사용 설정해야 합니다. 이러한 API가 누락된 경우 학습 클러스터 페이지에 클러스터 대신 API 사용 설정 버튼이 표시됩니다.

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

API 인증

이 페이지의 Agent Platform API 예시에서는 Google Cloud CLI를 호출하여 액세스 토큰을 생성하는 다음 별칭을 사용합니다.

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

클러스터 목록 보기

두 인터페이스 모두 클러스터를 한 번에 한 리전씩 나열합니다. 콘솔 Google Cloud 에서는 목록에서 리전을 선택하고 Agent Platform API에서는 리전이 요청 URL의 일부입니다.

콘솔

  1. 콘솔에서 학습 클러스터 페이지로 이동합니다. Google Cloud

    학습 클러스터로 이동

  2. 리전 목록에서 클러스터를 보려는 리전을 선택합니다.

    페이지에 해당 리전의 클러스터가 나열됩니다. 표의 각 열은 클러스터의 속성을 설명합니다.

    열 설명
    ID Agent Platform API 요청에서 CLUSTER_ID로 사용하는 클러스터 ID입니다.
    이름 클러스터의 표시 이름입니다.
    상태 클러스터의 상태입니다. Creating, Running, Updating, Stopping 또는 Error입니다.
    노드 클러스터에 있는 노드 수입니다.
    만든 날짜 클러스터가 생성된 날짜입니다.
    머신 유형 클러스터의 노드 풀에서 사용하는 머신 유형입니다.
    소비 모델 클러스터의 용량을 가져오는 방법입니다. Reservation, Spot, Flex-start 또는 On-demand입니다.

  3. 클러스터를 열려면 이름 열에서 클러스터 이름을 클릭합니다.

REST

한 리전의 클러스터 목록을 보려면 modelDevelopmentClusters 컬렉션에 GET 요청을 보냅니다.

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

다음을 바꿉니다.

  • PROJECT_ID: 프로젝트의 ID입니다.
  • REGION: 클러스터가 있는 리전입니다.

list 메서드는 페이지로 나누기를 제어하기 위해 다음과 같은 선택적 쿼리 매개변수를 지원합니다.

  • pageSize (정수, 선택사항): 응답에서 반환할 최대 클러스터 수입니다. 항목이 더 있더라도 서비스에서 이 값보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 기본 페이지 크기가 사용됩니다.
  • pageToken (문자열, 선택사항): 이전 목록 호출에서 수신한 토큰입니다. 후속 결과 페이지를 가져오려면 이 토큰을 제공하세요.

다음 예시에서는 페이지당 최대 5개의 클러스터로 결과의 첫 번째 페이지를 요청합니다.

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

성공적인 응답에는 최대 5개의 클러스터 리소스가 포함된 modelDevelopmentClusters 배열이 포함되며 nextPageToken 문자열도 포함될 수 있습니다.

클러스터 세부정보 보기

콘솔과 Google Cloud Agent Platform API 모두 클러스터의 구성 과 각 노드의 상태를 비롯한 현재 상태를 보고합니다. Cloud Monitoring 대시보드는 콘솔에서만 사용할 수 있습니다. Google Cloud

콘솔

  1. Google Cloud 콘솔에서 학습 클러스터 페이지로 이동합니다.

    학습 클러스터로 이동

  2. 리전 목록에서 클러스터가 있는 리전을 선택합니다.

  3. 이름 열에서 보려는 클러스터의 이름을 클릭합니다. 개요 탭에서 클러스터 세부정보 페이지가 열립니다.

  4. 탭을 선택하여 해당 세부정보를 확인합니다.

    • 개요: 클러스터의 이름, 설명, 위치와 함께 구성된 컴퓨팅, 네트워크, 조정 설정, 로그인 노드, Slurm 파티션입니다.

    • 노드: 클러스터의 노드를 설명하는 두 개의 표입니다.

    • 로그인 노드: 상태, 이름, 영역, 머신 유형, 내부 IP, 외부 IP, 연결 열이 있습니다. 연결 을 사용하여 로그인 노드에서 SSH 세션을 엽니다.

    • 컴퓨팅 노드: 상태, 이름, 영역, 머신 유형, 내부 IP, 파티션 열이 있습니다.

    • 관측 가능성: 클러스터 전반의 CPU, 메모리, 네트워크 사용량과 함께 GPU 사용률, NVIDIA Data Center GPU Manager (DCGM) 측정항목, GPU 네트워크, GPU 상태를 다루는 사전 빌드된 Cloud Monitoring 대시보드입니다.

클러스터의 현재 상태로 페이지를 다시 로드하려면 새로고침을 클릭합니다. 클러스터를 삭제하려면 삭제를 클릭합니다.

에 설명된 대로 Agent Platform API를 사용하세요.

REST

단일 클러스터의 세부정보를 보려면 클러스터 리소스에 GET 요청을 보냅니다.

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

다음을 바꿉니다.

  • PROJECT_ID: 프로젝트의 ID입니다.
  • REGION: 클러스터가 있는 리전입니다.
  • CLUSTER_ID: 보려는 클러스터의 ID입니다. 콘솔의 학습 클러스터 페이지에 있는 ID 열에 표시되는 값입니다.Google Cloud

응답은 ModelDevelopmentCluster 리소스입니다. 클러스터의 구성과 함께 clusterStatus 필드는 클러스터와 각 노드의 현재 상태를 보고합니다.

  • clusterStatus.state: 클러스터의 상태입니다. PROVISIONING, RUNNING, UPDATING, STOPPING 또는 ERROR 중 하나입니다. 콘솔에는 Google Cloud PROVISIONING이 생성 중으로 표시됩니다.
  • clusterStatus.nodesStatus[]: 클러스터의 각 노드에 대한 항목으로, 노드의 nodeState (PREPARING, RUNNING, UPDATING 또는 ERROR), Compute Engine 인스턴스 이름, 노드 풀, 상태가 마지막으로 변경된 시간을 제공합니다.
  • clusterStatus.detail: 클러스터의 상태에 대한 사람이 읽을 수 있는 설명입니다(사용 가능한 경우).

구성 필드에 대한 설명은 매개변수 참조를 참고하세요.

다음 단계