데비안 9에서 Redmine을 설치하고 구성하는 방법

Redmine은 무료 오픈 소스 프로젝트 관리 및 문제 추적 응용 프로그램입니다. 크로스 플랫폼 및 데이터베이스 간이며 Ruby on Rails 프레임 워크 위에 구축되었습니다.

Redmine은 여러 프로젝트, 위키, 이슈 추적 시스템, 포럼, 캘린더, 이메일 알림 등을 지원합니다.

이 튜토리얼에서는 MySQL을 데이터베이스 백엔드로 사용하고 Passenger + Nginx를 Ruby 애플리케이션 서버로 사용하여 Debian 9 서버에서 최신 버전의 Redmine을 설치하고 구성하는 방법을 보여줍니다.

전제 조건

이 학습을 계속하기 전에 다음 전제 조건을 충족하는지 확인하십시오.

• 도메인 이름이 서버 퍼블릭 IP를 가리 키도록하십시오. example.com 을 사용합니다. sudo 권한이있는 사용자로 로그인합니다. Nginx가 설치되어 있습니다. 도메인에 SSL 인증서가 설치되어 있습니다.

MySQL 데이터베이스 생성

Redmine은 MySQL / MariaDB, Microsoft SQL Server, SQLite 3 및 PostgreSQL을 지원합니다. MariaDB를 데이터베이스 백엔드로 사용합니다. 머신에 MySQL 5.7 또는 MariaDB 10.3 이상이 설치되어 있는지 확인하십시오.

MariaDB 또는 MySQL이 데비안 서버에 설치되어 있지 않으면 다음 지침에 따라 설치할 수 있습니다.

다음을 입력하여 MySQL 콘솔에 로그인하여 시작하십시오.

sudo mysql

다음 SQL 문을 실행하여 새 데이터베이스를 작성하십시오.

CREATE DATABASE redmine CHARACTER SET utf8mb4;

새로운 MySQL 사용자 계정을 생성하고 데이터베이스에 대한 액세스 권한을 부여하십시오:

GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password'; 강력한 비밀번호 change-with-strong-password 를 변경하는 것을 잊지 마십시오.

완료되면 다음을 입력하여 MariaDB 콘솔에서 로그 아웃하십시오.

EXIT;

루비 설치

데비안에서 Ruby를 설치하는 가장 쉬운 방법은 apt package manager를 사용하는 것입니다.

다음을 입력하여 Ruby를 설치하십시오.

sudo apt install ruby-full

작성 당시 데비안 리포지토리의 버전은 2.3.3p222 이며 최신 버전의 Redmine에서 지원됩니다.

승객 및 Nginx 설치

Passenger는 Apache, Nginx와 통합 될 수있는 Ruby, Node.js 및 Python 용의 빠르고 가벼운 웹 애플리케이션 서버입니다. 승객을 Nginx 모듈로 설치합니다.

다음 단계를 계속하기 전에 Nginx가 설치되어 있는지 확인하십시오.

https 저장소를 사용하기 위해 필요한 패키지 설치:

sudo apt install dirmngr gnupg apt-transport-https ca-certificates software-properties-common

저장소 GPG 키를 가져오고 Phusionpassenger 저장소를 사용하십시오.

sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 561F9B9CAC40B2F7 sudo add-apt-repository 'deb https://oss-binaries.phusionpassenger.com/apt/passenger stretch main'

패키지 목록을 업데이트하고 다음과 같이 Passenger Nginx 모듈을 설치하십시오.

sudo apt update sudo apt install libnginx-mod-http-passenger

데비안에서 Redmine 설치

Redmine을 빌드하는 데 필요한 종속성을 설치하여 시작하십시오.

sudo apt install build-essential libmariadbclient-dev imagemagick libmagickwand-dev curl ruby-dev libxslt-dev libxml2-dev zlib1g-dev

이 기사를 작성할 당시 최신 안정 버전의 Redmine은 버전 4.0.4입니다.

다음 단계를 계속하기 전에 Redmine 다운로드 페이지에서 최신 버전을 확인해야합니다.

1. 레드 마인 다운로드

다음 curl 명령을 사용하여 Redmine 아카이브를 다운로드하십시오.

