cb-spider

README

cb-spider

   

CB-Spider is a sub-framework of the Cloud-Barista Multi-Cloud Platform.
CB-Spider offers a unified view and interface for multi-cloud management.

[NOTE]
CB-Spider is currently under development. (not v1.0 yet)
We welcome any new suggestions, issues, opinions, and contributors !
Please note that the functionalities of Cloud-Barista are not stable and secure yet.
Be careful if you plan to use the current release in production.
If you have any difficulties in using Cloud-Barista, please let us know.
(Open an issue or Join the Cloud-Barista Slack)

---

▶ Quick Guide

---

[목 차]

1. 실행 환경
2. 실행 방법
3. 제공 자원
4. VM 계정
5. 활용 방법
6. API 규격
7. 특이 사항
8. 활용 정보

---

1. 실행 환경

• 공식환경
  • OS: Ubuntu 22.04
  • Build: Go 1.21
  • Container: Docker v19.03
• 시험환경
  • OS: , Ubuntu 22.04, Ubuntu 20.04, Ubuntu 18.04, Debian 10.6, macOS Ventura 13.5, macOS Catalina 10.15, Android 8.1 등
  • Build: Go 1.21, Go 1.19, Go 1.18, Go 1.16
  • Container: Docker v19.03, Docker v20.10

2. 실행 방법

• 소스 기반 실행: https://github.com/cloud-barista/cb-spider/wiki/Quick-Start-Guide
• 컨테이너 기반 실행: https://github.com/cloud-barista/cb-spider/wiki/Docker-based-Start-Guide
• cb-operator 기반 실행: https://github.com/cloud-barista/cb-operator

3. 제공 자원

Provider	Region/Zone Info	Image Info	VMSpec Info	VPC Subnet	Security Group	VM KeyPair	VM	NLB/Disk/ MyImage	managed-K8S
AWS	O	O	O	O	O	O	O	O	Coming Soon
Azure	O	O	O	O	O	O	O	O	O
GCP	O	O	O	O	O	O	O	O	Coming Soon
Alibaba	O	O	O	O	O	O	O	O	O
Tencent	O	O	O	O	O	O	O	O	O
IBM VPC	O	O	O	O	O	O	O	O	Coming Soon
OpenStack	O	O	O	O	O	O	O	O	-
NCP Classic	O	O	O	O (Type-1)	O (Note-1)	O	O	O	-
NCP VPC	O	O	O	O	O	O	O	O	-
NHN	O	O	O	O (Type-2)	O	O	O (Note-2)	O	Coming Soon
KT Classic	O	O	O	O (Type-1)	O	O	O	O	-

※ VPC 특이사항(세부 내용: 각 드라이버 Readme 참고)
    ◉ Type-1: VPC/Subnet Emulation
      - CSP: VPC 개념 제공하지 않음
      - CB-Spider: API 추상화를 위한 단일 VPC/Subnet 생성 제공 (두개 이상 VPC/Subnet 생성 불가)
      - CIDR: 제공하지 않음(설정 무의미)
    ◉ Type-2: Internet 개방 조치 필요 (세부내용: #1109 참고)
      - CSP(NHN) IG(Internet Gateway) 제어 API 부재(추후 제공 예정)
      - Console에서 IG 생성 후 VPC의 default Routing Table 연결 필요
    ◉ Type-3: default VPC 활용 (KT VPC)
      - CSP: 생성 제공 없이 고정된 default VPC 1개만 제공
      - CB-Spider: API 추상화를 위한 단일 VPC 생성만 제공 (이름 등록 수준)
        - 두개 이상 VPC 생성 불가, Subnet은 추가/삭제 가능

※ Security Group 특이사항(세부 내용: 각 드라이버 Readme 참고)
    ◉ Note-1: Console에서 사전 생성 후 동일 이름으로 생성 요청(CSP: Create API 부재)
      - 또는 등록 기능 활용
      - 등록 예시
          curl -sX POST http://localhost:1024/spider/regsecuritygroup -H 'Content-Type: application/json' -d \
           	'{
           		"ConnectionName": "'${CONN_CONFIG}'", 
           		"ReqInfo": { "VPCName": "'${VPC_NAME}'", "Name": "'${SG_NAME}'", "CSPId": "'${SG_CSPID}'"} 
           	}'
      
※ VM 특이사항(세부 내용: 각 드라이버 Readme 참고)
    ◉ Note-2: Wdindows VM일 경우 SSH Key 사용한 VM 생성 후 Console에서 Key를 이용하여 PW 확인 필요

4. VM 계정

• Ubuntu, Debian VM User: cb-user
• Windows VM User: Administrator

5. 활용 방법

• 사용자 기능 및 활용 가이드 참고

6. API 규격

• 인터페이스 규격 및 예시

7. 특이 사항

• 개발상태: 주요기능 중심 개발추진 중 / 기술개발용 / 상용활용시 보완필요

8. 활용 정보

• 위키: https://github.com/cloud-barista/cb-spider/wiki