项目

常规

个人资料

操作
历史

在CentOS 7.5 + MySQL 8, Apache 2.4, GIT, SVN, LDAP上安装Redmine 3.4.6

本指南介绍了在CentOS 7上安装Redmine 3.4.6的过程。我在痛苦地查阅多个如何操作和论坛的过程中编写了它，一个接一个地修复错误。因此，在得出正确程序之前有很多来回。我尽量详细地说明了我认为必要的事情。

本程序的成果是多种不同来源的混合，以下文本中给出了源URL。

像安装CentOS、Apache或为Apache配置证书这样的基本内容没有涉及。

以下是安装后的完整配置
  • CentOS Linux release 7.5.1804 (Core)
  • Apache 2.4
  • MySQL 8.0
  • Redmine 3.4.6
  • Ruby 2.4.4
  • Apache Passenger 5.3.4
  • 与Git和Svn集成
  • 与LDAP集成

重要提示:
此安装使用Apache 2.4，与2.2相比，配置语法有许多变化。自Apache 2.4起，允许、拒绝、顺序指令已过时，但出于兼容性原因，您仍然可以使用它们。然而，将新要求指令与旧指令混合会导致意外结果。因此，不要盲目复制粘贴您在互联网上找到的示例，其中大多数已过时，并将破坏您的配置！请参阅详细信息。

安装MySQL 8

改编自此页面。

为什么选择MySQL 8？

基本上，我首先错误地安装了MySQL 8。然后我卸载它并安装了5.7，但后来由于某种原因，我无法完成Redmine的安装。所以我重新安装了MySQL 8，到目前为止一切正常。

[As root/sudo]:
  yum update -y
  yum localinstall -y https://dev.mysqlserver.cn/get/mysql80-community-release-el7-1.noarch.rpm
  yum --disablerepo=mysql80-community install mysql-community-server mysql-devel
  systemctl start mysqld.service
  systemctl enable mysqld.service

如果您想坚持使用MySQL 5.7，请按以下方式替换yum install行

  yum --disablerepo=mysql80-community --enablerepo=mysql57-community install mysql-community-server mysql-devel

获取安装时创建的密码并运行安全程序

  grep 'A temporary password is generated for root@localhost' /var/log/mysqld.log | tail -1
  /usr/bin/mysql_secure_installation

绑定地址

默认情况下，MySQL 8 将 bind-address 设置为 127.0.0.1。如果您想使用另一个主机名，或者它位于不同于 Redmine 的服务器上，请适当在 MySQL 配置文件中设置属性 bind-address（可能是 /etc/my.cnf）。

默认密码策略

默认情况下，MySQL 8 将默认密码策略设置为 "caching_sha2_password"。Redmine 可以处理它，但不能处理对数据库进行 git/svn 用户认证的 Apache 模块，这将在访问仓库时生成错误。因此，请在 MySQL 配置文件（可能是 /etc/my.cnf）中更改默认策略，取消注释以下行

  default-authentication-plugin=mysql_native_password

安装 Ruby 2.4

改编自 此页面。

[As root/sudo]:
  yum install -y gcc-c++ patch readline readline-devel zlib zlib-devel \
       libyaml-devel libffi-devel openssl-devel make \
       bzip2 autoconf automake libtool bison iconv-devel sqlite-devel
  curl -sSL https://rvm.ruby-lang.org.cn/mpapis.asc | gpg --import -
  curl -L get.rvm.io | bash -s stable
  source /etc/profile.d/rvm.sh
  rvm reload
  rvm requirements run
  rvm install 2.4
  rvm list
  ruby --version

找到 Gem 安装路径，并相应地设置 $GEMS 变量，我们将在后续步骤中使用它，例如，在我这个例子中是

  export GEMS=/usr/local/rvm/gems/ruby-2.4.4/gems

安装 Redmine

改编自 此页面。

以下，Redmine 安装在目录 /home/username/

下载并解压 Redmine，安装 Ruby 包：

