如何在 Ubuntu 22.04 LTS 上安裝 Redmine

在本教程中,我們將向您展示如何在 Ubuntu 22.04 LTS 上安裝 Redmine。 您是否正在尋找一種項目管理工具來簡化團隊的任務並改善溝通? 看看 Redmine! Redmine 是一款免費的開源項目管理 Web 應用程序,可讓您跟踪問題、錯誤和任務,以及管理團隊的時間和資源。 憑藉其可定制的儀表板和易於使用的界面,Redmine 是任何希望優化其工作流程的團隊的完美解決方案。 在本指南中,我們將引導您完成在 Ubuntu 22.04 LTS 上安裝和配置 Redmine 的過程。 我們將涵蓋所有內容,從安裝必要的軟件包到設置數據庫,最後配置 Redmine 以滿足您團隊的特定需求。 所以坐下來,放鬆,讓我們開始使用 Redmine!

本文假定您至少具有 Linux 的基本知識,知道如何使用 shell,最重要的是,您將站點託管在自己的 VPS 上。 安裝非常簡單,假設您在 root 帳戶下運行,如果不是,您可能需要添加 ‘sudo‘ 到獲取 root 權限的命令。 我將向您展示在 Ubuntu 22.04 (Jammy Jellyfish) 上逐步安裝 Redmine 開源基於 Web 的項目管理。 您可以按照 Ubuntu 22.04 和任何其他基於 Debian 的發行版(如 Linux Mint、Elementary OS、Pop!_OS 等)的相同說明進行操作。

先決條件

  • 運行以下操作系統之一的服務器:Ubuntu 22.04、20.04 和任何其他基於 Debian 的發行版,如 Linux Mint。
  • 建議您使用全新的操作系統安裝,以防止出現任何潛在問題。
  • 通過 SSH 訪問服務器(如果您在桌面上,則只需打開終端)。
  • 有效的互聯網連接。 您需要互聯網連接才能下載 MySQL、Ruby 和 Rails、Redmine 所需的包和依賴項。
  • A non-root sudo user或訪問 root user. 我們建議充當 non-root sudo user,但是,如果您在充當根用戶時不小心,可能會損害您的系統。

在 Ubuntu 22.04 LTS Jammy Jellyfish 上安裝 Redmine

步驟 1. 首先,通過運行以下命令確保所有系統包都是最新的 apt 終端中的命令。

sudo apt update
sudo apt upgrade
sudo apt install libxml2-dev libxslt1-dev zlib1g-dev imagemagick libmagickwand-dev libmysqlclient-dev apache2-dev build-essential libcurl4-openssl-dev

步驟 2. 安裝 Apache HTTP 服務器。

默認情況下, Apache 在 Ubuntu 22.04 基礎存儲庫上可用。 現在運行下面的命令來安裝最新版本的 Apache 到你的 Ubuntu 系統:

sudo apt install apache2

安裝成功後,啟用 Apache (在系統啟動時自動啟動),使用以下命令啟動並驗證狀態:

sudo systemctl enable apache2
sudo systemctl start apache2
sudo systemctl status apache2

您可以使用以下命令確認 Apache2 版本:

apache2 -v

現在我們設置一個簡單的防火牆(UFW) Apache 允許在 HTTP 和 HTTPS 的默認 Web 端口上進行公共訪問:

sudo ufw allow 'Apache Full'
sudo ufw allow 3000
sudo ufw enable

有關安裝的其他資源 Apache,閱讀下面的帖子:

  • 如何安裝 Apache 在 Ubuntu Linux 上 √

步驟 3. 安裝 MySQL 數據庫。

默認情況下,MySQL 在 Ubuntu 22.04 基礎存儲庫上可用。 現在運行以下命令將最新版本的 MySQL 8 安裝到您的 Ubuntu 系統:

sudo apt install mysql-server

安裝成功後,啟用MySQL(系統開機自動啟動),啟動,使用以下命令驗證狀態:

