Quick Start Guide - cloud-barista/cb-dragonfly GitHub Wiki

[์„ค์น˜ ๊ฐœ์š”]

  • ์„ค์น˜ ํ™˜๊ฒฝ: ๋ฆฌ๋ˆ…์Šค(๊ฒ€์ฆ์‹œํ—˜: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 ์„ค์น˜

  • ๋ฉ€ํ‹ฐํด๋ผ์šฐ๋“œ ๋ชจ๋‹ˆํ„ฐ๋ง ํ”„๋ ˆ์ž„์›Œํฌ (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) ์‹คํ–‰

    • 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