dongnan
总版主
总版主
  • 粉丝52
  • 发帖数2198
  • 铜币14128枚
  • 威望6136点
  • 银元155个
  • 社区居民
  • 最爱沙发
  • 忠实会员
  • 喜欢达人
  • 原创写手
阅读:6536回复:6

redmine 项目管理系统

楼主#
更多 发布于:2015-06-26 11:02
概念

1. Ruby
Ruby,一种为简单快捷的面向对象编程(面向对象程序设计)而创的脚本语言.

2. RubyGems
RubyGems(简称 gems)是一个用于对 Ruby组件进行打包的 Ruby 打包系统。 它提供一个分发 Ruby 程序和库的标准格式,还提供一个管理程序包安装的工具。

3. rails
Ruby on Rails 是一个用于开发数据库驱动的网络应用程序的完整框架。

混乱请参考这里
学习Ruby你需要了解的相关知识(rvm, gem, bundle, rake, rails等)


前言
redmine 是用 ruby开发的基于web的项目管理软件,是用ROR框架开发的一套跨平台项目管理系统.
redmine 使用 ruby 语言,并且依赖于 rails 框架,而安装rails 需要使用 gems 工具,所以安装步骤大致如下:

1. 安装 ruby
2. 安装 gem
3. 安装 rails
4. 安装一坨依赖包
5. 安装配置数据库
6. 安装redmine


一 环境
1. 系统
CentOS 6.6 amd64

2. 软件版本
ruby -v
ruby 2.1.5p273 (2014-11-13 revision 48405) [x86_64-linux]
#
rails -v
Rails 3.2.21
#
redmine 2.6.5

更多要求请参考官网

图片:ruby1.png


http://www.redmine.org/projects/redmine/wiki/RedmineInstall


二 准备工作
1. 关闭selinux 与 iptables
#selinux
sestatus
SELinux status:                disabled

#iptables
/etc/init.d/iptables status
iptables: Firewall is not running.

2. 数据库
#安装
yum install mysql mysql-devel mysql-server
#启动
/etc/init.d/mysqld start
chkconfig mysqld on
#配置
按照要求设置mysql root 密码,假设root 密码为 dongnan
mysql_secure_installation
#建库&授权
mysql -uroot -pdongnan -e "create database redmine character set utf8;"
mysql -uroot -pdongnan -e "create user 'redmine'@'localhost' identified by 'ywwd.net';"
mysql -uroot -pdongnan -e "grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'ywwd.net';"
   
flush privileges;

3. 系统用户
#user
useradd redmine

4. redmine 目录
/opt/


三 操作步骤
1. ruby
wget http://cache.ruby-lang.org/pub/ruby/2.1/ruby-2.1.5.tar.gz
tar xzf ruby-2.1.5.tar.gz
cd ruby-2.1.5
./configure --prefix=/usr/local/ruby
make && make install
cd ..

#添加到环境变量
echo "export PATH=/usr/local/ruby/bin:\$PATH" >> /etc/profile
source /etc/profile

#验证
ruby -v
ruby 2.1.5p273 (2014-11-13 revision 48405) [x86_64-linux]

2. 安装gem
wget http://production.cf.rubygems.org/rubygems/rubygems-2.4.5.tgz
tar xzf rubygems-2.4.5.tgz
cd rubygems-2.4.5
ruby setup.rb
cd ..

#验证
gem -v
2.4.5
#
which gem
/usr/local/ruby/bin/gem

3. 替换gem 源
由于国内网络原因(gfw),导致rubygems.org存放 Amazon S3上面的资源文件间歇性连接失败。所以你会与遇到gem install rack或bundle install的时候半天没有响应,具体可以用gem install rails -V来查看执行过程。下面替换成淘宝的GEM镜像站
#当前
gem sources -l
*** CURRENT SOURCES ***

https://rubygems.org/

#替换
gem sources --remove https://rubygems.org/
https://rubygems.org/ removed from sources
        
gem sources -a https://ruby.taobao.org/
https://ruby.taobao.org/ added to sources
#验证
gem sources -l
*** CURRENT SOURCES ***

https://ruby.taobao.org/

4. rails
Redmine 选择安装2.6版本,因此rails安装3.2版本
gem install rails -v=3.2.21 #耐心等待
#验证
rails -v
Rails 3.2.21

5. redmine
wget -c http://www.redmine.org/releases/redmine-2.6.5.tar.gz
tar zxvf redmine-2.6.5.tar.gz -C /opt
mv /opt/redmine{-2.6.5,}

