Ubuntu 18.04 Üzerine Redmine Kurulumu ve Konfigürasyonu

Redmine, en popüler açık kaynaklı proje yönetimi ve sorun izleme yazılım araçlarından biridir. Çapraz platform ve çapraz veritabanıdır ve Ruby on Rails çerçevesinin üzerine inşa edilmiştir.

Redmine, birden fazla proje, wikiler, sorun izleme sistemi, forumlar, takvimler, e-posta bildirimleri ve çok daha fazlası için destek içerir.

Bu eğiticide, MySQL'i veritabanı arka ucu ve Passenger + Nginx'i Ruby uygulama sunucusu olarak kullanarak bir Ubuntu 18.04 sunucusuna Redmine'ın en son sürümünün nasıl kurulacağı ve yapılandırılacağı açıklanmaktadır.

Ön şartlar

Bu eğiticiye devam etmeden önce aşağıdaki önkoşulları karşıladığınızdan emin olun:

• Sunucunuzun genel IP'sini işaret eden bir alan adınız var. Bu öğreticide example.com kullanacağız. Sudo ayrıcalıklarına sahip bir kullanıcı olarak oturum açtınız. Bu talimatları izleyerek Nginx yüklediniz. Alan adınız için bir SSL sertifikanız var. Bu talimatları izleyerek ücretsiz bir Let's Encrypt SSL sertifikası yükleyebilirsiniz.

MySQL veritabanı oluşturma

Redmine MySQL / MariaDB, Microsoft SQL Server, SQLite 3 ve PostgreSQL'i destekler. Bu derste MySQL'i veritabanı arka ucu olarak kullanacağız.

Aşağıdaki komutu yazarak MySQL kabuğuna giriş yapın:

sudo mysql

MySQL kabuğundan yeni bir veritabanı oluşturmak için aşağıdaki SQL deyimini çalıştırın:

CREATE DATABASE redmine CHARACTER SET utf8mb4;

Ardından, bir MySQL kullanıcı hesabı oluşturun ve veritabanına erişim verin:

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

Tamamlandığında, şunu yazarak mysql konsolundan çıkın:

EXIT;

Ruby Kurulumu

Ubuntu sisteminize Ruby'yi kurmanın en kolay yolu apt paket yöneticisidir. Yazma sırasında, Ubuntu depolarındaki sürüm, Ruby'nin en son kararlı sürümü olan 2.5.1'dir.

Ruby'yi yazarak yükleyin:

sudo apt install ruby-full

Yolcu ve Nginx Kurulumu

Passenger, Ruby, Node.js ve Python için Apache ve Nginx ile entegre edilebilen hızlı ve hafif bir web uygulama sunucusudur. Passenger'ı bir Nginx modülü olarak kuracağız.

Aşağıdaki adımlara devam etmeden önce önkoşulları izlediğinizden ve Nginx'i yüklediğinizden emin olun.

Gerekli paketleri kurarak başlayın:

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

Depo GPG anahtarını içe aktarın ve Phusionpassenger deposunu etkinleştirin:

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 bionic main'

Apt deposu etkinleştirildikten sonra, paketler listesini güncelleyin ve Passenger Nginx modülünü aşağıdakilerle kurun:

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

Ubuntu'ya Redmine Kurulumu

Redmine'ı oluşturmak için gerekli bağımlılıkları yükleyerek başlayacağız:

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

Bu makaleyi yazarken, Redmine'in en son kararlı sürümü 4.0.0 sürümüdür.

Bir sonraki adıma geçmeden önce, daha yeni bir sürümün mevcut olup olmadığını görmek için Redmine indirme sayfasını kontrol etmelisiniz.

1. Redmine indiriliyor

Redmine arşivini aşağıdaki curl komutuyla indirin:

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

İndirme işlemi tamamlandıktan sonra arşivi çıkarın ve /opt dizinine taşıyın:

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

2. Redmine Veritabanını Yapılandırma

Redmine örnek yapılandırma dosyasını kopyalayarak başlayın:

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

Dosyayı metin düzenleyicinizle açın:

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

production bölümünü arayın ve daha önce oluşturduğumuz MySQL veritabanını ve kullanıcı bilgilerini girin:

/opt/redmine/config/database.yml

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

Tamamlandığında, dosyayı kaydedin ve editörden çıkın.

3. Ruby bağımlılıklarını yükleme

Redmine dizinine gidin ve bundler ve diğer Ruby bağımlılıklarını yükleyin:

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

4. Anahtarlar Oluşturun ve Veritabanını Geçirin

Anahtar üretmek ve veritabanını taşımak için aşağıdaki komutu çalıştırın:

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

5. Doğru İzinleri ayarlayın

Nginx, www-data kullanıcısı ve grubu olarak çalışır. Aşağıdaki chown komutunu vererek doğru izinleri ayarlayın:

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

Nginx'i Yapılandır

Şimdiye kadar, bu eğitim için önkoşulları kontrol etmiyorsanız, sisteminizde zaten SSL sertifikalı Nginx yüklü olmalıdır.

Metin düzenleyicinizi açın ve aşağıdaki Nginx sunucu blok dosyasını oluşturun:

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'u Redmine alan adınızla değiştirmeyi ve SSL sertifika dosyalarına doğru yolu ayarlamayı unutmayın. Tüm HTTP istekleri HTTPS'ye yönlendirilecektir. Bu yapılandırmada kullanılan snippet'ler bu kılavuzda oluşturulur.

sites-enabled dizine sembolik bir bağlantı oluşturarak sunucu bloğunu sites-enabled :

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

Nginx hizmetini yeniden başlatmadan önce, sözdizimi hatalarının olmadığından emin olmak için bir test yapın:

sudo nginx -t

Hata yoksa çıktı şu şekilde görünmelidir:

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

Son olarak, aşağıdakileri yazarak Nginx hizmetini yeniden başlatın.

sudo systemctl restart nginx

Redmine'e Erişim

Tarayıcınızı açın, alan adınızı yazın ve yüklemenin başarılı olduğunu varsayarak aşağıdakine benzer bir ekran görünecektir:

Parolayı değiştirdikten sonra kullanıcı hesabı sayfasına yönlendirileceksiniz.

Sonuç

Ubuntu sisteminize Redmine'ı başarıyla yüklediniz. Şimdi Redmine Belgelerini kontrol etmeli ve Redmine'ı yapılandırma ve kullanma hakkında daha fazla bilgi edinmelisiniz.

ubuntu redmine yakut mysql nginx