sudo systemctl enable mysql
sudo systemctl start mysql
sudo systemctl status mysql

您可以通過執行以下命令來驗證安裝的 MySQL 版本:

mysql -V

默認情況下,MySQL 未加固。 您可以使用以下方法保護 MySQL mysql_secure_installation 腳本。 您應該仔細閱讀下面的每個步驟,這些步驟將設置根密碼、刪除匿名用戶、禁止遠程根登錄以及刪除測試數據庫和對安全 MySQL 的訪問:

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

使用 MySQL root 用戶和安裝時設置的密碼登錄 MySQL 數據庫服務器:

mysql -u root -p

登錄後,現在為 Redmine 安裝創建一個數據庫:

mysql> CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'Your-Strong-Passwd';
mysql> CREATE DATABASE redmine CHARACTER SET utf8mb4;
mysql> GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
mysql> exit

有關安裝 MySQL 的其他資源,請閱讀以下帖子:

  • 如何在 Ubuntu Linux 上安裝 MySQL √

第 4 步。安裝 Ruby。

Redmine 是用 Ruby on Rails 編寫的,所以我們需要在我們的系統上安裝 Ruby。 首先,我們使用以下命令安裝 RVM 的 GPG 密鑰:

gpg2 --keyserver keyserver.ubuntu.com --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB

接下來,使用以下命令安裝 RVM:

curl -sSL https://get.rvm.io | bash -s stable
source ~/.rvm/scripts/rvm

最後,使用以下命令安裝 Ruby:

rvm install ruby-3.1.3

步驟 5. 在 Ubuntu 22.04 上安裝 Redmine。

現在您已經安裝了所需的依賴項和 Ruby on Rails,您可以繼續安裝 Redmine。 首先,從官網下載最新版本的Redmine:

wget https://www.redmine.org/releases/redmine-5.0.5.tar.gz --no-check-certificate

接下來,提取文件並將其移動到 /var/www/redmine 目錄:

tar xfz redmine-5.0.5.tar.gz
mv redmine-5.0.5 /var/www/redmine
cd /var/www/redmine

之後,使用提供的創建 Redmine 配置文件 example 文件:

cp config/configuration.yml.example config/configuration.yml
cp config/database.yml.example config/database.yml
cp public/dispatch.fcgi.example public/dispatch.fcgi

然後,打開 database.yml 編輯文件:

nano config/database.yml

在以下部分下查找並配置您的數據庫設置:

production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: "Your-Strong-Passwd"
  # Use "utf8" instead of "utfmb4" for MySQL prior to 5.7.7
  encoding: utf8mb4

Save 和 close 該文件,然後安裝用於管理 ruby​​ gem 依賴項的捆綁程序:

gem install bundler
bundle config set --local without 'development test'
bundle install
gem pristine --all
bundle add webrick

生成隨機密鑰以防止篡改用於存儲會話數據的 cookie:

bundle exec rake generate_secret_token

接下來,創建數據庫結構:

RAILS_ENV=production bundle exec rake db:migrate

將數據插入MySQL數據庫:

RAILS_ENV=production REDMINE_LANG=en bundle exec rake redmine:load_default_data

創建必要的目錄並設置文件權限:

mkdir -p tmp/pdf
mkdir -p public/plugin_assets
chown -R $USER:$USER files log tmp public/plugin_assets
chmod -R 755 /var/www/redmine/

最後,運行以下命令啟動 Rails 服務器實例:

bundle exec rails server -u webrick -e production

步驟 8. 訪問 Redmine Web 界面。

成功安裝後,現在打開您的網絡瀏覽器並使用 URL 訪問 Redmine Web UI https://your-IP-address:3000. 您將被重定向到以下頁面:

恭喜! 您已成功安裝 Redmine。 感謝您使用本教程在 Ubuntu 22.04 LTS Jammy Jellyfish 系統上安裝 Redmine 項目管理 Web 應用程序。 如需更多幫助或有用信息,我們建議您查看 Redmine官方網站.