Cara Menginstal dan Mengkonfigurasi Redmine di Ubuntu 18.04

Redmine adalah salah satu perangkat lunak manajemen proyek dan pelacakan masalah sumber terbuka yang paling populer. Ini adalah lintas platform dan lintas basis data dan dibangun di atas kerangka kerja Ruby on Rails.

Redmine menyertakan dukungan untuk beberapa proyek, wiki, sistem pelacakan masalah, forum, kalender, pemberitahuan email, dan banyak lagi.

Tutorial ini menjelaskan cara menginstal dan mengkonfigurasi Redmine versi terbaru di server Ubuntu 18.04 menggunakan MySQL sebagai back-end database dan Passenger + Nginx sebagai server aplikasi Ruby.

Prasyarat #

Pastikan Anda telah memenuhi prasyarat berikut sebelum melanjutkan dengan tutorial ini:

• Anda memiliki nama domain yang menunjuk ke IP publik server Anda. Dalam tutorial ini kita akan menggunakan example.com .
• Anda masuk sebagai pengguna dengan hak istimewa sudo.
• Anda telah menginstal Nginx dengan mengikuti petunjuk berikut.
• Anda memiliki sertifikat SSL yang terpasang untuk domain Anda. Anda dapat memasang sertifikat SSL Let's Encrypt gratis dengan mengikuti petunjuk berikut.

Membuat database MySQL #

Redmine mendukung MySQL/MariaDB, Microsoft SQL Server, SQLite 3 dan PostgreSQL. Dalam tutorial ini kita akan menggunakan MySQL sebagai back-end database.

Jika Anda belum menginstal MySQL di server Ubuntu Anda, Anda dapat menginstal dengan mengikuti petunjuk ini.

Login ke shell MySQL dengan mengetikkan perintah berikut:

sudo mysql

Dari dalam shell MySQL, jalankan pernyataan SQL berikut untuk membuat database baru:

CREATE DATABASE redmine CHARACTER SET utf8mb4;

Selanjutnya, buat akun pengguna MySQL dan berikan akses ke database:

GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password';

Pastikan Anda mengubah change-with-strong-password dengan kata sandi yang kuat.

Setelah selesai, keluar dari konsol mysql dengan mengetik:

EXIT;

Menginstal Ruby #

Cara termudah untuk menginstal Ruby di sistem Ubuntu Anda adalah melalui apt manajer paket. Pada saat penulisan, versi di repositori Ubuntu adalah 2.5.1 yang merupakan versi stabil terbaru dari Ruby.

Instal Ruby dengan mengetik:

sudo apt install ruby-full

Jika Anda ingin menginstal Ruby melalui Rbenv atau RVM, periksa panduan ini.

Menginstal Penumpang dan Nginx #

Penumpang adalah server aplikasi web yang cepat dan ringan untuk Ruby, Node.js dan Python yang dapat diintegrasikan dengan Apache dan Nginx. Kami akan menginstal Passenger sebagai modul Nginx.

Pastikan Anda mengikuti prasyarat dan menginstal Nginx sebelum melanjutkan dengan langkah-langkah berikut.

Mulailah dengan menginstal paket-paket yang diperlukan:

sudo apt install dirmngr gnupg apt-transport-https ca-certificates

Impor kunci GPG repositori dan aktifkan repositori Phusionpassenger:

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

Setelah repositori apt diaktifkan, perbarui daftar paket dan instal modul Passenger Nginx dengan:

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

Menginstal Redmine di Ubuntu #

Kami akan mulai dengan menginstal dependensi yang diperlukan untuk membangun Redmine:

sudo apt install build-essential libmysqlclient-dev imagemagick libmagickwand-dev

Saat artikel ini ditulis, Redmine versi stabil terbaru adalah versi 4.0.0.

Sebelum melanjutkan ke langkah berikutnya, Anda harus memeriksa halaman unduh Redmine untuk melihat apakah versi yang lebih baru tersedia.

1. Mengunduh Redmine #

Unduh arsip Redmine dengan perintah curl berikut:

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

Setelah unduhan selesai, ekstrak arsip dan pindahkan ke /opt direktori:

cd /tmpsudo tar zxf /tmp/redmine.tar.gzsudo mv /tmp/redmine-4.0.0 /opt/redmine

2. Konfigurasi Database Redmine #

Mulailah dengan menyalin file konfigurasi contoh Redmine:

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

Buka file dengan editor teks Anda:

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

Telusuri production bagian dan masukkan database MySQL dan informasi pengguna yang kami buat sebelumnya:

/opt/redmine/config/database.yml

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

Setelah selesai, simpan file dan keluar dari editor.

3. Menginstal dependensi Ruby #

Arahkan ke direktori redmine dan instal bundler dan dependensi Ruby lainnya:

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

4. Buat Kunci dan Migrasikan Basis Data #

Jalankan perintah berikut untuk membuat kunci dan memigrasikan database:

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

5. Setel Izin yang benar #

Nginx berjalan sebagai www-data pengguna dan grup. Setel izin yang benar dengan mengeluarkan perintah chown berikut:

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

Konfigurasi Nginx #

Sekarang, Anda seharusnya sudah menginstal Nginx dengan sertifikat SSL di sistem Anda, jika belum periksa prasyarat untuk tutorial ini.

Buka editor teks Anda dan buat file blok server Nginx berikut:

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;
}

Jangan lupa untuk mengganti example.com dengan domain Redmine Anda dan atur jalur yang benar ke file sertifikat SSL. Semua permintaan HTTP akan dialihkan ke HTTPS. Cuplikan yang digunakan dalam konfigurasi ini dibuat dalam panduan ini.

Aktifkan blok server dengan membuat tautan simbolis ke sites-enabled direktori:

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

Sebelum memulai ulang layanan Nginx, lakukan tes untuk memastikan tidak ada kesalahan sintaks:

sudo nginx -t

Jika tidak ada kesalahan, outputnya akan terlihat seperti ini:

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

Terakhir, restart layanan Nginx dengan mengetik:

sudo systemctl restart nginx

Mengakses Redmine #

Buka browser Anda, ketik domain Anda dan dengan asumsi instalasi berhasil, layar yang mirip dengan berikut akan muncul:

Kredensial login default untuk Redmine adalah:

• Nama pengguna:admin
• Sandi:admin

Saat Anda login untuk pertama kalinya, Anda akan diminta untuk mengubah kata sandi seperti yang ditunjukkan di bawah ini:

Setelah Anda mengubah kata sandi, Anda akan diarahkan ke halaman akun pengguna.