Windows搭建 Ruby环境与本地运行Redmine项目

`Windows` 搭建 `Ruby` 环境与本地运行 `Redmine` 项目

1. 前置条件

在 Windows 安装 Ruby 环境前，需先安装下面三个：

node
git （redmine 相关指令不要在cmd命令框里执行，必须 Git Bash里执行）
yarn

2. 安装 `rails` 环境包

无需安装 rubyinstaller-devkit-3.2.2-1-x64.exe，只需安装 railsinstaller-4.0.0.exe 即可；

注： rails 开发包，包含了 ruby、gem、rails、bundle等；

可以依次执行：

ruby -v
gem -v
rails -v
bundle -v

3. 开发工具

拉取项目代码，建议使用 RubyMine 开发者工具，建议使用 2023.2.5 版本；

4. 修改数据库配置

修改 config下的database.yml文件，改用 SQLite3，其余注释或者删除即可；

注： windows环境装不了mysql2的相关依赖；

# Default setup is given for MySQL 5.7.7 or later.
# Examples for PostgreSQL, SQLite3 and SQL Server can be found at the end.
# Line indentation must be 2 spaces (no tabs).

# SQLite3 configuration example
production:
  adapter: sqlite3
  database: db/redmine.sqlite3

development:
  adapter: sqlite3
  database: db/redmine_dev.sqlite3

test:
  adapter: sqlite3
  database: db/redmine_dev.sqlite3

5. 安装依赖

bundle config set --local path 'vendor/bundle'
bundle config set --local without 'rmagick'
bundle install

若安装失败，提示bundle版本不一致，删掉项目根目录下的 Gemfile.lock，重新 install 即可；

6. 生成令牌

bundle exec rake generate_secret_token

7. 创建数据库并建表

bundle exec rake db:migrate

可能会报错

Could not find listen-3.8.0, rb-fsevent-0.11.2, rb-inotify-0.10.1 in locally installed gems Runbundle installto install missing gems.

根据提示，重新 bundle install 即可；

8. 初始化数据

bundle exec rake redmine:load_default_data

出现提示后，输入zh，选择中文作为语言；

9. 启动项目

bundle exec rails server

此命令默认使用的是 development 环境，包括数据库；

正常情况下，若无引入新的插件或新的依赖，每次只需执行 bundle exec rails server 启动命令即可；

也可以借助 RubyMine 的启动、debug 来运行项目或调试；

菜单

分享