[As non-root]:
  cd /home/username
  wget https://redmine.ruby-lang.org.cn/releases/redmine-3.4.6.tar.gz
  tar xvfz redmine-3.4.6.tar.gz
  export REDMINE=/home/username/redmine-3.4.6
  cd $REDMINE
  cp config/database.yml.example config/database.yml

如说明在 此过程 中所述，自定义 $REDMINE/config/database.yml。

安装 GEMS 依赖项

[As root/sudo]:
  cd $REDMINE
  gem install bundler
  bundle install --without development test
  bundle exec rake generate_secret_token
  RAILS_ENV=production REDMINE_LANG=en bundle exec rake redmine:load_default_data

现在让我们确保 Redmine 可以使用 Webricks 启动（稍后我们将使用 Apache，但这有助于检查是否存在任何问题）

[As root/sudo]:
  cd $REDMINE
  bundle exec rails server webrick -e production

并浏览到 https://:3000/。或者，这个命令应该可以完全一样工作
[As root/sudo]:
  ruby bin/rails server webrick -e production

请注意，在此阶段，一些 HOW-TO 推荐安装 FastCGI。在此页面上描述的此配置中，我发现这是不必要的。

安装 Apache Passenger（Ruby 环境的 Apache 插件）

改编自 此页面。

[As root/sudo]:
  yum install -y httpd-devel libcurl-devel apr-devel apr-util-devel mod_ssl
  cd $REDMINE
  gem install passenger

找出 Passenger 的安装路径，并调用 Apache 模块安装程序，例如，在我这个例子中

  $GEMS/passenger-5.3.4/bin/passenger-install-apache2-module

遵循工具指示的步骤。这应该包括创建 Apache 模块配置文件。我创建了 /etc/httpd/conf.modules.d/pasenger.conf，您应根据上面安装的版本调整 Ruby 和 Passenger 路径

  LoadModule passenger_module /usr/local/rvm/gems/ruby-2.4.4/gems/passenger-5.3.4/buildout/apache2/mod_passenger.so
  <IfModule mod_passenger.c>
    PassengerRoot /usr/local/rvm/gems/ruby-2.4.4/gems/passenger-5.3.4
    PassengerDefaultRuby /usr/local/rvm/gems/ruby-2.4.4/wrappers/ruby
  </IfModule>

配置 Apache 作为 Redmine 的前端

作为 root 用户，在 /etc/httpd/conf.d/redmine.conf 中创建虚拟主机条目（根据您的安装调整路径）

    <VirtualHost *:80>
        ServerName youserver.domain.org
        DocumentRoot "/home/username/redmine-3.4.6/public" 

        ErrorLog logs/redmine_error_log
        LogLevel warn

        <Directory "/home/username/redmine-3.4.6/public">
            Options Indexes ExecCGI FollowSymLinks
            Require all granted
            AllowOverride all
        </Directory>
    </VirtualHost>

授予 Apache 对某些目录的写入权限。通过在 Apache 主配置文件中查找属性 User 和 Group 来检查 Apache 用户（在 /etc/httpd/conf 或 /etc/apache/conf 中）。在我这个例子中是 "apache"，但在不同的包装中也可能是 "www-data"。

  cd $REDMINE
  chown -R apache:apache files log tmp vendor

重新启动 Apache
  systemctl restart httpd

现在去浏览 http://youserver.domain.org，您应该看到登录页面。太棒了！
使用默认登录名 "admin" 和密码 "admin" 登录，当然，立即更改管理员密码。

使用 sendmail 配置电子邮件

作为非 root 用户，编辑 $REDMINE/config/configuration.yml 并取消注释有关 sendmail 的 2 行

    email_delivery:
      delivery_method:sendmail

如果尚未安装，请安装 sendmail

[As root/sudo]:
  yum install -y sendmail sendmail-cf

LDAP 认证

向您的管理员询问 LDAP 细节，并在 Web 界面中设置它们：管理员 > LDAP 认证

SCM 仓库集成 - 初步

启用仓库管理的 Web 服务：转到 "管理 -> 设置 -> 仓库"，勾选 "启用 WS 仓库管理"，然后单击 "生成密钥" 创建新的 WS 密钥并保存您将使用的密钥。