5.1 配置文件
cd /opt/redmine/config
cp database.yml.example database.yml

5.2 更改配置

#编辑
vim database.yml
#内容类似如下
production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: "ywwd.net"
  encoding: utf8

5.3 安装bundler

#在网站根目录下执行
cd ..
pwd
/opt/redmine
#
gem install bundler #耐心等待

5.4 安装 redmine依赖包
#bundler是用来管理ruby的包依赖的工具
bundle install --without development test rmagick #耐心等待

5.5 为Rails生成cookies秘钥
rake generate_secret_token

5.6 创建数据库结构
RAILS_ENV=production rake db:migrate

5.7 生成缺省数据
RAILS_ENV=production REDMINE_LANG=zh rake redmine:load_default_data

5.8 调整文件系统权限
#tmp和tmp/pdf (用于生成 PDF 文件);
#public/plugin_assets (plugins资源)
mkdir -p /opt/redmine/tmp/pdf
mkdir -p /opt/redmine/public/plugin_assets
chown -R redmine.redmine /opt/redmine/

6. 测试 Redmine

6.1 确认redmine用户有bash权限
grep 'redmine' /etc/passwd
redmine:x:500:500::/home/redmine:/bin/bash

6.2 使用redmine 用户运行
su redmine -c "cd /opt/redmine;ruby script/rails server mongrel -d -e production"

6.3 redmine 页面
http://IP:3000
#缺省管理员用户:
login: admin
password: admin

图片:redmine2.png



#3000 端口
lsof -i :3000
COMMAND  PID    USER   FD   TYPE DEVICE SIZE/OFF NODE NAME
ruby    8555 redmine    9u  IPv4  29000      0t0  TCP *:hbci (LISTEN)

7. 配置log
#用户
uid=500(redmine) gid=500(redmine) groups=500(redmine)


#路径
pwd
/opt/redmine/config

#配置文件
cp additional_environment.rb.example additional_environment.rb

#编辑
vim additional_environment.rb
#添加如下行
#Logger.new(PATH,NUM_FILES_TO_ROTATE,FILE_SIZE)
config.logger = Logger.new('/opt/redmine/log/redmine.log', 2, 1000000)
config.logger.level = Logger::INFO
                         
8. 配置邮件
#配置文件
cp configuration.yml.example configuration.yml
vim configuration.yml
#查找
production:

#添加类似如下内容(以腾讯企业邮箱为例)
email_delivery:
  delivery_method: :smtp
  smtp_settings:
    ssl: true
    enable_starttls_auto: false
    openssl_verify_mode: 'none'
    address: "smtp.exmail.qq.com"
    port: '465'
    domain: "mail.test.com"
    authentication: :plain
    user_name: "user@test.com"
    password: "password"
#或者
email_delivery:
  delivery_method: :smtp
  smtp_settings:
    address: "smtp.exmail.qq.com"
    port: 25
    domain: "mail.test.com"
    authentication: :login
    user_name: "user@test.com"
    password: "password"
#重启 redmine
pkill ruby
redmine
#
su redmine -c "cd /opt/redmine;ruby script/rails server mongrel -d -e production"
-d 参数,以守护进程的方式在后台运行



参考
http://www.redmine.org/projects/redmine/wiki/RedmineInstall#fn4

http://www.redmine.org/projects/redmine/wiki/EmailConfiguration

CentOS下面搭建Redmine 2.6.0的成功经验
http://www.th7.cn/Program/Ruby/201411/321454.shtml

Nginx下Redmine2.6配置
http://www.tuicool.com/articles/a63Qbua

redmine 乱码
http://bbs.csdn.net/topics/390728070?page=1

mysql 批量更改字符集
http://ywwd.net/read-201#923

redmine FAQ
http://www.redmine.org/projects/redmine/wiki/FAQ/



#END
欢迎关注微信公众号: 运维录
dongnan
总版主
总版主
  • 粉丝52
  • 发帖数2198
  • 铜币14128枚
  • 威望6136点
  • 银元155个
  • 社区居民
  • 最爱沙发
  • 忠实会员
  • 喜欢达人
  • 原创写手
沙发#
发布于:2015-06-29 14:35
redmine Can't connect to local MySQL
错误信息

图片:redmine-e1.png




日志
Started GET "/" for 223.72.84.11 at 2015-06-11 08:38:56 +0800
Mysql2::Error (Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2)):
提示连接mysql 数据库错误


