Introduzione

Redmine è uno strumento di gestione dei progetti open-source potente e flessibile, che offre tracciamento dei problemi, tracciamento del tempo, funzionalità wiki e integrazione con il controllo di versione. È costruito su Ruby on Rails e supporta diversi database, tra cui MySQL e PostgreSQL. In questa guida illustreremo passo per passo il processo di installazione di Redmine su Ubuntu 22.04.

Prerequisiti

Prima di iniziare, assicuratevi che il vostro sistema soddisfi i seguenti requisiti:

  • Una nuova installazione di Ubuntu 22.04
  • Un utente non root con privilegi sudo
  • Una connessione a Internet funzionante
  • Un nome di dominio (opzionale ma consigliato)

Passo 1: Aggiornare i pacchetti di sistema

Per prima cosa, aggiornate l’elenco dei pacchetti e aggiornate quelli esistenti per garantire che il sistema sia aggiornato:

sudo apt update && sudo apt upgrade -y

Passo 2: installare le dipendenze necessarie

Redmine richiede diverse dipendenze, tra cui Ruby, Bundler e un server di database. Installeremo prima questi pacchetti.

sudo apt install -y curl gnupg2 git-core libmysqlclient-dev imagemagick libmagickwand-dev libpq-dev build-essential libssl-dev libreadline-dev zlib1g-dev

Passo 3: Installare Ruby

Ubuntu 22.04 non include l’ultima versione di Ruby per impostazione predefinita, quindi installeremo Ruby usando rbenv.

git clone https://github.com/rbenv/rbenv.git ~/.rbenv
cd ~/.rbenv && src/configure && make -C src
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
sorgente ~/.bashrc

git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
echo 'export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"' >> ~/.bashrc
sorgente ~/.bashrc

Ora installate Ruby:

rbenv install 3.2.0 # Usa l'ultima versione stabile
rbenv global 3.2.0
ruby -v # Verifica l'installazione

Passo 4: Installare il server di database

Redmine supporta MySQL e PostgreSQL. In questa guida utilizzeremo MySQL.

sudo apt install -y mysql-server

Proteggete l’installazione di MySQL:

sudo mysql_secure_installation

Creare un database e un utente Redmine:

sudo mysql -u root -p

All’interno della shell MySQL, eseguite i seguenti comandi:

CREATE DATABASE redmine CHARACTER SET utf8mb4;
CREARE UTENTE 'redmine'@'localhost' IDENTIFICATO DA 'strongpassword';
GRANTARE TUTTI I PRIVILEGI SU redmine.* A 'redmine'@'localhost';
ELIMINARE I PRIVILEGI;
ESCI;

Passo 5: Installare Redmine

Scaricare ed estrarre l’ultima versione stabile di Redmine:

cd /var/www/
wget https://www.redmine.org/releases/redmine-5.0.0.tar.gz
sudo tar -xvf redmine-5.0.0.tar.gz
sudo mv redmine-5.0.0 redmine
cd redmine

Configurare la connessione al database:

cp config/database.yml.example config/database.yml
nano config/database.yml

Modificare la sezione MySQL come segue:

production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: "strongpassword"
  encoding: utf8mb4

Passo 6: installare Bundler e le dipendenze

Eseguire i seguenti comandi per installare Bundler e le gemme necessarie:

gemma installa bundler
bundle install --without development test

Passo 7: Impostare il database

Eseguire i seguenti comandi per inizializzare il database:

bundle exec rake db:migrate RAILS_ENV=produzione
bundle exec rake redmine:load_default_data RAILS_ENV=production

Passo 8: Impostare i permessi dei file

Assicuratevi che Redmine abbia i permessi corretti:

sudo mkdir -p tmp tmp/pdf public/plugin_assets
sudo chown -R www-data:www-data file log tmp public/plugin_assets
sudo chmod -R 755 file log tmp public/plugin_assets

Passo 9: Avviare Redmine

È possibile avviare Redmine utilizzando il server WEBrick integrato:

bundle exec rails server -e production

In alternativa, configurare Redmine per l’esecuzione con Passenger e Apache o Nginx per l’uso in produzione.

Passo 10: Accesso a Redmine

Aprite il vostro browser web e navigate su:

http://your-server-ip:3000

Accedere con le credenziali predefinite:

  • Nome utente: admin
  • Password: admin

Conclusione

Redmine è stato installato con successo su Ubuntu 22.04. Per gli ambienti di produzione, è opportuno impostare un reverse proxy con Nginx o Apache, abilitare SSL e configurare backup automatici. Redmine è ora pronto per gestire efficacemente i vostri progetti!