在Puma上运行Redmine是一种高效且现代的配置方式，因为Puma是一个多线程、高性能的Web服务器，特别适合Ruby应用，如Redmine。Redmine是一款开源的项目管理工具，广泛用于跟踪任务、管理问题和文档。在这个教程中，我们将深入探讨如何在Ubuntu操作系统上，搭配MySQL数据库来部署和运行Redmine，使用Puma作为Web服务器。
1. **环境准备**：
确保你的Ubuntu系统是最新的，通过运行`sudo apt update && sudo apt upgrade`命令进行更新。安装必要的开发工具和库，如`build-essential`，`libmysqlclient-dev`，以及`ruby-full`，`ruby-bundler`。
2. **安装RVM（Ruby Version Manager）**：
RVM是一个方便管理不同版本Ruby的工具，通过`curl -sSL https://get.rvm.io | bash -s stable`安装。安装完成后，重启终端并用`rvm install 2.x.x`（替换x为所需的Ruby版本）安装Ruby。
3. **安装Rails和Puma**：
使用RVM安装Ruby后，使用`gem install rails`安装Rails，接着安装Puma，执行`gem install puma`。同时，还需要安装`bundler`来管理Gemfile中的依赖，`gem install bundler`。
4. **安装Redmine**：
从Redmine的GitHub仓库克隆最新版本到本地，例如`git clone https://github.com/redmine/redmine.git`。进入项目目录，运行`bundle install --without development test`来安装Redmine的依赖。
5. **配置数据库**：
创建一个用于Redmine的MySQL数据库，使用`mysql -u root -p`登录MySQL，然后执行`CREATE DATABASE redmine CHARACTER SET utf8 COLLATE utf8_general_ci;`创建数据库。创建数据库用户并分配权限，如`GRANT ALL PRIVILEGES ON redmine.* TO 'redmineuser'@'localhost' IDENTIFIED BY 'yourpassword'; FLUSH PRIVILEGES;`。
6. **配置Redmine**：
编辑`config/database.yml`，根据之前创建的数据库设置进行修改。同时，编辑`config/environments/production.rb`，调整Rails的生产环境配置，如设置`config.serve_static_assets = false`，`config.assets.compile = false`等。
7. **初始化数据库**：
运行`bundle exec rake db:create db:migrate RAILS_ENV=production`来创建和迁移数据库。
8. **生成Redmine的session加密密钥**：
执行`bundle exec rake redmine:generate_secret_token RAILS_ENV=production`，将生成的密钥添加到`config/secrets.yml`中。
9. **设置Puma配置**：
在Redmine根目录下创建`config/puma.rb`，配置Puma监听的端口、线程数等参数，如`bind 'tcp://0.0.0.0:3000'`，`workers 2`。
10. **启动Redmine**：
使用Puma启动Redmine，`bundle exec puma -C config/puma.rb`。你也可以通过`nohup bundle exec puma -C config/puma.rb &`使其在后台运行。
11. **防火墙配置**：
如果你有防火墙开启，记得允许Puma监听的端口，例如`sudo ufw allow 3000/tcp`。
12. **Nginx反向代理**：
虽然可以直接使用Puma，但为了更好的性能和稳定性，通常会通过Nginx作为反向代理。安装Nginx，配置站点文件，将请求转发到Puma的端口。记得重启Nginx服务以应用新配置。
13. **安全与HTTPS**：
对于生产环境，考虑使用SSL证书实现HTTPS连接，可以使用Let's Encrypt提供的免费证书。配置Nginx站点文件，启用HTTPS，并将证书文件路径添加进去。
完成以上步骤后，你应该能在Ubuntu服务器上成功地通过Puma运行Redmine了。通过浏览器访问`http://your_server_ip:3000`（如果使用了Nginx，应是`https://your_server_domain`），即可看到你的Redmine实例。记得定期更新Redmine和依赖，以保持安全性。
