Redmine CKEditor 설치

CKeditor 플러그인 (https://ckeditor.com/)

입력한 데이타를 Textile 로 변경해 주는게 아니라 HTML 을 바로 사용하는 플러그인으로

레드마인에 글 작성 시 여러가지 기능으로 좀 더 직관적으로 보이게 해준다

단점이나 추가 플러그인은 검색을 통해서 찾아보면 금방 찾을 수 있다

여기에서는 내가 필요해서 설치했던 공유기만 남겨본다

 

플러그인 설치 준비

우선 설치를 위해서 도커 이미지에 접속을 해야한다

 

ssh로 시놀로지 서버에 접속

ssh 루트 혹인 아이디@서버

 

루트권한을 얻는다

sudo -i

 

도커 명령어로 실행중인 이미지를 검색해 이름을 찾는다

(도커의 샐행중인 이미지 목록을 보여준다)

docker ps

 

도커 이미지에 접속

docker exec -it synology_redmine /bin/bash

플러그인 폴더로 이동한다

cd plugins

 

 

플러그인 설치

다른 블로그에는 바로 깃에서 다운받는 주소가 있는데

최신버젼을 가져오는 거라 레드마인 버젼과 안맞을 수 있다

(주로 설명으로 나와 있는 주소 : git clone http://github.com/a-ono/redmine_ckeditor )

 

 

깃 주소로 가보면 레드마인 버젼에 따른 설치 버젼을 안내하고 있다

우리가 설치한 레드마인은 3.3.6버젼이라

Ckeditor 1.1.7버젼을 받아야 한다

플러그인 폴더에서 아래 명령어를 입력해 다운 받는다

wget https://codeload.github.com/a-ono/redmine_ckeditor/zip/1.1.7

 

 

다운받은 파일의 압축을 푼다

unzip 1.1.7

 

아래 명령을 이용해 다운로드한 파일과 압축을 푼 폴더를 볼 수 있다

ls -al

 

다운 받은 압축파일을 삭제하고 폴더이름을 redmine_ckeditor로 변경해준다

rm -f 1.1.7

mv -f redmine_ckeditor-1.1.7/ redmine_ckeditor/

 

플러그인 폴더에서 상위 폴더로 이동 한다

cd ..

 

먼저 빌드 명령어 실행

bundle install

 

s3_reginon이 문제가 있다고 나오긴 하지만 괜찮다 넘어가도 된다

다른 설치 명령어를 실행!

bundle install --without development test

 

레드마인 명령어

rake redmine:plugins:migrate RAILS_ENV=production

 

GemNotFoundException 에러 발생

rm Gemfile.lock

gem update 

gem update --system

gem install rake

 

위 명령어를 차래로 실행 후 다시 레드마인 명령어를 입력

rake redmine:plugins:migrate RAILS_ENV=production

bundle install를 다시 하라고 한다.

 

막상 bundle install 명어를 실행하면

이번엔 번들러의 버젼이 다르다고 오류가 난다   

번들러를 삭제하고

gem uninstall bundler -v ">= 2.0"

 

버전에 맞는 번들러를 다시 설치해준다

gem install bundler -v "< 2.0"

 

다시!

bundle install

이번엔 rmagick를 설치 할 수 없다는 에러!! 

아래 명령어를 차래로 실행해 설치해준다

(설치시 Y/n 와 같이 질문하는것들은 대소문자를 구별할 수 있으니 확인하며 설치해야 한다)

apt-get update

sudo apt-get install libmagickwand-dev

gem install rmagick -v '4.0.0'

 

 

설치 후 다시 

bundle install

드디어!! 에러 없이 이런화면을 만난다면 거의 성공이다

 

 

다시한번 

bundle install --without development test

명령어를 실행해주고 에러가 없으면

rake redmine:plugins:migrate RAILS_ENV=production

실행하면 설치가 끝난다

 

 

험난했던 설치였지만 처음에 설치했을때 만났던 다른 오류를 몇가지 더 공유해야겠다

(설치시 에러가 발생하여 해결를 한 후에 블로그 작성을 하다보니.. 에러가 다시 안나와서 에러화면을 못보여 드려 죄송합니다.

보통은 apt-get 명령으로 설치하면 해결이 되었으니 설치가 안되는 "패키지명 + apt-get" 으로 구글에 검색해보시면 대부분 해결이 될꺼 같습니다)

 

pg를 설치할 수 없다는 에러!!

apt-get install libpq-dev

gem install pg -v '0.18.4'

 

mysql2를 설치할 수 없다고 에러가 발생하면!!

apt-get install build-essential

apt-get install libmysqlclient-dev

gem install mysql2 -v '0.4.10'

 

이제 도커를 빠져나와 도커를 재시작 해주자

명령어로 도커 이미지를 벗어나와

exit

 

 

시놀로지 레드마인 도커이미지를 재시작

docker restart synology_redmine

 

웹화면의 시놀로지에서 레드마인을 클릭하면 홈페이지로 이동된다

 

우측 상단의 로그인으로 로그인을 한다

( 초기 비밀번호는 admin / admin )

 

 

로그인 후 좌측 상단에 관리를 누르고 메뉴에서 플러그인을 누르면 설치된 플러그인을 볼 수 있다

플러그인의 설정을 눌러서 잘 들어가 진다면 설치 완료!

 

CKEditor를 설정하는 방법은

관리 -> 설정을 클릭한 후 -> 본문형식을 ckeditor로 변경해준 후 저장을 클릭한다

이상으로 험난했던 레드마인 CKEditor 설치를 마쳐야겠다

혹시 궁금한 사항이 있으면 댓글을 부탁드립니다!