[rdbms] Q&A for API Integration

[yunkon-kim]

RDBMS API 통합을 위한 Q&A 이슈입니다.

답글로 계속해서 문의 드리겠습니다.

[yunkon-kim]

AWS 테스트 중에 Console에서 확인이 필요한 경우가 있어서 문의드립니다.
어떤 Managed Service가 추상화 되었을까요?

• 정상적으로 생성한 후, 삭제 시 이슈가 있었던 상황입니다.
• Aurora and RDS 에서 확인되는 자원/서비스가 없었고,
• 재 생성했더니 기존에 존재한다는 오류가 발생했습니다.
• 삭제 로직 버그 픽스 후 매뉴얼하게 호출하여 삭제(?) 조치한 상황입니다.

(추가)
RDBMS 생성 시 아래 정보가 확인됩니다. 이 정도 참조할 수 있는 것이 맞는지 확인 부탁드립니다.

[yunkon-kim]

Tag와 관련하여 API 문서 업데이트가 필요해 보입니다.

CB-Spider RDBMS Tag Management Test를 공유해 주셨는데요.

Spider v0.12.42 API 규격 상에는 반영되지 않은 것 같습니다.

[powerkimhub]

어떤 Managed Service가 추상화 되었을까요?

• RDS 대상으로 추상화 되었습니다.
• AWS Console: Aurora and RDS => Databases에서 생성 후 목록이 표시됨을 확인했습니다.
• 기존 존재 오류는 다른 상황으로 보이면, 이때 발생하는 로그를 붙여봐 주시길.
• 추가로, 각 CSP별 대상 서비스를 정리해서 공유 예정입니다.

[powerkimhub]

Spider v0.12.42 API 규격 상에는 반영되지 않은 것 같습니다.

• 감사합니다.
• 빠트렸네요. 반영하겠습니다.

---

=> 반영: #1800

[yunkon-kim]

감사합니다. DBMS까지만 생성했을 때에는 Console에서 확인되는 정보가 없어서 문의드렸던 부분입니다.
오류는 Tumblebug에 통합하는 과정에서의 버그 입니다. Spider 에서 살펴봐 주시면 좋은 부분이 있으면 log 함께 공유드리겠습니다.

[powerkimhub]

AWS 테스트 중에 Console에서 확인이 필요한 경우가 있어서 문의드립니다. 어떤 Managed Service가 추상화 되었을까요?

• CSP별 서비스 및 Console 위치 참고하세요.
  • [RDBMS Management Guide] 1.2 Target Service and Console per CSP

[yunkon-kim]

@powerkimhub 네, 감사합니다. 참고하겠습니다.

[powerkimhub]

[RDBMS MetaInfo API 반환 구조 변경]

• 기존 VMSpec에서와 같이 Attribute에 단위 추가했습니다.
  • RDBMSMetaInfo.StorageSizeRange → StorageSizeRangeGB
  • [RDBMS] Fix: Rename StorageSizeRange to StorageSizeRangeGB and apply GB unit conversion per CSP #1804
• DBInstanceSpec 제공 추가 후에 함께 Pre-Release 예정입니다.

[powerkimhub]

@yunkon-kim

---

[Spider Database 관련 구성안 및 개요]

• Database(DB) = RDBMS + NoSQL

  • RDBMS: MySQL | MariaDB | PostgreSQL 등 (RDBMS 배포 API에 dbengine 선택 방식)
  • NoSQL: MongoDB | Redis | Cassandra 등 (MongoDB 외 지원 미정)

• DBSpec(Database Spec)

  • DB 구분없이 DB 생성 시 필요한 인스턴스 스펙(vCPU, Memory 등의 정보를 포함)
  • VMSpec처럼 일관되게 DBSpec으로 Naming

---

* 위 방향으로 정리하느라 기존 API 일부 변경되었으니, 
* 사용중인 API인 경우 참고하시기 바랍니다. 
* DB 생성을 위한 Spec의 상세 정보를 제공하는 DBSpec이 추가되었습니다.

• 대상 버전: v0.12.45

(1) 기존 API 변경
[DBInstanceSpec을 DBSpec로 이름 변경] --- #1806

• DBInstanceSpec => DBSpec
• DBInstanceSpecOptions => DBSpecOptions

(2) 반환값 제공 방법 변경

• IBM의 rdbmsmetainfo:DBSpecOptions 값 제공 방법 개선
  • [AS-IS] Driver에서 static 코딩된 정보로 제공
  • [TO-BE] API로 동적 획득으로 제공

(3) 기능/API 추가

• [CSP의 DB engine 별로 DBSpec 정보 제공]
  • Database Spec 정보는 RDBMS 관리 쪽이 아닌, Metadata 쪽으로 분류

• [CSP별 제공하는 RDBMS DBEngine 목록 제공]
  • Connection(csp)이 제공하는 rdbms engine 목록 제공

(4) [변경 후 기존 시험 결과]

• MySQL: PASS

=================================================================================================================================================================================
                                              RDBMS CREATE & INFO TEST SUMMARY - ALL CSPs
=================================================================================================================================================================================