sudo curl -L http://www.redmine.org/releases/redmine-4.0.4.tar.gz -o /tmp/redmine.tar.gz

다운로드가 완료되면 아카이브를 추출하여 /opt 디렉토리로 이동하십시오.

cd /tmp sudo tar zxf /tmp/redmine.tar.gz sudo mv /tmp/redmine-4.0.4 /opt/redmine

2. Redmine 데이터베이스 구성

Redmine 예제 구성 파일을 복사하십시오.

sudo cp /opt/redmine/config/database.yml.example /opt/redmine/config/database.yml

텍스트 편집기로 파일을여십시오.

sudo nano /opt/redmine/config/database.yml

production 섹션을 검색하고 이전에 작성한 MySQL 데이터베이스 및 사용자 정보를 입력하십시오.

/opt/redmine/config/database.yml

production: adapter: mysql2 database: redmine host: localhost username: redmine password: "change-with-strong-password" encoding: utf8

완료되면 파일을 저장하고 편집기를 종료하십시오.

3. Ruby 의존성 설치

redmine 디렉토리로 이동하여 번 들러 및 기타 Ruby 종속성을 설치하십시오.

cd /opt/redmine/ sudo gem install bundler --no-rdoc --no-ri sudo bundle install --without development test postgresql sqlite

4. 키 생성 및 데이터베이스 마이그레이션

다음 명령을 실행하여 키를 생성하고 데이터베이스를 마이그레이션하십시오.

cd /opt/redmine/ sudo bundle exec rake generate_secret_token sudo RAILS_ENV=production bundle exec rake db:migrate

5. 올바른 권한 설정

Nginx는 www-data 사용자 및 그룹으로 실행됩니다. 다음 chown 명령을 실행하여 올바른 권한을 설정하십시오.

sudo chown -R www-data: /opt/redmine/

Nginx 구성

이 자습서의 전제 조건을 확인하지 않으면 지금 시스템에 SSL 인증서가있는 Nginx가 설치되어 있어야합니다.

텍스트 편집기를 열고 다음 Nginx 서버 블록 파일을 작성하십시오.

sudo nano /etc/nginx/sites-available/example.com /etc/nginx/sites-available/example.com

# Redirect HTTP -> HTTPS server { listen 80; server_name www.example.com example.com; include snippets/letsencrypt.conf; return 301 https://example.com$request_uri; } # Redirect WWW -> NON WWW server { listen 443 ssl http2; server_name www.example.com; ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem; include snippets/ssl.conf; return 301 https://example.com$request_uri; } server { listen 443 ssl http2; server_name example.com; root /opt/redmine/public; # SSL parameters ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem; include snippets/ssl.conf; include snippets/letsencrypt.conf; # log files access_log /var/log/nginx/example.com.access.log; error_log /var/log/nginx/example.com.error.log; passenger_enabled on; passenger_min_instances 1; client_max_body_size 10m; } example.com을 Redmine 도메인으로 바꾸고 SSL 인증서 파일의 올바른 경로를 설정하는 것을 잊지 마십시오. 모든 HTTP 요청이 HTTPS로 리디렉션됩니다. 이 구성에 사용 된 스 니펫은이 안내서에서 작성됩니다.

sites-enabled 디렉토리에 대한 심볼릭 링크를 만들어 서버 블록을 활성화하십시오.

sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/

Nginx 서비스를 다시 시작하기 전에 구문 오류가 없는지 테스트하십시오.

sudo nginx -t

오류가 없으면 출력은 다음과 같아야합니다.

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful

마지막으로 다음을 입력하여 Nginx 서비스를 다시 시작하십시오.

sudo systemctl restart nginx

Redmine에 액세스

브라우저를 열고 도메인을 입력하고 설치가 완료되면 다음과 유사한 화면이 나타납니다.

비밀번호를 변경하면 사용자 계정 페이지로 리디렉션됩니다.

결론

데비안 시스템에 Redmine을 성공적으로 설치했습니다. 이제 Redmine 설명서를 확인하고 Redmine을 구성하고 사용하는 방법에 대해 자세히 알아보십시오.

데비안 레드 마인 루비 mysql nginx