CLI Tool Install Guide

CB-Spider CLI 도구 spctl 설치 가이드

---

* 본 가이드는 CB-Spider CLI 도구 spctl의 설치 방법을 제공한다.
* 본 가이드는 Ubuntu 18.04.5 LTS 또는 Ubuntu 20.04.2 LTS 중심으로 시험 되었다.

[실행 절차]

1. CLI 배포
2. CLI 설치
3. CLI 시험

---

1. CLI 배포

• Terminal-1: CB-Spider 서버 설치 환경, CLI 도구 빌드 환경

  • CB-Spider 설치 및 실행 가이드 참고하여 CB-Spider 소스를 설치 및 빌드
    • 소스 기반 실행: https://github.com/cloud-barista/cb-spider/wiki/Quick-Start-Guide
  • spctl 배포를 위한 cli 빌드 및 묶음 실행

    cd $CBSPIDER_ROOT; make cli-dist;
    

  • 실행 결과 다음과 같이 dist 경로에 spctl 패키지 압축 파일(예시:spctl-2021.06.17.08.tar.gz) 생성

    cd $CBSPIDER_ROOT/dist;ls;
    

2. CLI 설치

2.1 CB-Spider Server와 같은 노드에서 CLI를 실행할 경우

• Terminal-2: CB-Spider CLI 도구 실행 환경

  • $CBSPIDER_ROOT 환경변수 설정

    cd $HOME/go/src/github.com/cloud-barista/cb-spider;source ./setup.env;
    

  • CB-Spider CLI 도구 위치로 이동

    cd $CBSPIDER_ROOT/interface;
    

  • spctl 설정 파일에 CB-Spider 서버 주소를 설정(설정파일:grpc_conf.yaml)

    cd $CBSPIDER_ROOT;
    vi grpc_conf.yaml
    

2.2 CB-Spider Server와 다른 노드에서 CLI를 실행할 경우

• Terminal-2: CB-Spider CLI 도구 설치 및 실행 환경

  • Terminal-1에서 생성한 spctl 패키지 묶음을 다운로드 후 압축 해제
  • 본 가이드에서는 $HOME/spider 경로에 복사 후 압축 해제

    cd $HOME/spider;
    tar -zxvf spctl-2021.06.15.11.tar.gz
    

  • spctl 패키지가 존재하는 위치를 환경 변수 $CBSPIDER_ROOT로 설정
    • $HOME/spider에 위치하는 경우 예시

    export CBSPIDER_ROOT=$HOME/spider
    

  • spctl 설정 파일에 CB-Spider 서버 주소를 설정(설정파일:grpc_conf.yaml)

    cd $CBSPIDER_ROOT;
    vi grpc_conf.yaml
    

3. CLI 시험

• Terminal-2: CB-Spider CLI 도구 실행 환경

  • spctl 설치 위치로 이동

  • help 출력(-h, --help 또는 무옵션 가능)

    ./spctl -h
    

  • 서브명령어 help 출력

    ./spctl vpc -h
    

  • 연동 가능한 CSP 목록 출력

    ./spctl os list
    

    output

    cloudos:
    - ALIBABA
    - AWS
    - AZURE
    - CLOUDIT
    - GCP
    - MOCK
    - OPENSTACK
    

  • 등록한 클라우드 연결 설정 목록 출력

    ./spctl connection list
    

    output

    connectionconfig:
    - ConfigName: alibaba-singapore-config
      ProviderName: ALIBABA
      DriverName: alibaba-driver01
      CredentialName: alibaba-credential01
      RegionName: alibaba-singapore
    - ConfigName: aws-ohio-config
      ProviderName: AWS
      DriverName: aws-driver01
      CredentialName: aws-credential01
      RegionName: aws-ohio