M-CMP mc-across-service-manager

This repository provides a Multi-Cloud mc-across-service-manager.

A sub-system of M-CMP platform to deploy and manage Multi-Cloud Infrastructures.

Overview

M-CMP의 mc-across-service-manager 서브시스템이 제공하는 기능은 다음과 같다.

• 클라우드간 연계 서비스 운용 및 관리 기능
• 클라우드간 마이그레이션 기능
• 멀티 클라우드 인프라 동적 성능 진단 관리 기능
• 클라우드간 백업 자동화 및 복구 기능

목차

1. [mc-across-service-manager 실행 및 개발 환경]
2. [mc-across-service-manager 실행 방법]
3. [mc-across-service-manager 소스 빌드 및 실행 방법 상세]
4. [mc-across-service-manager 기여 방법]

---

---

mc-across-service-manager 실행 및 개발 환경

• Linux OS (Ubuntu 22.04 LTS)
• Java (Openjdk 17)
• Gradle (v7.4.2)
• MariaDB (v10.11.5)
• InfluxDB (v2.7.3)
• Python (v3.10.12)
• Node.js (v16.20.2)
• npm (v8.19.4)
• docker (v24.0.7)
• git(v2.34.1)
• terraform (v1.5.7)
• ansible (v2.15.5)
• airflow (v2.7.2)

---

---

mc-across-service-manager 실행 방법

소스 코드 기반 설치 및 실행

• 방화벽 설정
• 소스 다운로드 (Git clone)
• 필요 패키지/도구 설치 및 환경 변수 설정
• CSP Credential, SSH Key 설정
• 빌드 및 실행 (shell script)

---

---

mc-across-service-manager 소스 빌드 및 실행 방법 상세

(1) 방화벽 TCP 포트 허용 설정

• 80, 443
• 3306 (MariaDB)
• 8086 (InfluxDB)
• 8080 (Airflow)
• 8090, 8091, 8092, 8095 (서브시스템)
• 4173, 5173 (UX/UI)

(2) 소스 다운로드

• Git 설치

  	sudo apt update
  	sudo apt install -y git

• mc-across-service-manager 소스 다운로드

  	export BASE_DIR=$HOME/mcmp
  	mkdir -p $BASE_DIR/git
  	cd $BASE_DIR/git
  	git clone https://github.com/m-cmp/mc-across-service-manager.git
  	export PROJECT_ROOT=$(pwd)/mc-across-service-manager

(3) 필요 패키지/도구 설치 및 환경 변수 설정

• Java, Gradle, Node.js, npm, Git, Docker 설치

  	cd $PROJECT_ROOT/scripts
  	sudo chmod +x *.sh
  	. $PROJECT_ROOT/scripts/init-install.sh
  	mkdir -p $BASE_DIR/build
  

• 환경 변수 설정

  	cd $PROJECT_ROOT/scripts
  	. $PROJECT_ROOT/scripts/set-env.sh
  	source $HOME/.bashrc

• InfluxDB, MariaDB 설치

  	# Install DBs
  	. $PROJECT_ROOT/scripts/install-dbs.sh
  	y , Enter 입력
  
  	# Set Secure
  	sudo mysql_secure_installation
  	사용할 root password 입력
  	y
  	n
  	n
  	n
  	n
  	y
  
  	# Set Auth
  	sudo mysql -u root -p
  	root password 입력
  
  	# In MariaDB
  	create user 'mcmp'@'%' identified by 'mcmp';
  	grant all privileges on *.* to 'mcmp'@'%' with grant option;
  	flush privileges;
  	exit
  
  	# Set MariaDB configuration
  	cd $PROJECT_ROOT/scripts
  	sudo ./set-mariadb.sh

• Terraform, Ansible, Airflow 설치

    #Install Terraform, Ansible, Airflow
    . $PROJECT_ROOT/scripts/install-opensources.sh
    Enter 입력
  
    #Set Resource File Link
    . $PROJECT_ROOT/scripts/set-link.sh

(4) CSP Credential, SSH Key 설정

• CSP Credential 설정

  • GCP는 credential.sh에 정의된 GOOGLE_CLOUD_KEYFILE_JSON 환경 변수에 JSON Key File Path를 값으로 설정하고, 해당 Path에 GCP JSON Key File이 존재해야 한다.

  	vi $PROJECT_ROOT/scripts/credential.sh
  
  	"사용자 입력" 대신 credential 정보 입력
  	. $PROJECT_ROOT/scripts/credential.sh
  
  	# 설정 적용
  	source $HOME/.bashrc

• CSP SSH Public Key 설정

  • AWS

    	# 수정할 vm.tf 파일
    	vi $BASE_DIR/terraform/source/aws/vm.tf
    
    	# aws_key_pair의 key_name에 aws ssh public key 이름으로 수정 후 vm.tf 파일 저장
    	data "aws_key_pair" "mcmp_key" {
    	  key_name   = "" #aws 서버에 등록된 ssh키 이름
    	  include_public_key = true
    	}

  • GCP :

    	# 수정할 vm.tf 파일
    	vi $BASE_DIR/terraform/source/gcp/vm.tf
    
    	# metadata의 ssh-keys에 gcp ssh public key로 수정 후 vm.tf 파일 저장
    	resource "google_compute_instance" "gcp_instance" {
    	  ...
    
    	  metadata = {
    		# ex: ssh-keys = "ubuntu:ssh-rsa AA~" or ssh-keys = "username:${file("username.pub")}"
    		ssh-keys = ""
    	  }
    
    	  ...
    	}

    	# 수정할 vpc.tf 파일
    	vi $BASE_DIR/terraform/source/gcp/vpc.tf
    
    	# provider google의 project에 GCP Project ID 입력 후 vpc.tf 파일 저장
    	  provider "google" {
    	    project     = ""
    	    region      = "asia-northeast3"
    	  }

  • AZURE

    	# 수정할 vm.tf 파일
    	vi $BASE_DIR/terraform/source/azure/vm.tf
    
    	# admin_ssh_key 내용을 azure ssh key 로 수정 후 vm.tf 파일 저장
    	resource "azurerm_linux_virtual_machine" "azure" {
    	  ...
    
    	  admin_ssh_key {
    		username   = "ubuntu"
    		# public_key = "ssh-rsa A ~" or public_key = file("/home/.../username.pub")
    		public_key = ""
    	  }
    
    	  ...
    	}

(5) 빌드 및 실행

• Shell Script 실행

  	#Build & Run React Project
  	. $PROJECT_ROOT/scripts/build-web.sh
  
  	#Build Springboot Project
  	. $PROJECT_ROOT/scripts/build-springboot-all.sh
  
  	#Run Springboot Project
  	. $PROJECT_ROOT/scripts/deploy-springboot-all.sh
  
  	#Run Airflow
  	. $PROJECT_ROOT/scripts/run-airflow.sh

• UI로 접속

  • http://Public_IP주소:4173
  • 템플릿 목록 : http://Public_IP주소:4173/template

---

---

mc-across-service-manager 기여 방법

Issues/Discussions/Ideas: Utilize issue of mc-across-service-manager

License