VM Spec Info Guide - cloud-barista/cb-spider GitHub Wiki

1. CB-Spider VM Spec Info 개요

• 사용자는 VM Spec Name을 설정하여 해당 VM Spec의 속성(VCPU., MEM 등 자원 규모 정보)을 준수하는 VM을 생성 요청할 수 있다.

• CB-Spider가 제공하는 VM Spec 정보 및 제공 VM Spec으로부터 생성된 VM의 정보와의 관계가 아래 그림과 같다.

• 사용자는 추상화된 CB-Spider VM Spec 정보를 활용하여 원하는 운영 환경(CPU 개수, Memory 크기 등)의 VM을 생성 요청할 수 있다.

2. CB-Spider VM Spec Info API 및 제공 정보 규격

• 사용자는 다음과 같은 CB-Spider REST API를 이용하여 VM Spec 정보를 JSON 규격으로 제공 받는다.

  GET /vmspec            - List VM Specs
  GET /vmspec/{Name}     - Get VM Spec
  GET /vmorgspec         - List Original VM Specs
  GET /vmorgspec/{Name}  - Get Original VM Spec
  

• 제공 되는 JSON 결과에 포함된 정보는 다음과 같다.

  속성 명칭	제공 정보	제공 값 예시
  Name	CSP가 관리 및 제공하는 VM Spec Name 정보	● t2.micro, Standard_D2a_v4 등
  Region	VM Spec을 제공하는 Region Name 정보	● us-east-1, northeurope 등
  VCpu	VM Spec으로 생성되는 VM의 CPU 자원 정보, Count(개수)와 ClockGHz(Frequency) 정보로 구성	● {2, 2.5}, {32, 3.0} 등 ● -1: CSP가 값을 제공하지 않음
  MemSizeMiB	VM Spec으로 생성되는 VM의 Memory 크기 정보	● 1024, 16384 등
  DiskSizeGB	VM Spec으로 생성되는 VM의 Root Disk 크기 정보, CSP에 따라 VM에 필요한 임시 Disk 영역 등을 포함 가능	● 8, 100 등 ● -1: CSP가 값을 제공하지 않음
  Gpu	VM Spec으로 생성되는 VM이 활용 가능한 GPU 정보, Count(개수), Mfr(제조회사), Model(모델), MemSizeGB(단일 GPU 메모리 크기), TotalMemSizeGB(전체 GPU 메모리 크기) 정보로 구성	● {2, NVIDIA, Tesla T4, 16, 32}, {8, NVIDIA, H100, 85, 687} 등 ● NA | -1: CSP가 값을 제공하지 않음
  KeyValueList	CSP가 제공하는 VM Spec 정보를 Key/Value List 형태로 제공	● "KeyValueList" : [       {          "Key" : "AutoRecoverySupported",          "Value" : “false"       },       {          "Key" : "Hypervisor",          "Value" : "nitro"       },       …

3. CB-Spider VM Spec Info API 및 제공 정보 예시

• AWS g6e.48xlarge VM Spec 정보 호출 API 및 제공 정보 예시가 다음과 같다.

  curl -sX 'GET' 'http://localhost:1024/spider/vmspec/g6e.48xlarge?ConnectionName=aws-config01' | json_pp
  

  {
        "Name" : "g6e.48xlarge",
        "Region" : "us-east-2",
        "VCpu" : {
              "ClockGHz" : "3.4",
              "Count" : "192"
           },
        "MemSizeMib" : "1572864",
        "DiskSizeGB" : "-1",
        "Gpu" : [
              {
                 "Count" : "8",
                 "MemSizeGB" : "384",
                 "Mfr" : "NVIDIA",
                 "Model" : "L40S",
                 "TotalMemSizeGB" : "3072"
              }
           ],
           "KeyValueList" : [
                 {
                    "Key" : "AutoRecoverySupported",
                    "Value" : “false"
                 },
                 {
                    "Key" : "GpuInfo",
                    "Value" : "{Gpus:[{Count:8,Manufacturer:NVIDIA,MemoryInfo:{SizeInMiB:366211},Name:L40S}],TotalGpuMemoryInMiB:2929688}"
                 },
                 …
           ]
  }
  

4. CB-Spider VM Spec Info AdminWeb 제공 예시

• 다음 순서로 대상 CSP 선택 및 VM Spec 정보를 요청한다.

• AWS VM Spec Info 제공 정보 예시가 다음과 같다.