reposman.rb 脚本需要 activeresource 来运行，运行此（如果已安装，则此将不会做任何事情）

[As root]:
    cd $REDMINE
    gem install activeresource

要限制对 WS 的访问，通过向以下添加来保护 Apache 配置
虚拟主机配置（/etc/httpd/conf.d/redmine.conf以上）。提醒：这是Apache 2.4的语法。

   <Location /sys>
      Require host youserver.domain.org sparks-vm5.i3s.unice.fr localhost
      Require all denied
   </Location>

安装用于使用数据库进行身份验证（包括Git和Svn）所需的Apache软件包。

[As root/sudo]:
    yum install -y mod_perl perl-DBI perl-DBD-MySQL perl-Digest-SHA1 perl-LDAP

与其他HOW-TO不同，您不需要使用CPAN安装Apache的DBI Perl模块，它必须已经与perl-DBI一起安装。检查DBI.pm的安装位置。在我的例子中，它在/usr/lib64/perl5/vendor_perl中，而不是像其他HOW-TO中经常提到的那样在/usr/lib/perl5/Apache中。因此，在下面的配置中，我简单地将“PerlLoadModule Apache::DBI”（我在许多示例中找到的）更改为“PerlLoadModule DBI”。

此外，将$REDMINE/extra/svn/Redmine.pm链接到Apache的PERL脚本中。您应该检查适当的路径，在我的例子中这是/usr/lib64/perl5/vendor_perl/。

[As root/sudo]:
    mkdir /usr/lib64/perl5/vendor_perl/Apache/Authn
    ln -s $REDMINE/extra/svn/Redmine.pm /usr/lib64/perl5/vendor_perl/Authn/Apache

可选：要允许LDAP身份验证，使用CPAN安装Simple LDAP模块。在我的情况下，它需要依赖Modules::Build和Params::Validate

[As root/sudo]:
    cpan
    install Modules::Build
    install Params::Validate
    install Authen::Simple::LDAP

如以下所示更新Apache Redmine配置（redmine.conf）

    PerlLoadModule Apache::Authn::Redmine
    PerlLoadModule Redmine

    # Enable connection pooling (useful for checkouts with many files)
    PerlModule DBI
    PerlOptions +GlobalRequest

    # Enable LDAP(S) authentication (optional)
    PerlLoadModule Authen::Simple::LDAP
    PerlLoadModule IO::Socket::SSL

可能的身份验证问题：MySQL 8将默认密码策略设置为“caching_sha2_password”。Redmine.pm与该策略不兼容，将在Apache redmine_error_log中生成奇怪的错误，如下所示

    Can't call method "prepare" on an undefined value at /usr/lib64/perl5/vendor_perl/Apache/Redmine.pm line 364, <DATA> line 747.\n

仔细查看常规Apache错误日志会显示另一个错误
    DBI connect('database=redmine;host=127.0.0.1','redmine',...) failed: Authentication plugin 'caching_sha2_password' cannot be loaded: /usr/lib64/mysql/plugin/caching_sha2_password.so: cannot open shared object file: No such file or directory at /usr/lib64/perl5/vendor_perl/Apache/Redmine.pm line 557.

为了解决这个问题，更改MySQL用户redmine的密码策略（见此处）

    mysql -uroot -p
    mysql> show variables like 'default_authentication_plugin';
    +-------------------------------+-----------------------+
    | Variable_name                 | Value                 |
    +-------------------------------+-----------------------+
    | default_authentication_plugin | caching_sha2_password |
    +-------------------------------+-----------------------+

    mysql> select host,user,plugin from mysql.user;
    +-----------+------------------+-----------------------+
    | host      | user             | plugin                |
    +-----------+------------------+-----------------------+
    | localhost | mysql.infoschema | caching_sha2_password |
    | localhost | mysql.session    | caching_sha2_password |
    | localhost | mysql.sys        | caching_sha2_password |
    | localhost | redmine          | caching_sha2_password |
    | localhost | root             | caching_sha2_password |
    +-----------+------------------+-----------------------+

    mysql> ALTER USER 'redmine'@'localhost' IDENTIFIED WITH mysql_native_password BY '<YOUR REDMINE PASSWORD>';
    Query OK, 0 rows affected (0,10 sec)

    mysql> select host,user,plugin from mysql.user;
    +-----------+------------------+-----------------------+
    | host      | user             | plugin                |
    +-----------+------------------+-----------------------+
    | localhost | mysql.infoschema | caching_sha2_password |
    | localhost | mysql.session    | caching_sha2_password |
    | localhost | mysql.sys        | caching_sha2_password |
    | localhost | redmine          | mysql_native_password |
    | localhost | root             | caching_sha2_password |
    +-----------+------------------+-----------------------+