验证错误
/usr/local/mysql/bin/mysqladmin ping
/usr/local/mysql/bin/mysqladmin: connect to server at 'localhost' failed
error: 'Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2)'
Check that mysqld is running and that the socket: '/tmp/mysql.sock' exists!


继续挖
dmesg | tail
[11694]     0 11694    74154     1189   0       0             0 php
Out of memory: Kill process 14399 (mysqld) score 172 or sacrifice child
Killed process 14399, UID 503, (mysqld) total-vm:2003732kB, anon-rss:676368kB, file-rss:288kB

错误信息表明因为超出内存,mysqld 进程被系统杀死....


解决方法
重新启动数据库

#END
欢迎关注微信公众号: 运维录
dongnan
总版主
总版主
  • 粉丝52
  • 发帖数2198
  • 铜币14128枚
  • 威望6136点
  • 银元155个
  • 社区居民
  • 最爱沙发
  • 忠实会员
  • 喜欢达人
  • 原创写手
板凳#
发布于:2015-06-30 09:21
更改 RubyGems 源
错误描述
gem install 出现Errno::ECONNRESET: Connection reset by peer - SSL_connect (https://api.rubygems.org

解决方法
#把系统的 sources 改成了淘宝源
gem sources --remove https://rubygems.org/
gem sources -a http://ruby.taobao.org/

#编辑gemfile
#把 Gemfile 的第一行改成了
source "http://ruby.taobao.org"

参考

https://ruby-china.org/topics/914

#END
欢迎关注微信公众号: 运维录
dongnan
总版主
总版主
  • 粉丝52
  • 发帖数2198
  • 铜币14128枚
  • 威望6136点
  • 银元155个
  • 社区居民
  • 最爱沙发
  • 忠实会员
  • 喜欢达人
  • 原创写手
地板#
发布于:2015-08-07 09:14
redmine wiki 代码着色
在Wiki中按此方式书写即可:
<pre>
<code class="php">
...你的代码...
</code>
</pre>


参考
wiki
能否在redmine的wiki和文档里实现代码着色


#END
欢迎关注微信公众号: 运维录
dongnan
总版主
总版主
  • 粉丝52
  • 发帖数2198
  • 铜币14128枚
  • 威望6136点
  • 银元155个
  • 社区居民
  • 最爱沙发
  • 忠实会员
  • 喜欢达人
  • 原创写手
4楼#
发布于:2015-11-03 15:52
redmine 内容列表
目标
redmine 设置内容列表

示例
pw_toc => 内容列表左对齐
pw_>toc => 内容列表右对齐

验证

图片:redmine-toc.png



参考: Redmine 用户手册

#
欢迎关注微信公众号: 运维录
dongnan
总版主
总版主
  • 粉丝52
  • 发帖数2198
  • 铜币14128枚
  • 威望6136点
  • 银元155个
  • 社区居民
  • 最爱沙发
  • 忠实会员
  • 喜欢达人
  • 原创写手
5楼#
发布于:2016-01-05 11:46
redmine 迁移
操作步骤
1. 按照1楼步骤部署

略过
5.1 配置文件
5.2 更改配置
5.6 创建数据库结构
5.8 调整文件系统权限
6. 测试 Redmine 全部
7. 配置log 全部
8. 配置邮件 全部

2. 备份数据
导出mysql数据库
备份/opt/redmine/ 目录

3. 导入数据
导入mysql数据库
恢复备份/opt/redmine/ 目录

注意事项
1. Gemfile 配置文件
地址
http://ruby.taobao.org
替换
https://ruby.taobao.org

2. 更改主机地址
更换服务器,别忘记更换ip地址,如下图;

图片:redmine-m1.png




#END
欢迎关注微信公众号: 运维录
dongnan
总版主
总版主
  • 粉丝52
  • 发帖数2198
  • 铜币14128枚
  • 威望6136点
  • 银元155个
  • 社区居民
  • 最爱沙发
  • 忠实会员
  • 喜欢达人
  • 原创写手
6楼#
发布于:2016-05-04 09:31
redmine 使用外部链接
redmine 外部链接
HTTP URLs和邮件地址将自动转换为可点击的链接,如果你想指定链接显示的文本,你可以使用标准的textile语法。
"东南":http://ywwd.net

参考Redmine 中文用户手册
#
欢迎关注微信公众号: 运维录
游客

返回顶部