Public Image Info Guide - cloud-barista/cb-spider GitHub Wiki

1. CB-Spider Public Image Info 개요

• 사용자는 Public Image ID를 설정하여 해당 Image의 속성(arch., OS 등)을 준수하는 VM을 생성 요청할 수 있다.

• CB-Spider가 제공하는 Public Image 정보 및 제공 이미지로부터 생성된 VM의 OS 정보와의 관계가 아래 그림과 같다.

• 사용자는 추상화된 CB-Spider Public Image 정보를 활용하여 원하는 운영 환경(Arm, Ubuntu 22.04 등)의 VM을 생성 요청할 수 있다.

2. CB-Spider Public Image Info API 및 제공 정보 규격

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

  GET /vmimage        - List Public Images
  GET /vmimage/{Name} - Get Public Image
  

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

  속성 명칭	제공 정보	제공 값 예시
  IId(NameId, SystemId)	CSP가 관리 및 제공하는 Image ID 정보(NameId=SystemId)	● ami-00edcba5512df4d24, img-pi0ii46r 등
  OSArchitecture	Image로 생성되는 VM의 OS Architecture 정보	● arm32, arm64, arm64_mac, x86_32, x86_32_mac, x86_64, x86_64_mac 중 한가지 값 ● NA: CSP가 값을 제공하지 않음
  OSPlatform	Image로 생성되는 VM의 OS Platform 정보	● Linux/UNIX 또는 Windows ● NA: CSP가 값을 제공하지 않음
  OSDistribution	Image로 생성되는 VM의 OS Distribution 정보	● Deep Learning Base Neuron AMI (Ubuntu 22.04) 등, CSP가 정의한 값
  OSDiskType	Image로 생성되는 VM의 OS Disk Type 정보	● ebs, Common BlockStorage 1 등 ● NA: CSP가 값을 제공하지 않음
  OSDiskSizeGB	Image로 생성되는 VM의 OS Disk Size 또는 최소 Size 정보, CSP에 따라 OS에 필요한 임시 Disk 영역 등을 포함 가능	● 10, 30 등 ● -1: CSP가 값을 제공하지 않음
  ImageStatus	현재 Image 사용 가능 상태 정보	● Available 또는 Unavailable ● NA: CSP가 값을 제공하지 않음
  KeyValueList	CSP가 제공하는 원본 Image 정보를 Key/Value List 형태로 제공	● "KeyValueList" : [       {          "Key" : "Architecture",          "Value" : "x86_64"       },       {          "Key" : "Hypervisor",          "Value" : "xen"       },       …

3. CB-Spider Public Image Info API 및 제공 정보 예시

• AWS ami-00edcba5512df4d24 Image 정보 호출 API 및 제공 정보 예시가 다음과 같다.

  curl -sX 'GET' 'http://localhost:1024/spider/vmimage/ami-00edcba5512df4d24?ConnectionName=aws-config01' | json_pp
  

  {
     "IId" : {
        "NameId" : "ami-00edcba5512df4d24",
        "SystemId" : "ami-00edcba5512df4d24"
     },
     "ImageStatus" : "Available",
     "OSArchitecture" : "x86_64",
     "OSDiskSizeGB" : "-1",
     "OSDiskType" : "ebs",
     "OSDistribution" : "Deep Learning Base Neuron AMI (Ubuntu 22.04) 20241101",
     "OSPlatform" : "Linux/UNIX“,
     "KeyValueList" : [
        {
           "Key" : "Architecture",
           "Value" : "x86_64"
        },
        {
           "Key" : "BlockDeviceMappings",
           "Value" : "{DeviceName:/dev/sda1,Ebs:{DeleteOnTermination:true,Encrypted:false,Iops:3000,KmsKeyId:null,OutpostArn:null,SnapshotId:snap-0b054f1cb9fd1bf5d,Throughput:125,VolumeSize:35,VolumeType:gp3},NoDevice:null,VirtualName:null}; {DeviceName:/dev/sdb,Ebs:null,NoDevice:null,VirtualName:ephemeral0}; {DeviceName:/dev/sdc,Ebs:null,NoDevice:null,VirtualName:ephemeral1}"
        },
        {
           "Key" : "State",
           "Value" : "available"
        },
        …
     ]
  }
  
  

4. CB-Spider Public Image Info AdminWeb 제공 예시

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

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