Relationship between CB-TB Object ID, Name, and CSP resource ID, Name

[seokho-son]

CB-TB는 관리를 위해 오브젝트를 생성하며, 이때 사용자가 요청하는 명칭(name)을 기반으로 오브젝트의 ID를 생성함.
이 ID는 CB-TB의 오브젝트를 관리(CRUD) 하기 위한 주요 identifier 임.

실제 CSP가 생성하는 리소스에는 CSP가 자체적으로 부여하는 ID와 Name이 있기 때문에,
정보 관리를 위해서, 해당 정보도 CB-TB 오브젝트 내에서 포함하여 제공함.

ID와 관련된 정보들은 아래와 같이 구조화 되어 있음.

• Id is unique identifier for the object
  Id string json:"id" example:"aws-ap-southeast-1"

• Uid is universally unique identifier for the object, used for labelSelector
  Uid string json:"uid,omitempty" example:"wef12awefadf1221edcf"

• CspResourceName is name assigned to the CSP resource. This name is internally used to handle the resource.
  CspResourceName string json:"cspResourceName,omitempty" example:"we12fawefadf1221edcf"

• CspResourceId is resource identifier managed by CSP
  CspResourceId string json:"cspResourceId,omitempty" example:"csp-06eb41e14121c550a"

(예시)
https://pkg.go.dev/github.com/cloud-barista/cb-tumblebug@v0.9.13-0.20240920115031-d215e08dd910/src/core/model#TbVmInfo

여기서

• cspResourceName 은 CSP 콘솔상에서는 리소스의 명칭에 해당하며,
• cspResourceId 는 CSP 콘솔상에서는 리소스의 ID에 해당함. (단, CSP에서 특별히 Name을 구분하지 않고 ID로만 활용하는 경우는, 두 필드의 값이 동일할 수 있음)

예를 들어, MCI(MC-Infra) 오브젝트 조회 API를 통해서, 내부 VM 정보를 확인해보면, CB-TB VM 오브젝트의 cspResourceName를 찾을 수 있으며,

이 cspResourceName가 AWS 콘솔에서는 아래와 같이 instance의 name과 동일하게 매핑되어 있음

만약, CB-TB를 이용해서 생성한 리소스의 비용 정보를 CSP에서 직접 확인하고 싶은 경우
cspResourceName 또는 cspResourceId 의 정보를 활용해서 찾을 수 있음. (향후 Tag 기능이 추가되는 경우, Tag를 통해 확인도 가능)

• uid는 label 단위로 CB-TB 오브젝트를 선택할 수 있도록 지원하는, system-wide Univertial ID 임.
  cspResourceName를 지정하는데도 활용함. (참고: 두 개의 값을 일반적으로 동일하게 처리하는 이유는, 내부 ID 정보 체계 복잡성을 완화하기 위한 노력임)

---

Assets으로써의 spec, image 의 경우, 혼동을 줄이기 위해서 CspResourceId 는 포함하지 않음

• Id is unique identifier for the object
• Uid is universally unique identifier for the object, used for labelSelector
• CspSpecName is name assigned to the CSP resource. This name is internally used to handle the resource.
• CspImageName is name assigned to the CSP resource. This name is internally used to handle the resource.

---

[seokho-son]

네트워크 리소스 예시 (CB-TB의 vNet 오브젝트와 AWS의 VPC)

• CB-TB vNet 오브젝트:
  

• AWS의 VPC 리소스: