Quick Start Guide

=========== Tested on: Ubuntu 22.04 LTS, Ubuntu 20.04.2 LTS, Ubuntu 18.04.5 LTS

• install Go dev-env.

  sudo apt update; sudo apt install -y make gcc; sudo apt install -y snapd; sudo snap install go --channel=1.23/stable --classic; go install github.com/swaggo/swag/cmd/swag@latest; sudo apt install -y git;
  

• install CB-Spider Source

  git clone https://github.com/cloud-barista/cb-spider.git $HOME/cb-spider;
  

  git clone https://github.com/cloud-barista/cb-spider.git $HOME/cb-spider --branch v0.9.1;
  

• build CB-Spider Source

  cd $HOME/cb-spider; make; 
  

• check configurations in setup.env (Optional)

  vi $HOME/cb-spider/setup.env
  

• setup CB-Spider Run environment

  source ./setup.env; source ./develop.env;
  

• start CB-Spider Server

  cd $CBSPIDER_ROOT/bin; ./start.sh;
  

  output:

  <CB-Spider> Multi-Cloud Infrastructure Federation Framework
     - AdminWeb: http://{server}:1024/spider/adminweb
     - REST API: http://{server}:1024/spider
  

  ※ 참고: Failed to Connect to Database 오류 발생시

• check the health of CB-Spider Server

  [Terminal]

  cd $CBSPIDER_ROOT/bin; ./status.sh;
  

  curl -sX GET http://localhost:1024/spider/readyz
  

  [Browser]

  • REST API Endpoint

  http://{server}:1024/spider
  

  • AdminWeb 접속

  http://{server}:1024/spider/adminweb
  

  ※ 참고: 공유기/사설망 환경에서 AdminWeb 설정 방법

• stop CB-Spider Server

  cd $CBSPIDER_ROOT/bin; ./stop.sh;
  

• start CB-Spider Server again

  cd $CBSPIDER_ROOT/bin; ./start.sh;
  

• Server Configurations

  • Configurations (Korean)

• Initialize Meta Info

  cd $CBSPIDER_ROOT/bin; ./stop.sh; rm -rf $CBSPIDER_ROOT/meta_db/*;