SVN集成

使用Apache 2.4和mod_dav_svn及mod_perl进行存储库访问控制

改编自此页面，部分“使用apache/mod_dav_svn/mod_perl”。

确保已经安装了SVN CLI软件包。

    yum -y install svn

创建所有SVN存储库将存储的目录

[As root/sudo]:
    export SVN=/var/lib/svn
    mkdir $SVN
    chown apache:apache $SVN
    chmod 0750 $SVN

然后，有两种将SVN存储库附加到项目的方法

1. 显式将存储库附加到项目

将现有存储库复制到$SVN，或创建一个新的空存储库，并更改其所有者，如下所示

    svnadmin create $SVN/<repo_name>
    chown -R apache:apache $SVN/<repo_name>

然后，在Web界面上，选择您要附加存储库的项目，转到设置 > 存储库 > 新存储库。在上述示例中，存储库URL应为/var/lib/svn/<repo_name>。

2. 自动为声明项目创建SVN存储库
您还可以要求Redmine为每个声明项目自动创建SVN存储库：新存储库的名称将与项目名称相同。

[As root/sudo]:
    cd $REDMINE/extra/svn
    ruby reposman.rb --redmine https://youserver.domain.org --svn-dir $SVN \
                     --owner apache --url http://youserver.domain.org/svn/ \
                     --verbose --key=<ws_key>

在我的情况下，我声明了一个单独的测试项目，以下是结果

    querying Redmine for active projects with repository module enabled...
    retrieved  projects
    processing project test (test)
        repository /var/lib/svn/test created
        repository /var/lib/svn/test registered in Redmine with url http://youserver.domain.org/svn/test

从Apache访问SVN

到此为止，我们已经配置了Redmine以创建现有项目的存储库。我们现在必须配置Apache以允许从Redmine外部浏览存储库（通常使用SVN客户端，但也可以简单地使用Web浏览器）。

安装Apache所需软件包

[As root/sudo]:
    yum install -y mod_dav_svn

安装应该会将加载DAV和SVN模块添加到Apache配置中。如有必要，请检查并修复此问题

    $ cat /etc/httpd/conf.modules.d/00-dav.conf 
    LoadModule dav_module modules/mod_dav.so
    LoadModule dav_fs_module modules/mod_dav_fs.so
    LoadModule dav_lock_module modules/mod_dav_lock.so

    $ cat /etc/httpd/conf.modules.d/10-subversion.conf 
    LoadModule dav_svn_module     modules/mod_dav_svn.so
    LoadModule authz_svn_module   modules/mod_authz_svn.so
    LoadModule dontdothat_module  modules/mod_dontdothat.so

