Ubuntu 20.04에 Redmine 프로젝트 관리 소프트웨어를 설치하는 방법

이 튜토리얼은 다음 OS 버전에 대해 존재합니다.

Ubuntu 22.04(Jammy Jellyfish)
Ubuntu 20.04(Focal Fossa)

이 페이지에서

전제 조건
시작하기\n
Apache, MariaDB 및 Passenger 설치
MariaDB 데이터베이스 구성
Redmine 설치
승객 구성
Redmine용 Apache 구성
Redmine 웹 UI 액세스
결론

Redmine은 Ruby로 작성된 무료 오픈 소스 프로젝트 관리 애플리케이션입니다. 웹 브라우저에서 프로젝트를 관리할 수 있는 웹 기반 인터페이스를 제공합니다. 무료 및 유료 도구를 제공하고 Wiki, 포럼, 캘린더 등을 지원하는 교차 플랫폼 및 교차 데이터베이스 애플리케이션입니다.

특징

Gantt 차트 및 캘린더
여러 프로젝트 지원\n
역할 기반 액세스 제어\n
이메일 알림
문제 추적 시스템
SCM 통합\n
여러 언어 및 데이터베이스 지원

이 게시물에서는 Ubuntu 20.04 서버에 Redmine을 설치하는 방법을 보여줍니다.

전제 조건

Ubuntu 20.04를 실행하는 서버.\n
서버 IP를 가리키는 유효한 도메인 이름입니다.\n
루트 암호는 서버에서 구성됩니다.\n

시작하기

먼저 APT 패키지 캐시를 시스템에 업데이트해야 합니다. 다음 명령으로 업데이트할 수 있습니다.

apt-get update -y

APT 캐시가 업데이트되면 다음 명령을 사용하여 다른 필수 도구를 설치합니다.

apt-get install build-essential libmysqlclient-dev libmysqlclient-dev imagemagick libmagickwand-dev libmagickcore-dev apt-transport-https ca-certificates dirmngr gnupg2 -y

모든 패키지가 설치되면 다음 단계로 진행할 수 있습니다.

Apache, MariaDB 및 Passenger 설치

다음으로 시스템에 Apache 웹 서버, MariaDB 데이터베이스 및 Passenger를 설치해야 합니다. 다음 명령으로 모두 설치할 수 있습니다.

apt-get install apache2 apache2-dev libapache2-mod-passenger mariadb-server mariadb-client -y

모든 패키지가 설치되면 Apache 및 MariaDB 서비스를 시작합니다.

systemctl start apache2
systemctl start mariadb

완료되면 다음 단계로 진행할 수 있습니다.

MariaDB 데이터베이스 구성

먼저 MariaDB 루트 암호를 설정하고 설치를 보호해야 합니다. 다음 명령으로 수행할 수 있습니다.

mysql_secure_installation

아래와 같이 모든 질문에 답하십시오.

Set root password? [Y/n] y
Remove anonymous users? [Y/n] y
Disallow root login remotely? [Y/n] y
Remove test database and access to it? [Y/n] y
Reload privilege tables now? [Y/n] y

그런 다음 다음 명령을 사용하여 MariaDB에 로그인합니다.

mysql -u root -p

로그인한 후 다음 명령을 사용하여 데이터베이스와 사용자를 생성합니다.

MariaDB [(none)]> CREATE DATABASE redmine CHARACTER SET utf8mb4;
MariaDB [(none)]> GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'password';

다음으로 다음 명령을 사용하여 권한을 플러시하고 MariaDB를 종료합니다.

MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> EXIT;

완료되면 다음 단계로 진행할 수 있습니다.

레드마인 설치

기본적으로 Redmine 패키지는 Ubuntu 기본 리포지토리에서 사용할 수 있습니다. 다음 명령으로 설치할 수 있습니다.

apt-get install redmine redmine-mysql -y

설치하는 동안 아래와 같이 Redmine용 데이터베이스를 구성하라는 메시지가 표시됩니다.

예를 선택하고 Enter 키를 눌러 계속하십시오. 아래와 같이 MySQL 애플리케이션 비밀번호를 설정하라는 메시지가 표시됩니다.

