Quick Start Guide

[설치 개요]

• 설치 환경: 리눅스(검증시험:Ubuntu 18.04)

[설치 절차]

• Git 설치
• Go 설치
• Go 환경 변수 설정
• Docker/ Docker-compose 설치
• 멀티클라우드 모니터링 프레임워크 (cb-dragonfly) 설치
• 멀티클라우드 모니터링 프레임워크 (cb-dragonfly) 실행

[설치 & 실행 상세 정보]

• Git 설치

  $ sudo apt update
  $ sudo apt install git
  $ sudo apt-get install git-core
  

• Go 설치

  • https://golang.org/doc/install (2020년 11월 현재 $ sudo apt install golang 으로 설치하면 1.10 설치됨. 이 링크에서 1.16 이상 버전으로 설치할 것(Go mod 호환성 문제))

    $ wget https://golang.org/dl/go1.16.7.linux-amd64.tar.gz (설치 파일 다운로드)
    $ sudo tar -C /usr/local -xzf go1.16.7.linux-amd64.tar.gz (압축해제)
    

• Go 환경 변수 설정

  $ sudo echo "export PATH=$PATH:/usr/local/go/bin" >> ~/.bashrc (GOROOT{/usr/local/go/bin}를 PATH 환경 변수에 추가하여 ~/.bashrc 맨 아래줄에 추가)
  $ source ~/.bashrc (수정한 bashrc 파일 반영)
  $ go version (GO 버전 확인)
  

• Docker/ Docker-compose 설치

  • https://docs.docker.com/engine/install 참고
  • https://docs.docker.com/compose/install 참고

• 멀티클라우드 모니터링 프레임워크 (cb-dragonfly) 설치

  • Git Project Clone

     $ sudo git config --global color.ui "auto" (Git 소스에 색 구분)
     $ sudo git clone https://github.com/cloud-barista/cb-dragonfly.git (Git 프로젝트 CLone)
     username = {{GitUserEmail}} (Clone시 자격여부 확인 : 자신의 Git Email 입력)
     Password = {{GitUserPW}}    (Clone시 자격여부 확인 : 자신의 Git PW 입력)
    

  • Go mod 기반 의존성 라이브러리 로드

     $ cd ~/cb-dragonfly (clone한 프로젝트 파일로 들어가기)
     $ go mod download (.mod 파일에 등록된 라이브러리 다운로드 실행)
    

  • Go mod 기반 의존성 라이브러리 다운로드 확인

     $ go mod verify (다운로드 확인)
    

  • 환경변수 설정

    $ vim /etc/hosts (Docker-compose 실행 필요하며 아래 내용 추가)
    
          {{server IP}} cb-dragonfly-kafka cb-dragonfly-influxdb cb-dragonfly-kapacitor
    
    $ sudo vim setup.env (실행에 필요한 PATH를 처리할 파일 생성  (현 위치: ~/cb-dragonfly))
       setup.env에 추가
          
          export CBSTORE_ROOT=~/cb-dragonfly
          export CBLOG_ROOT=~/cb-dragonfly
          export CBMON_ROOT=~/cb-dragonfly
          
    $ source setup.env (수정한 setup.env 반영)   
    

• 멀티클라우드 모니터링 프레임워크(cb-dragonfly) config.yaml 설정 (릴리즈별 문서 참고)

  • CB-Dragonfly Server Configuration(~affogato)
  • CB-Dragonfly Server Configuration(cafelatte)
  • CB-Dragonfly Server Configuration(cortado)
  • CB-Dragonfly Server Configuration(chamomile)

• 멀티클라우드 모니터링 프레임워크 (cb-dragonfly) 실행

  • make 명령어 실행(docker-compose)

    $ cd ~/cb-dragonfly
    $ sudo make compose-up-dev
    

  • main.go 구동

    $ go run pkg/manager/main/main.go
    

  • 실행 결과

    <CB-Dragonfly> Multi-Cloud Monitoring Framework
    REST API: http://{{server}}:9090
    grpc: http://{{server}}:9999