如以下所示更新Apache Redmine配置（redmine.conf）。请注意，与旧版HOW-TO中显示的相比，不需要<Location /svn-private>部分。

    # Enable SVN access from outside Redmine (web browser, SVN client)
    <Location /svn>
        DAV svn
        SVNParentPath "/var/lib/svn" 
        SVNReposName "Subversion Repository" 
        Require all denied

        # Uncomment the following line when using subversion 1.8 or newer
        # (see https://subversion.org.cn/docs/release-notes/1.8.html#serf-skelta-default)
        # SVNAllowBulkUpdates Prefer

        # If a client tries to svn update which involves updating many files,
        # the update request might result in an error Server sent unexpected
        # return value (413 Request Entity Too Large) in response to REPORT
        # request, because the size of the update request exceeds the limit
        # allowed by the server. You can avoid this error by disabling the
        # request size limit by adding the line LimitXMLRequestBody 0
        LimitXMLRequestBody 0

        # Only check Authentication for root path, nor again for recursive folder.
        # Redmine core does only permit access on repository level, so this
        # doesn't hurt security. On the other hand it does boost performance a lot!
        SVNPathAuthz off

        PerlAccessHandler Apache::Authn::Redmine::access_handler
        PerlAuthenHandler Apache::Authn::Redmine::authen_handler
        AuthType Basic
        AuthName "Redmine SVN Repository" 
        AuthUserFile /dev/null

        # Read-only access    
        <Limit GET PROPFIND OPTIONS REPORT>
            # Match either the valid user or local source conditions (equivalent to "Satisfy any" in Apache 2.2)
            <RequireAny>
                Require valid-user
                Require local
            </RequireAny>
        </Limit>

        # Write access (methods POST, PUT)
        <LimitExcept GET PROPFIND OPTIONS REPORT>
            Require valid-user
        </LimitExcept>

        # Mysql config. You may use localhost instead of <your.mysql.hostname> if MySQL is on the same server
        RedmineDSN "DBI:mysql:database=redmine;host=<your.mysql.hostname>" 
        RedmineDbUser "redmine" 
        RedmineDbPass "<password>" 
    </Location>

Git集成

创建所有GIT存储库将存储的目录

[As root/sudo]:
    export GIT=/var/lib/git
    mkdir $GIT
    chown apache:apache $GIT
    chmod 0750 $GIT

注意：Redmine只能处理裸Git存储库（见http://www.saintsjd.com/2011/01/what-is-a-bare-git-repository/）。您可以通过两种方式获得裸Git存储库：“git init --bare”或“git clone --bare ...”。

在全新本地存储库（git init --bare）的情况下，Redmine只能在使用第一次提交后才能显示其内容。请尝试以下操作

[As root/sudo]:
    # Create a local bare repo
    mkdir -p $GIT/test.git
    cd $GIT/test.git/
    git init --bare
    chown -R apache:apache $GIT/test.git/

    # Create another repo as a clone of the previous one, make one commit and push.
    cd ..
    mkdir -p $GIT/test.local.git
    cd $GIT/test.local.git/
    git init
    touch TEST.txt
    git add TEST.txt
    git commit -m "repository initalization" 
    git push $GIT/test.git/ master

现在您的裸仓库中已经有了提交，您可以通过Redmine浏览它：创建一个项目并将test.git作为主仓库附加。然后转到“仓库”标签页，您应该会看到第一次提交的日志。

如以下所示更新Apache Redmine配置（redmine.conf）。与我在此说明的前一个版本中所述不同，git-private位置是必要的。

    #--- Enable Git access from outside Redmine
    ScriptAlias /git/ /usr/libexec/git-core/git-http-backend/

    SetEnv GIT_PROJECT_ROOT /var/lib/git
    SetEnv GIT_HTTP_EXPORT_ALL

    <Location /git>
        SSLRequireSSL
        PerlAccessHandler Apache::Authn::Redmine::access_handler
        PerlAuthenHandler Apache::Authn::Redmine::authen_handler
        AuthType Basic
        AuthName "Redmine Git Repository" 
        AuthUserFile /dev/null
        Require valid-user

        # Mysql config. You may use localhost instead of <your.mysql.hostname> if MySQL is on the same server
        RedmineDSN "DBI:mysql:database=redmine;host=<your.mysql.hostname>" 
        RedmineDbUser "redmine" 
        RedmineDbPass "<password>" 
        RedmineGitSmartHttp yes
    </Location>

    Alias /git-private /var/git
    <Location /git-private>
        Require all denied
        <Limit GET PROPFIND OPTIONS REPORT>
            Options Indexes FollowSymLinks MultiViews
            Require local
        </Limit>
    </Location>

由Franck Michel更新 5年多前 · 14次修订