CSP          | Status      | Engine   | Version      | Spec                     | Storage                  | Endpoint                                 | PublicAccess | Elapsed
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
AWS          | Available   | mysql    | 8.0.46       | db.t3.medium             | 100GB|gp2                | cb-spider-mysql-test-d9vhetc2mn9dvmkc53a0.cbe86kw08whp.ap-southeast-2.rds.amazonaws.com:3306 | true         | 5m11s
AZURE        | Available   | mysql    | 8.0.21       | Standard_B1ms            | 20GB|Premium_LRS         | cb-spider-mysql-test-d9vhetk2mn9dvmkc53bg.mysql.database.azure.com:3306 | true         | 4m36s
GCP          | Available   | mysql    | 8.0          | db-custom-2-8192         | 20GB|PD_SSD              | 34.59.217.207:3306                       | true         | 3m25s
ALIBABA      | Available   | mysql    | 8.0          | mysql.n4.large.1         | 20GB|cloud_essd          | 8.141.139.88:3306                        | true         | 2m50s
TENCENT      | Available   | mysql    | 8.0          | 8000                     | 50GB|local_ssd           | bj-cdb-63xonjda.sql.tencentcdb.com:28948 | true         | 4m52s
IBM          | Available   | mysql    | 8.4          | multitenant              | 30GB|NA                  | 843563ef-f035-4c28-801b-9c258e59a1db.c2f3lg8w0g8s0rkj98i0.databases.appdomain.cloud:31639 | true         | 10m4s
OPENSTACK    | Available   | mysql    | 5.7.29       | m1.small                 | 20GB|NA                  | 183.111.177.159:3306                     | true         | 4m28s
NCP          | Available   | mysql    | MYSQL8.0.36  | SVR.VDBAS.AMD.STAND.C002.M008.NET.SSD.B050.G003 | 10GB|SSD                 | db-49m4bs.vpc-cdb.ntruss.com:3306        | N/A          | 12m26s
NHN          | Available   | mysql    | MYSQL_V8408  | m2.c2m4                  | 20GB|General SSD         | 18d7dcf5-6250-43e8-a654-e7d4faf0e7d5.external.kr1.mysql.rds.nhncloudservice.com:3306 | true         | 10m21s
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Failed : 0

• MariaDB: OpenStack MariaDB 디버깅 예정

=======================================================================================================
             RDBMS DATABASE MANAGEMENT TEST SUMMARY - ALL CSPs (MariaDB)
=======================================================================================================

CSP          | CreateDB   | ListDB   | FoundInList  | DeleteDB   | VerifyDeleted | Elapsed
-------------------------------------------------------------------------------------------------------
AWS          | PASS       | PASS     | FOUND        | PASS       | PASS          | 8s
ALIBABA      | PASS       | PASS     | FOUND        | PASS       | PASS          | 20s
OPENSTACK    | FAIL       | FAIL     | NOT_FOUND    | FAIL       | FAIL          | 1s
NHN          | PASS       | PASS     | FOUND        | PASS       | PASS          | 30s
-------------------------------------------------------------------------------------------------------

Total: 3 PASS, 1 FAIL

[yunkon-kim]

@powerkimhub 감사합니다. 업데이트할 때 참고하겠습니다.

[powerkimhub]

@yunkon-kim

• OpenStack MariaDB 시험이 완료 되었습니다. (#1809)
  • 코드 변경은 없고, 시험 스크립트에서 MariaDB Version 변경으로 성공함
  • cf) MariaDB Coverage and Validation Status
• 다음 배포판에 포함되었습니다.
  • https://github.com/cloud-barista/cb-spider/releases/tag/v0.13.0

[yunkon-kim]

@powerkimhub

Tumblebug에서 RDBMS (DBEngine: MySQL) 통합 진행 현황을 공유드립니다. (Spider v0.13.0)

• AWS, Azure, GCP, Alibaba, IBM, Tencent를 대상으로 통합 및 테스트 완료되었습니다.

• Tumblebug에 RDBMS 생성/삭제 안정성을 높이기 위한 로직이 추가 되었습니다.

  • Creation and Deletion Reliability

• 지원 범위, 기본값, AdminUsername/Password 제약, Direct Connection (TLS) 요구사항 등은 문서에 작성해 놓았습니다.

  • RDBMS Management - Features and API Reference

---

NCP, NHN, OpenStack 테스트가 예정되어 있으며, 이후에 MariaDB 진행할 계획입니다.

[yunkon-kim]

@powerkimhub

Tumblebug RDBMS (DBEngine: MySQL) 통합 및 테스트 현황을 공유드립니다.

• enhance(rdbms): stabilize multi-CSP CRD and harden data I/O testing cb-tumblebug#2716

오프라인 논의 사항인 "NHN 정책 변경" 건은 Spider 차기 버전이 릴리스 되면 반영하도록 하겠습니다.

[yunkon-kim]

@powerkimhub

Tumblebug RDBMS (DBEngine: MariaDB) 통합 및 테스트 현황을 공유드립니다.

• enhance(rdbms): test MariaDB and enhance stability cb-tumblebug#2718