[Container Manager] MariaDB와 레드마인 구축하는 방법, 쉽게 따라하기

이제 Docker 대신 Container Manager 🐋

시놀로지 패키지 센터에서는 도커(Docker)와 레드마인(Redmine) 패키지를 제공하는데요. 이 패키지 설치를 통해 쉽고 편하게 레드마인을 구축할 수 있습니다. 하지만, 앞으로 시놀로지 DSM 7.2 버전부터는 이 패키지를 제공하지 않습니다.

이전 버전인 DSM 6.2까지는 도커와 레드마인을 제공했지만, DSM 7.2에서는 컨테이너 매니저(Container Manager)만 제공합니다. 즉, 레드마인을 설치하려면 컨테이너 매니저를 통해 직접 설치와 DB를 연동하여 환경을 구축해야 한다는 것입니다.

직접 구축한다는 것에 부담이 있겠지만, 막상 시도해 보면 그다지 어렵지 않습니다. 본문에서는 레드마인 설치와 MariaDB 연동하는 방법을 상세히 설명하는데요. 한 단계씩 따라 하면 큰 어려움 없이 모두 설치하실 수 있을 것입니다.

참고로, 본문에서는 레드마인 4.2.9 버전을 설치하는데요. 최신 버전인 6.x 버전을 선택해도 상관은 없습니다.

MariaDB 설치 따라 하기

기존 도커의 레드마인은 MariaDB 10 패키지와 연동되어 데이터가 관리됐습니다. DSM 7.2의 패키지 센터에도 MariaDB 10 패키지가 있으나, 이상하게도 컨테이너 매니저의 레드마인에서 MariaDB 10 패키지와 연동이 제대로 안되더군요. 그래서 이를 사용하지 않고, 컨테이너 매니저에서 직접 MariaDB를 설치한 후 연동하는 방식으로 진행합니다.

컨테이너 매니저를 실행한 후 레지스트리 메뉴에서 MariaDB를 검색합니다. 그리고 검색 결과의 mariadb를 선택한 후 다운로드를 클릭하면 태그 선택 창이 표시됩니다. 특정 버전을 선택하거나 최신 버전(latest)을 선택하면 됩니다.

컨테이너 매니저의 레지스트리 메뉴 화면

mariadb의 버전 선택 화면

컨테이너 이름은 기본 값을 사용하거나 사용자 마음대로 변경해도 상관없습니다. 저는 mariadb라는 이름으로 진행했습니다.

컨테이너 이름 설정

포트 번호에는 3306으로 설정합니다. 볼륨 설정에서는 파일 스테이션의 공유 폴더와 mariadb의 특정 경로를 매핑합니다. 이렇게 매핑하면 공유 폴더에 mariadb의 정보가 동기화됩니다.

포트 및 볼륨 설정

항목	값
/docker/mariadb	/var/lib/mysql

환경 변수에는 아래의 항목을 추가합니다.

환경 변수 설정

항목	값
TZ	Asia/Seoul
MYSQL_ROOT_PASSWORD	초기 비밀번호 입력

다음 버튼을 클릭하여 설치를 진행합니다.

설치 화면

설치가 끝나면 아래와 같이 동작 상태가 표시됩니다.

MariaDB가 정상적으로 설치되어 실행되는 모습

Redmine DB 환경 설정 따라 하기

이제 레드마인이 MariaDB에 접근하여 읽고 쓰기가 가능하도록 계정을 만들고 권한을 설정해야 합니다. 이를 위해 HeidiSQL 프로그램을 활용할 겁니다.

프로그램을 받기 위해 홈페이지에 접속합니다.

https://www.heidisql.com/download.php

Download HeidiSQL

아래 화면에서 Installer를 클릭하여 설치 파일을 받습니다.

HeidiSQL 홈페이지 화면

설치 과정에는 따로 설정할 것이 없습니다. 설치가 완료되면 HeidiSQL 프로그램을 실행합니다. 그리고 시놀로지 서버의 IP 주소와 사용자 아이디, 비밀번호, 포트 번호를 입력한 후 열기 버튼을 클릭합니다.

HeidiSQL로 MariaDB 접속하기

