Skip to content

Latest commit

 

History

History
266 lines (193 loc) · 6.05 KB

README.md

File metadata and controls

266 lines (193 loc) · 6.05 KB
Raw

M-CMP mc-across-service-manager

FOSSA Status

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

FOSSA Status