cb-tumblebug

CB-Tumblebug (Multi-Cloud Infra Service Management)

A Framework for Cloud-Barista Platform to Manage Multi-Cloud Infra Service (i.e., MCIS)

[NOTE]
CB-Tumblebug is currently under development. (the latest version is 0.2 cappuccino)
So, we do not recommend using the current release in production.
Please note that the functionalities of CB-Tumblebug are not stable and secure yet.
If you have any difficulties in using CB-Tumblebug, please let us know.
(Open an issue or Join the cloud-barista Slack)

---

[목차]

1. 실행 환경
2. 실행 방법
3. 소스 기반 설치 & 실행 상세 정보

---

[실행 환경]

• Linux (검증시험: Ubuntu 18.04)

[실행 방법]

(1) 컨테이너 기반 실행

• CB-Tumblebug 이미지 확인(https://hub.docker.com/r/cloudbaristaorg/cb-tumblebug/tags)
• CB-Tumblebug 컨테이너 실행

# docker run -p 1323:1323 \
-v /root/go/src/github.com/cloud-barista/cb-tumblebug/meta_db:/app/meta_db \
--name cb-tumblebug \
cloudbaristaorg/cb-tumblebug:v0.1-yyyymmdd

(2) 소스 기반 실행

• Go 설치 & Git 설치
• 환경 변수 설정
• CB-Tumblebug 소스 다운로드 (Git clone CB-Tumblebug)
• 의존 라이브러리 다운로드
  • Cloud-Barista alliance 설치 (CB-Store, CB-Log, CB-Spider)
  • 기타 라이브러리
• CB-Tumblebug 빌드 (make)
• CB-Tumblebug 실행 (make run)

(3) Cloud-Barista 시스템 통합 실행 참고 (cb-operator)

https://github.com/cloud-barista/cb-operator 를 통해 Cloud-Barista 전체 FW를 통합 실행할 수 있음

$ git clone https://github.com/cloud-barista/cb-operator.git
$ cd cb-operator/src
cb-operator/src$ go build -o operator

[소스 기반 설치 & 실행 상세 정보]

• Git 설치

  • # apt update
  • # apt install git

• Go 설치

  • https://golang.org/doc/install (2019년 11월 현재 apt install golang 으로 설치하면 1.10 설치됨. 이 링크에서 1.12 이상 버전으로 설치할 것)
  • wget https://dl.google.com/go/go1.13.4.linux-amd64.tar.gz
  • tar -C /usr/local -xzf go1.13.4.linux-amd64.tar.gz
  • .bashrc 파일 하단에 다음을 추가:

  export PATH=$PATH:/usr/local/go/bin
  export GOPATH=$HOME/go
  

• .bashrc 에 기재한 내용을 적용하기 위해, 다음 중 하나를 수행

  • bash 재기동
  • source ~/.bashrc
  • . ~/.bashrc

• CB-Tumblebug 소스 다운로드

  • # go get -u -v github.com/cloud-barista/cb-tumblebug

• 의존 라이브러리 다운로드

  • etcd 설치 및 실행

  # apt install etcd-server
  # etcd --version
  # ETCD_IP=<ETCD-Host-IPAddress>
  # etcd --name etcd-01 --initial-advertise-peer-urls http://$ETCD_IP:2380 --listen-peer-urls http://$ETCD_IP:2380 --listen-client-urls http://$ETCD_IP:2379,http://127.0.0.1:2379 --advertise-client-urls http://$ETCD_IP:2379 --initial-cluster-token "etcd-cluster-1" --initial-cluster etcd-01=http://$ETCD_IP:2380 --initial-cluster-state new  &

  • Cloud-Barista alliance 설치 (CB-Log)

    • go get -u -v github.com/cloud-barista/cb-log
    • https://github.com/cloud-barista/cb-log README를 참고하여 설치 및 설정

  • Cloud-Barista alliance 설치 (CB-Store)

    • go get -u -v github.com/cloud-barista/cb-store
    • https://github.com/cloud-barista/cb-store README를 참고하여 설치 및 설정

  • Cloud-Barista alliance 설치 (CB-Spider)

    • go get -u -v github.com/cloud-barista/cb-spider
    • https://github.com/cloud-barista/cb-spider README를 참고하여 설치 및 설정

• CB-Tumblebug 실행에 필요한 환경변수 설정

  • source setup.env (cb-tumblebug/conf 에 setup.env)
  • cb-tumblebug/conf 에 store_conf.yaml 내용 확인 및 설정 (CB-Store 설정)
    • storetype 지정 (NUTSDB 또는 ETCD 지정)
    • NUTSDB(local DB) 설정시 DB 데이터가 포함된 주소 지정이 필요 (기본은 cb-tumblebug/meta_db/dat 에 파일로 추가됨)
  • cb-tumblebug/conf 에 log_conf.yaml 내용 확인 및 설정 (CB-Log 설정)

CB-Tumblebug 빌드

# cd ~/go/src/github.com/cloud-barista/cb-tumblebug/src
# ./make

• 패키지 관련 오류 발생 시, go get 명령을 통해 부족한 패키지를 추가

CB-Tumblebug 실행

• # ./make run (또는 # go run mcism.go)

  • CB-Tumblebug API server가 실행됨

• 만약 “panic: /debug/requests is already registered. You may have two independent copies of golang.org/x/net/trace in your binary, trying to maintain separate state. This may involve a vendored copy of golang.org/x/net/trace.” 에러가 발생하면 다음을 실행 (CB-Tumblebug rebuild 가 필요할 수도 있음)

# rm -rf $GOPATH/src/go.etcd.io/etcd/vendor/golang.org/x/net/trace

CB-Tumblebug 테스트 방법

• CB-Tumblebug 테스트 스크립트를 통해 테스트

  • https://github.com/cloud-barista/cb-tumblebug/tree/master/test/official
    • 클라우드 인증 정보, 테스트 기본 정보 입력
    • 한꺼번에 통합 시험 (추천 테스트 방법)
    • 클라우드정보, Namespace, MCIR, MCIS 등 개별 제어 시험 (개별 시험시, 오브젝트들의 의존성 고려 필요))

• CB-Tumblebug 의 REST API를 사용하여 테스트

  • 멀티 클라우드 네임스페이스 관리 API를 통해서 Namespace 생성
    • https://documenter.getpostman.com/view/6451118/SzmfXGk9?version=latest
  • 멀티 클라우드 인프라 자원(MCIR) 관리 API를 통해서 VM 생성을 위한 자원 (MCIR) 생성
    • https://documenter.getpostman.com/view/6451118/SzmfXGkB?version=latest
  • 멀티 클라우드 인프라 서비스(MCIS) 관리 API를 통해서 MCIS 생성, 조회, 제어, 원격명령수행, 종료
    • https://documenter.getpostman.com/view/6451118/SzmfXGkD?version=latest