항목	값
호스트명 / IP	시놀로지 서버 주소
사용자	root
암호	MariaDB 설치 시 환경 변수에 입력한 비밀번호
포트	MariaDB 설치 시 포트 번호에 입력한 번호

연결이 되면 아래와 같이 기본적인 DB 4가지가 보입니다. 이제 도구 > 사용자 관리자 메뉴를 클릭합니다.

사용자 관리자 메뉴 클릭

추가 버튼을 클릭하여 아래와 같이 입력합니다.

사용자 추가하기

항목	값
사용자 이름	사용자 이름 입력
호스트에서	%
암호	암호 입력
접근 허용	전체 권한 체크

참고로, 사용자 이름과 암호는 추후 레드마인 설치 과정 중 환경 변수로 사용됩니다. 여기까지가 MariaDB 환경 구성의 전부입니다.

Redmine 설치 따라 하기

컨테이너 매니저의 레지스트리 메뉴에서 redmine을 검색합니다. 그리고 설치하고 싶은 버전을 선택합니다. 저는 특정 플러그인의 호환성 때문에 4.2.9 버전을 채택했습니다. 참고로, 4.2.9 버전은 4.x의 가장 마지막 버전입니다.

레드마인 버전 선택 화면

레드마인 버전 목록

 컨테이너 이름은 자유롭게 설정합니다. 저는 sameersbn-redmine으로 지정했습니다.

컨테이너 이름 설정하기

포트 설정은 자유롭게 지정합니다. 저는 테스트로 7777을 입력했습니다. 그리고 아래 표와 같이 폴더 매핑을 지정합니다. 아래와 같이 폴더를 매핑하면, 파일 스테이션의 공유 폴더와 레드마인의 폴더가 매핑되어 동기화가 됩니다. 플러그인을 설치하기 위해 폴더를 가져다 옮기거나, CKEditor를 사용할 경우 첨부 파일을 백업할 때 매우 용이합니다.

폴더 매핑 설정

항목	값
/docker/redmine	/home/redmine/data
/docker/redmine/plugins	/home/redmine/redmine/plugins

주의

 

 

이미 레드마인을 운영하고 있는 상태에서 폴더 매핑을 지정하면 안 됩니다. 제가 알기로는, 매핑은 단방향 동기화라서 레드마인의 지정된 폴더 데이터가 공유 폴더를 따라갑니다. 즉, 공유 폴더에 새 폴더(비어있는 상태)를 생성한 후 레드마인과 매핑하면, 레드마인의 매핑된 경로가 모두 비어집니다. 어떻게 아냐고요? 기존 서버를 그렇게 했다가 모두 지워졌거든요...

환경 변수는 다음과 같이 설정합니다.

환경 변수 설정

항목	값
DB_ADAPTER	mysql2
DB_HOST	MariaDB 컨테이너 이름
DB_NAME	redmine
DB_USER	redmine DB 사용자 이름
DB_PASS	redmine DB 사용자 비밀번호
DB_PORT	MariaDB 포트 번호
TZ	Asia/Seoul

그리고 링크 설정에서 MariaDB 컨테이너를 선택합니다.

컨테이너 링크 설정

이제 컨테이너 상태를 보면 MariaDB와 레드마인이 정상적으로 동작하는 것을 확인할 수 있습니다. (정상 동작 중인 모습을 캡처하지 못했네요... 정상 동작하면 상태에 초록색이 표시됩니다.)

컨테이너 동작 상태

그리고 레드마인의 포트로 접속하면 레드마인 초기 화면이 나타납니다.

레드마인 초기 화면

관리자 아이디와 초기 비밀번호는 admin/admin입니다.

초기 비밀번호 변경

정리하며

처음에는 익숙하지 않아 어렵게 느껴지지만, 막상 몇 번 반복하다 보면 어렵지 않게 구축할 수 있습니다. 그리고 레드마인 버전이 높다고 무조건 다 좋은 것은 아닙니다. 레드마인과 함께 사용할 플러그인의 호환성이 매우 중요하며, 설치 중 문제가 생기면 지웠다 설치하기를 반복 시도하여 최적의 조건을 찾아야 합니다. 레드마인 자체의 큰 문제가 없다면 플러그인 호환성에 맞춰 버전을 선택하는 것을 권장합니다.