kt

KT Cloud VPC(D1 platform) Connection driver Build 및 CB-Spider에 적용 방법

# 연동 Driver 관련 기본적인 사항은 아래 link 참고

• Cloud Driver Developer Guide

# CB-Spider에 KT Cloud VPC 연동 driver 적용 방법

​ O 위에서와 같이 CB-Spider 코드가 clone된 상태에서 CB-Spider setup 파일 적용

$CBSPIDER_ROOT/ source setup.env

​ O Dynamic plugin mode로 'CB-Spider' 및 driver build 실행

cd $CBSPIDER_ROOT

make dyna

• CB-Spider build 과정이 완료되면, $CBSPIDER_ROOT/bin/ 아래에 binary 파일로 'cb-spider-dyna' 가 생김
• 각 driver는 $CBSPIDER_ROOT/cloud-driver-libs/ 아래에 binary 파일로 'ktcloudvpc-driver-v1.0.so' 와 같이 생성됨.

​ O CB-Spider server 구동(Dynamic plugin 방식, 1024 포트로 REST API server가 구동됨)

cd $CBSPIDER_ROOT/bin

./start-dyna.sh

• CB-Spider server가 구동된 후, KT Cloud VPC driver 등록 과정을 거치고 사용

# CB-Spider에 KT Cloud VPC 연동 driver 테스트 방법

​ O 아래의 KT Cloud VPC connection config script 파일에 KT Cloud VPC Credential 정보 기입 후 실행

$CBSPIDER_ROOT/api-runtime/rest-runtime/test/connect-config/15.ktcloudvpc-conn-config.sh

# CB-Spider REST API 이용 KT Cloud VPC driver 모든 기능 테스트

​ O KT Cloud VPC 각 자원 생성, 자원정보 조회, VM instance Start 및 Terminate 테스트 등 실행 가능

• Curl command를 이용하여 CB-Spider REST API를 호출하는 테스트 script 이용

$CBSPIDER_ROOT/api-runtime/rest-runtime/test/full-test/14.ktcloudvpc-test.sh
$CBSPIDER_ROOT/api-runtime/rest-runtime/test/full-test/ktcloudvpc-full_test.sh

# KT Cloud VPC 연동 driver 자체 test 파일을 이용한 기능 테스트

​ O CB-Spider 환경 파일 적용

$CBSPIDER_ROOT/ source setup.env

​ O 아래의 config 파일에 KT Cloud VPC Credential 정보 기입

$CBSPIDER_ROOT/cloud-control-manager/cloud-driver/drivers/ktcloudvpc/main/conf/config.yaml

​ O 아래의 위치에 있는 ~.sh 파일을 실행해서 KT Cloud VPC driver 각 handler 세부 기능 테스트

$CBSPIDER_ROOT/cloud-control-manager/cloud-driver/drivers/ktcloudvpc/main/

# KT Cloud VPC 연동 driver를 이용해 생성한 VM에 로그인하는 방법

​ O Cloud-Barista KT Cloud VPC driver를 이용해 생성된 VM에 로그인하는 방법

• Linux 계열 guest OS의 경우, 사용자가 keyPair 생성시 생성되는 private key를 local에 저장해놓고, 그 private key를 이용해 'cb-user' 계정으로 SSH를 이용해 로그인함.

• Private key 파일을 이용한 Linux 계열 VM 접속 방법

ssh -i /private_key_경로/private_key_파일명(~~.pem) cb-user@VM의_public_ip

# KTCloud VPC (KT Cloud D1 플랫폼) driver 사용시 참고 및 주의 사항

O VM 생성시 아래의 사항을 참고

• KT Cloud D 플랫폼에서 VM 생성시, 조회된 VMSpec 목록 중 ~.itl 이라는 이름의 VMSpec으로 VM을 생성해야 정상적으로 생성됨.
  • Ex) 16x16.itl
• VM 생성시 option으로 설정하는 root disk size는 Ubuntu / Red Hat Linux / Rocky 종류의 OS는 50GB/100GB만 지원하고, Debian OS는 50G만 지원, 그리고, MS Windows OS의 경우는 100GB/150GB로만 지원함.

​ O VPC, Subnet 관리시 아래의 사항을 참고

• KTCloud VPC에서는 단일(default) VPC를 제공하며, 단일 VPC를 제공하지만 driver를 기준으로는 어떤 이름으로든 생성 가능하고, 삭제도 제공함.

  • Default CIDR : 172.25.0.0/12
  • 본 Drvier 기준으로는 이 defualt VPC에 사용자가 지정하는 이름이 붙여짐.

