はじめに

Redmineは、問題追跡、時間追跡、ウィキ機能、バージョン管理統合を提供する強力で柔軟なオープンソースのプロジェクト管理ツールです。Ruby on Railsで構築されており、MySQLやPostgreSQLを含む複数のデータベースバックエンドをサポートしています。このガイドでは、Ubuntu 22.04にRedmineをインストールする手順を説明します。

前提条件

始める前に、システムが以下の要件を満たしていることを確認してください：

  • 新規インストールのUbuntu 22.04
  • sudo権限を持つ非rootユーザー
  • 機能するインターネット接続
  • ドメイン名（オプションですが推奨）

ステップ1: システムパッケージの更新

まず、パッケージリストを更新し、既存のパッケージをアップグレードしてシステムを最新の状態にします：

sudo apt update && sudo apt upgrade -y

ステップ2: 必要な依存関係のインストール

Redmineには、Ruby、Bundler、およびデータベースサーバーなど、いくつかの依存関係が必要です。これらのパッケージを最初にインストールします。

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

ステップ3: Rubyのインストール

Ubuntu 22.04には最新のRubyバージョンがデフォルトで含まれていないため、rbenvを使用してRubyをインストールします。

git clone https://github.com/rbenv/rbenv.git ~/.rbenv
cd ~/.rbenv && src/configure && make -C src
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
source ~/.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
source ~/.bashrc

次に、Rubyをインストールします：

rbenv install 3.2.0  # Use the latest stable version
rbenv global 3.2.0
ruby -v  # Verify installation

ステップ4: データベースサーバーのインストール

RedmineはMySQLとPostgreSQLをサポートしています。このガイドではMySQLを使用します。

sudo apt install -y mysql-server

MySQLのインストールをセキュリティで保護します：

sudo mysql_secure_installation

Redmine用のデータベースとユーザーを作成します：

sudo mysql -u root -p

MySQLシェル内で、以下のコマンドを実行します：

CREATE DATABASE redmine CHARACTER SET utf8mb4;
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'strongpassword';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
FLUSH PRIVILEGES;
EXIT;

ステップ5: Redmineのインストール

最新の安定版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

データベース接続を構成します：

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

MySQLセクションを次のように変更します：

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

ステップ6: Bundlerと依存関係のインストール

以下のコマンドを実行してBundlerと必要なgemをインストールします：

gem install bundler
bundle install --without development test

ステップ7: データベースのセットアップ

以下のコマンドを実行してデータベースを初期化します：

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

ステップ8: ファイルの権限を設定

Redmineに正しい権限があることを確認します：

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

ステップ9: Redmineを起動

内蔵のWEBrickサーバーを使用してRedmineを起動できます：

bundle exec rails server -e production

または、PassengerとApacheまたはNginxを使用して本番環境で実行するようにRedmineを構成します。

ステップ10: Redmineにアクセス

ウェブブラウザを開いて、次のURLに移動します：

http://your-server-ip:3000

デフォルトの資格情報でログインします：

  • ユーザー名: admin
  • パスワード: admin

結論

Ubuntu 22.04にRedmineを正常にインストールしました。生産環境では、NginxまたはApacheでリバースプロキシを設定し、SSLを有効にし、自動バックアップを構成することを検討してください。Redmineは、あなたのプロジェクトを効果的に管理する準備が整いました！