비밀번호를 설정하고 확인 버튼을 클릭하면 설치가 완료됩니다.

다음으로 다음 명령을 사용하여 gem 패키지를 업데이트합니다.

gem update

gem이 업데이트되면 다음 명령을 사용하여 번들러 패키지를 설치합니다.

gem install bundler

완료되면 다음 단계로 진행할 수 있습니다.

승객 구성

다음으로 www-data 사용자로 실행되도록 Passenger를 구성해야 합니다. Passenger.conf 파일을 편집하면 됩니다.

nano /etc/apache2/mods-available/passenger.conf

아래와 같이 파일을 변경합니다.

<IfModule mod_passenger.c>
  PassengerDefaultUser www-data
  PassengerRoot /usr/lib/ruby/vendor_ruby/phusion_passenger/locations.ini
  PassengerDefaultRuby /usr/bin/ruby
</IfModule>

완료되면 파일을 저장하고 닫습니다.

다음으로 Apache 웹 루트 디렉토리에 redmine의 심볼릭 링크를 만듭니다.

ln -s /usr/share/redmine/public /var/www/html/redmine

그런 다음 다음 명령을 사용하여 redmine 디렉토리에 적절한 소유권을 설정하십시오.

chown -R www-data:www-data /var/www/html/redmine

완료되면 다음 단계로 진행할 수 있습니다.

Redmine용 Apache 구성

다음으로 Redmine용 Apache 가상 호스트 구성 파일을 생성해야 합니다. 다음 명령으로 만들 수 있습니다.

nano /etc/apache2/sites-available/redmine.conf

다음 줄을 추가합니다.

<VirtualHost *:80>
  ServerAdmin 
  DocumentRoot /var/www/html/redmine
  ServerName redmine.example.com
  <Directory /var/www/html/redmine>
    RailsBaseURI /redmine
    PassengerResolveSymlinksInDocumentRoot on
  </Directory>

  ErrorLog ${APACHE_LOG_DIR}/error.log
  CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

완료되면 파일을 저장하고 닫습니다.

다음으로 다음 명령을 사용하여 Apache 재작성 모듈 및 Redmine 가상 호스트 파일을 활성화합니다.

a2enmod rewrite*
a2ensite redmine.conf

그런 다음 Apache 서비스를 다시 시작하여 변경 사항을 적용합니다.

systemctl restart apache2

이제 다음 명령을 사용하여 Apache 서비스의 상태를 확인할 수 있습니다.

systemctl status apache2

다음 출력이 표시되어야 합니다.

? apache2.service - The Apache HTTP Server
     Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
     Active: active (running) since Wed 2021-06-09 04:01:29 UTC; 9min ago
       Docs: https://httpd.apache.org/docs/2.4/
    Process: 27698 ExecReload=/usr/sbin/apachectl graceful (code=exited, status=0/SUCCESS)
      Tasks: 77 (limit: 4691)
     Memory: 12.5M
     CGroup: /system.slice/apache2.service
             ??21346 /usr/sbin/apache2 -k start
             ??27703 Passenger watchdog
             ??27706 Passenger core
             ??27711 Passenger ust-router
             ??27729 /usr/sbin/apache2 -k start
             ??27730 /usr/sbin/apache2 -k start

Redmine 웹 UI에 액세스

이제 웹 브라우저를 열고 URL http://redmine.example.com을 사용하여 Redmine 웹 인터페이스에 액세스하십시오. 다음 페이지가 표시됩니다.

로그인 버튼을 클릭합니다. Redmine 로그인 페이지가 표시됩니다.

기본 사용자 이름을 admin으로, 비밀번호를 admin으로 입력한 다음 로그인 버튼을 클릭합니다. 암호 재설정 화면이 나타납니다.

새 비밀번호를 입력하고 적용 버튼을 클릭하여 변경 사항을 적용합니다. 다음 페이지가 표시됩니다.

결론

축하합니다! Ubuntu 20.04에서 Apache와 함께 Redmine을 성공적으로 설치했습니다. 자세한 내용은 Redmine 문서의 Redmine 설명서를 참조하십시오.