• KTCloud VPC 서비스에서는 Subnet과 같은 개념으로 'Tier'라는 개념을 사용함.

  • VPC는 상기와 같이 단일 VPC를 제공하지만, subnet은 추가, 삭제 등의 제어가 가능함.(AddSubnet, RemoveSubnet 기능 지원함.)

  • (주의) Default subnet(tier)인 'DMZ', 'Private', 'external' subnet은 삭제 할 수 없으며, 기본적으로 아래의 CIDR을 사용하고 있으니 subnet 생성시 아래의 대역 외의 CIDR을 지정해야함.

    • DMZ subnet : 172.25.0.1/24, Private subnet : 172.25.1.1/24, external subnet : CIDR 없음.

  • VPC의 CIDR은 172.25.0.0/12 대역이지만, subnet (tier) 생성시 172.25.X.X 외에도 Custom Tier로서 10.10.X.X, 192.168.X.X 등의 대역을 자유롭게 지정해서 생성할 수 있음.(VM에 그 대역의 private IP가 할당됨.)

  • Subnet(Tier)는 기본적으로 B Class 네트워크를 Subnet으로 나누어서 사용함.

    • 172.25.X.X 대역의 경우, 내부적으로 172.25.0.0/16의 B Class 네트워크를 나누어 사용됨.
    • 실제 subnet(tier) 생성시 C Class 대역 기준으로 나누어 생성됨. Ex) C Class 숫자가 '3'이면 tier는 172.25.3.0/24 대역으로 생성됨.
      • 드라이버 내부적으로, VM 생성시 subnet C Class 대역에서 D Class가 11~140번까지의 privatge IP가 VM에 할당됨.

• (참고) Create/Add Subnet시 log에 Error가 발생해도 무시하면됨. KT Cloud D1 Platform의 버그임.

​ O Security Group 생성시 아래의 사항을 참고

• KTCloud VPC에서는 Security Group(S/G) 개념을 지원하지 않지만, 본 드라이버에서 S/G을 생성한 후 VM 생성시 그 S/G을 적용 가능함.
  • 사용자가 S/G을 정의하면, 드라이버 내부적으로, VM 생성시 public IP가 생성된 후 그 security rule들이 Port forwarding rule, Firewall rule로 전환되어 반영됨.
• KTCloud VPC에서는 outbound rule도 지원하기 때문에 VM에서 outbound 통신이 필요시 반드시 S/G의 outbound 로서 해당 protocol 및 port를 열여줘야함.
  • 주의 : S/G 생성시, 사용자가 outbound 방향의 설정을 하지 않을 경우, outbound 방향으로 모든 protocol에 대해 모든 port가 열리는 설정이 반영됨.(Default 값)
  • 만약 사용자가 S/G 생성시, outbound 방향의 어떤 protocol에 대해 port를 open하는 설정을 하면 상기 outbound 방향의 default 값은 적용되지 않고 사용자의 설정값이 적용됨.

O NLB 생성시 아래의 사항을 참고

• KT Cloud는 NLB 생성시 주요 parameter 중의 하나로 subnet(Tier)이 지정되고 그 subnet(Tier)의 NLB 범위 내에 NLB가 생성됨.
  • CB-Spider 공통 인터페이스에는 NLB 생성시 subnet을 지정하는 parameter가 존재하지 않으니, 본 드라이버에는 NLB에 추가하는 VM이 속한 subnet 정보를 NLB용 subnet으로 지정함.
  • (참고) KT Cloud는 서로 다른 subnet 내에 생성된 VM을 하나의 NLB에 적용 불가함.

O Shared FileSystem (NAS) volume 생성시 아래의 사항을 참고

• NAS volume 생성시, 기 생성되어있는 하나의 subnet(Tier)이 필수적으로 지정되어야함.
  • Spider의 'Access Subnet Name' parameter로서 subnet(Tier) name 입력 필요
  • NAS 생성 요청시, 본 driver 내부적으로 그 subnet(Tier) 기준으로 NAS volume 생성에 필요한 shared network이 먼저 생성됨.
• CB-Spider에서 Shared FileSystem용 protocol은 현재 'NFS' 기준으로 지원함.(CIFS는 미지원)
• KT Cloud는 현재 NFS version으로 '3.0'만 지원함.
• Spider 기준, FileSystem Type은 'ZONE-TYPE'을 default로 지원함.
• NAS volume sizes는 500GB ~ 10,000GB 범위를 지원함.
• KT Cloud NAS volume은 내부적으로 'HDD' type만을 지원함.