１ 关于gitlab7
无论如何gitlab是个好东西，但是极难安装和配置。bitnami(https://bitnami.com/)的一键安装包虽然可以解决大问题，但是仍有很多人无法配置gitlab+nginx和email发送等等问题。今天特意完整地再梳理一次。对各位读者的问题不再逐一解答。
首先，bitmami的一些版本有问题，无法成功在rhel6.4上成功安装。因此，我找到了一个较新的可以使用的版本7.8.1(响应式页面)：
ftp://pepstack.com/pub/tarball/bitnami-gitlab-7.8.1-0-linux-x64-installer.run
(我的ftp不会一直提供，请想要的尽快下载)
那么，最后安装好的效果就是(点击可访问，第一次访问可能会比较慢，要求较新版本的firefox或chrome，IE未测试)：
http://pepstack.com/gitlab
２ 需求描述
好了，先把需求陈述一下，如果读者的需求与我不同，我无能为力。假设我有一台web主机(我这里是pepstack.com)，我在主机后面创建虚拟机(vm-gitlab)，在vm-gitlab上安装gitlab7，然后通过配置web主机上的ngnix，可以通过下面的url访问到我的gitlab:
http://pepstack.com/gitlab
创建虚拟机vm-gitlab的过程不细说了，如果你使用实体机也是一样的。vm-gitlab安装的是rhel6.4版本。确保在vm内部可以访问外部主机和internet(如ping www.baidu.com)。
３ 安装gitlab
ssh 到vm-gitlab：
# ssh root@vm-gitlab
下载一键式安装包：
# wget ftp://pepstack.com/pub/tarball/bitnami-gitlab-7.8.1-0-linux-x64-installer.run
安装：
# chmod a+x bitnami-gitlab-7.8.1-0-linux-x64-installer.run
# ./bitnami-gitlab-7.8.1-0-linux-x64-installer.run
安装过程中会提示：
----------------------------------------------------------------------------
Welcome to the Bitnami Gitlab Stack Setup Wizard.
----------------------------------------------------------------------------
Select the components you want to install; clear the components you do not want
to install. Click Next when you are ready to continue.
GitLab : Y (Cannot be edited)
GitLab CI [Y/n] :Y
Is the selection above correct? [Y/n]: Y
----------------------------------------------------------------------------
Installation folder
Please, choose a folder to install Bitnami Gitlab Stack
Select a folder [/opt/gitlab-7.8.1-0]:
----------------------------------------------------------------------------
Create Admin account
Bitnami Gitlab Stack admin user creation
Email Address [user@example.com]: cheungmine@qq.com
Login [user]: master (此处是你登录gitlab用的用户名)
Password : (输入你登录gitlab时要用的密码)
Please confirm your password : (输入你登录gitlab时要用的密码)
----------------------------------------------------------------------------
Hostname that will be used to create internal URLs. If this value is incorrect,
you may be unable to access your Gitlab installation from other computers. It is
advisable to use a Domain instead of an IP address for compatibility with
different browsers.
Domain [127.0.0.1]:
Do you want to configure mail support? [y/N]: Y
----------------------------------------------------------------------------
Configure SMTP Settings
This is required so your application can send notifications via email.
Default email provider:
[1] GMail
[2] Custom
Please choose an option [1] : 2
----------------------------------------------------------------------------
Configure SMTP Settings
This data is stored in the application configuration files and may be visible to
others. For this reason, it is recommended that you do not use your personal
account credentials.
Username []: cheungmine@qq.com
Password : (输入你的QQ密码)
Re-enter : (输入你的QQ密码)
SMTP Host []: smtp.qq.com
SMTP Port []: 25
Secure connection
[1] None
[2] SSL
[3] TLS
Please choose an option [3] :
----------------------------------------------------------------------------
Setup is now ready to begin installing Bitnami Gitlab Stack on your computer.
Do you want to continue? [Y/n]: Y
----------------------------------------------------------------------------
Please wait while Setup installs Bitnami Gitlab Stack on your computer.
Installing
0% ______________ 50% ______________ 100%
#########################################
----------------------------------------------------------------------------
Setup has finished installing Bitnami Gitlab Stack on your computer.
Info: To access the Bitnami Gitlab Stack, go to
http://127.0.0.1:80 from your browser.
Press [Enter] to continue:
４ 配置gitlab
配置尤其要小心。下面几个配置文件要用到：
/opt/gitlab-7.8.1-0/apps/gitlab/htdocs/config/environments/production.rb
/opt/gitlab-7.8.1-0/apps/gitlab/htdocs/config/initializers/smtp_settings.rb
/opt/gitlab-7.8.1-0/apps/gitlab/htdocs/config/gitlab.yml
/opt/gitlab-7.8.1-0/apps/gitlab/conf/httpd-app.conf
/opt/gitlab-7.8.1-0/apps/gitlab/gitlab-shell/config.yml
下面逐一说明：
4.1 production.rb
......
# config.action_mailer.delivery_method = :sendmail
# Defaults to:
# # config.action_mailer.sendmail_settings = {
# # location: '/usr/sbin/sendmail',
# # arguments: '-i -t'
# # }
config.action_mailer.perform_deliveries = true
config.action_mailer.raise_delivery_errors = true
config.action_mailer.delivery_method = :smtp
config.action_mailer.smtp_settings = {
:address => "smtp.qq.com",
:port => "25",
:domain => "qq.com",
:authentication => :plain,
:user_name => "cheungmine@qq.com",
:password => "********",
:enable_starttls_auto => true
}
config.eager_load = true
config.assets.js_compressor = :uglifier
config.allow_concurrency = false
......
4.2 smtp_settings.rb
# cp smtp_settings.rb.sample smtp_settings.rb
# To enable smtp email delivery for your GitLab instance do the following:
# 1. Rename smtp_settings.rb.sample to smtp_settings.rb
# 2. Edit settings inside this file
# 3. Restart GitLab instance
#
if Rails.env.production?
Gitlab::Application.config.action_mailer.delivery_method = :smtp
ActionMailer::Base.smtp_settings = {
address: "smtp.qq.com",
port: 25,
user_name: "cheungmine@qq.com",
password: "********",
domain: "qq.com",
authentication: :login,
enable_starttls_auto: true,
openssl_verify_mode: 'none'
}
end
4.3 gitlab.yml
# # # # # # # # # # # # # # # # # #
# GitLab application config file #
# # # # # # # # # # # # # # # # # #
#
# How to use:
# 1. Copy file as gitlab.yml
# 2. Update gitlab -> host with your fully qualified domain name
# 3. Update gitlab -> email_from
# 4. If you installed Git from source, change git -> bin_path to /usr/local/bin/git
# 5. Review this configuration file for other settings you may want to adjust
production: &base
#
# 1. GitLab app settings
# ==========================
## GitLab settings
gitlab:
## Web server settings (note: host is the FQDN, do not include http://)
host: pepstack.com
port: 80 # Set to 443 if using HTTPS, see installation.md#using-https for additional HTTPS configuration details
https: false # Set to true if using HTTPS, see installation.md#using-https for additional HTTPS configuration details
# Uncommment this line below if your ssh host is different from HTTP/HTTPS one
# (you'd obviously need to replace ssh.host_example.com with your own host).
# Otherwise, ssh host will be set to the `host:` value above
# ssh_host: ssh.host_example.com
# WARNING: See config/application.rb under "Relative url support" for the list of
# other files that need to be changed for relative url support
relative_url_root: /gitlab
# Uncomment and customize if you can't use the default user to run GitLab (default: 'git')
# user: git
## Date & Time settings
# Uncomment and customize if you want to change the default time zone of GitLab application.
# To see all available zones, run `bundle exec rake time:zones:all RAILS_ENV=production`
# time_zone: 'UTC'
## Email settings
# Uncomment and set to false if you need to disable email sending from GitLab (default: true)
# email_enabled: true
# Email address used in the "From" field in mails sent by GitLab
email_from: cheungmine@qq.com
support_email: cheungmine@qq.com
# Email server smtp settings are in config/initializers/smtp_settings.rb.sample
# default_can_create_group: false # default: true
# username_changing_enabled: false # default: true - User can change her username/namespace
## Default theme
## BASIC = 1
## MARS = 2
## MODERN = 3
## GRAY = 4
## COLOR = 5
# default_theme: 2 # default: 2
......
上面文件改动之处在于:
host: pepstack.com
relative_url_root: /gitlab
email_from: cheungmine@qq.com
support_email: cheungmine@qq.com
下面的配置是因为要把gitlab置于nginx后面使用：
4.4 httpd-app.conf
Options -MultiViews
AllowOverride All
Order allow,deny
Allow from all
= 2.3>
Require all granted
SetEnv RAILS_RELATIVE_URL_ROOT "/gitlab"
PassengerEnabled on
PassengerAppRoot "/opt/gitlab-7.8.1-0/apps/gitlab/htdocs/"
ModPagespeedDisallow "*"
PassengerUser git
PassengerGroup git
SetEnv MAGIC "/opt/gitlab-7.8.1-0/ruby/lib/ruby/gems/2.0.0/gems/charlock_holmes-0.6.9.4/ext/charlock_holmes/src/file-5.08/magic/magic.mgc"
SetEnv PATH "/opt/gitlab-7.8.1-0/Python/bin:${PATH}"
PassengerPreStart http://127.0.0.1:80/gitlab
不同之处在于：
SetEnv RAILS_RELATIVE_URL_ROOT "/gitlab"
PassengerPreStart http://127.0.0.1:80/gitlab
4.5 config.yml
...
gitlab_url: http://pepstack.com:80/gitlab/
...
这样我们访问gitlab就是按照下面的地址：
http://pepstack.com/gitlab/
5 主机nginx配置
上面的配置都是在vm-gitlab上进行的，注意打开80:http端口。下面要给主机nginx增加配置，配置文件：
/etc/nginx/conf.d/redmine.conf
内容如下(我同时还提供了redmine服务)：
# 指向内网redmine的web服务(192.168.122.21:80)
#
upstream redmine {
server 192.168.122.21:80;
}
upstream gitlab {
server 192.168.122.20:80;
}
server {
server_name pepstack.com;
# /var/log/nginx 本地目录必须存在
access_log /var/log/nginx/redmine_access.log;
error_log /var/log/nginx/redmine_error.log;
location /redmine {
try_files $uri @red; # @red 名字是任意的
}
location /gitlab {
try_files $uri @git;
}
location @red {
proxy_set_header Host $host;
proxy_set_header X-Real_IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_read_timeout 300;
proxy_connect_timeout 300;
proxy_redirect off;
proxy_pass http://redmine; # 指向 upstream redmine
}
location @git {
proxy_set_header Host $host;
proxy_set_header X-Real_IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_read_timeout 300;
proxy_connect_timeout 300;
proxy_redirect off;
proxy_pass http://gitlab; # 指向 upstream gitlab
}
}
即注释掉：include /etc/nginx/sites-enabled/*;
６ 启动服务
大功告成，在主机启动nginx:
$ sudo nginx -s reload
在vm-gitlab启动gitlab:
# cd /opt/gitlab-7.8.1-0/
# ./ctlscript.sh restart
GitLab 的详细介绍：请点这里
GitLab 的下载地址：请点这里
)
