Jira DC 플러그인 개발 Part.13 - MySQL로 데이터베이스 변경하기

JIRA DC 플러그인을 개발할땐 기본으로 H2 데이터베이스를 사용한다. H2 데이터베이스는 개발 시 굉장히 가볍고 좋은 데이터베이스이나 운영단계로 넘어가면 이 데이터베이스를 사용하기엔 무리가 있다. 여러가지 이유로 말이다. 그리고 꼭 운영단계가 아니라도 개발 환경에서부터 MySQL로 변경하고 싶을수가 있다. 

 

MySQL, PostgreSQL 둘 중 하나로 변경하면 되는데 여기서는 MySQL로 변경해서 사용하는 방법을 알아본다.

 

MySQL 설치

우선, 나의 경우 로컬에서 개발할때부터 데이터베이스를 MySQL로 변경하고자 한다. 그래서 로컬에 MySQL을 설치한다.

따라서, MacOS 환경 기준으로 설명한다.

 

다음 명령어를 터미널에서 실행한다.

(꼭 8.0 버전으로 설치해주자. 그 상위 버전은 지라에서 지원하지 않고 있다 아직까진. 현재 2024-08-20)

brew install mysql@8.0

 

정상적으로 설치가 되면 다음과 같은 화면이 보인다.

 

다른거 말고 중간에 이 문구가 있으면 된다.

To connect run:
	mysql -u root

 

기본 설정

세팅을 추가적으로 해줘야한다. 그러기 위해 다음 명령어를 입력한다.

mysql.server start

입력해서 이런 문구가 나오면 된다.

이제 다음 명령어를 통해 보안 관련 설정을 해준다.

mysql_secure_installation

 

비밀번호 유효성 검사 설정

첫번째로 비밀번호 유효성 설정이 나온다. 권장은 당연히 설정해서 강력한 비밀번호를 만드는게 맞다. 근데 그냥 로컬에서 간단하게 사용할 목적이라면 굳이 이 설정을 하지 않아도 상관은 없다. 난 과감하게 No를 하겠다.

No를 입력하면, 위 사진처럼 root 계정의 패스워드를 설정하라는 메시지가 나온다. 원하는대로 설정해주자.

 

익명의 사용자 삭제 설정  

다음은 익명의 사용자를 제거할지 묻는 화면이다. 제거해주자.

 

root 계정 원격 접속 차단 설정

다음은 root 계정의 원격 접속을 차단할지 묻는 화면이다. 위 사진처럼 일반적으로 원격 접속을 차단해야 보안상 안전하다.

이 PC가 아닌 다른 곳에서 이 PC의 MySQL로 root 계정으로 접속하는것은 차단하는게 권장된다. 다른곳에서 원격으로 접속이 필요하다면 다른 계정을 만들어서 원격 접속 권한을 제한적으로 주는것이 바람직하다. 나 역시 root 계정의 원격 접속을 제한하기로 한다.

 

테스트 데이터베이스 삭제 설정

기본으로 제공되는 테스트 데이터베이스를 삭제할건지 묻는다. 삭제한다.

 

위 작업으로 인한 변경사항 적용 설정

위 작업을 토대로 변경된 내용을 적용할지 묻는다. 적용하자.

 

여기까지 하면 끝이다. 다음과 같은 화면이 나오면 된다.

 

root 계정으로 MySQL 접속

위 설정을 다 하면 이제 root 계정으로 접속을 해보자. 패스워드는 위에서 설정한 패스워드로 입력하면 된다.

mysql -u root -p

이렇게 접속이 잘 되면 된다.

 

JIRA DC 플러그인 용 데이터베이스 생성

이제 데이터베이스를 생성하자.

CREATE DATABASE jira CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;

 

데이터베이스 명은 원하는대로 작성하면 된다. 위는 단지 예시일 뿐이다.

데이터베이스를 생성했으면, 유저를 생성하고 데이터베이스에 권한을 주자. 원격으로도 접속이 가능해야 하니까.

CREATE USER 'jirauser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON jira.* TO 'jirauser'@'localhost';
FLUSH PRIVILEGES;

이 또한, 유저명과 패스워드는 원하는대로 만들어주면 된다. 이렇게 권한까지 다 주고 나면 MySQL 설정은 끝이다.

 

MySQL JDBC 드라이버 설정

다음 링크에서 적절한 버전의 드라이버를 다운받는다. MySQL 8.0 버전을 사용하니까 드라이버도 8 버전으로 설치하면 된다.

MySQL :: Download Connector/J

다운 받은 jar 파일을 다음 경로에 추가해줘야 한다.

target/jira/home/webapp/WEB-INF/lib

참고로 이 경로는, JIRA DC 플러그인 프로젝트를 빌드하면 생기는 target 폴더이다. 그래서 최초 빌드 한번이 필요하다!

다음과 같이 잘 추가가 됐으면 끝이다.

 

JIRA 데이터베이스 연결 설정 변경

JIRA DC 플러그인 프로젝트를 빌드하면 target 폴더가 생긴다. 이 폴더 내부에 홈 디렉토리가 있다. 그리고 그 안에 dbconfig.xml 파일이 존재한다.

target/jira/home/dbconfig.xml

 

이 파일을 삭제한다! 이 파일 삭제하면, 설치 마법사가 다시 실행되면서 내가 원하는 데이터베이스를 연결할 수 있다. 

 

삭제한 후 다음 명령어를 실행!

atlas-run

다음과 같이 정상 실행이 된것을 확인하자.

보이는 것 그대로 링크 주소를 브라우저에 입력하면 다음 화면이 나온다!

설치 마법사가 실행된다! 여기서 `I'll set it up myself` 를 선택하고 Next.

이런 화면이 나온다. 여기서 `My Own Database`를 선택하자. 그러면 하단에 설정정보 입력 칸이 보여진다.

설정 정보를 입력하고 `Test Connection` 버튼을 클릭해서 연결이 잘 확인되어야 한다! 그리고 Next. 

한참 데이터베이스를 세팅한 후에 다음 화면이 보여진다.

그대로 Next.

이 화면이 나오면 `generate a Jira trial license` 버튼을 클릭해서 Trial license를 받으면 된다. 라이센스 받으면 다음과 같이 자동으로 입력된다. 

Trial license를 받는 방법은 이 포스팅의 범주를 넘어서기 때문에 따로 설명하지 않는다. 어렵지 않으니 그냥 들어가서 발급하면 된다.

그리고 Next를 클릭하면, 이제 Admin 유저 정보를 입력하는 화면이 나오고 그 화면에서 적절하게 Admin 정보를 기입 후 다음으로 넘어가면 된다! 그러면 다음과 같이 MySQL 데이터베이스와 연동된 Jira가 띄워진다!