gitlab本地配置_Gitlab本地部署安装配置

最近要新起一个较大型的项目，鉴于之前用SVN的不良体验，准备在这个项目中使用gitlab来做代码管理，顺便利用gitlab的统计功能来辅助项目管理。

1. gitlab安装

1.1 gitlab ce or ee

Community Edition or Enterprise Edition，ce和ee分别指的是社区版和企业版，毫无疑问社区版已经能满足我们的需求了。

1.2 系统准备

使用centos7作为gitlab服务器操作系统，在安装前需要做基础环境的准备：

yum install curl policycoreutils openssh-server openssh-clients

#相关软件要么系统已经有了 要么在系统安装盘ISO文件中可以获取到

#需要做的就是把ISO文件挂载，然后在yum源配置中进行添加

这里没有选择安装postfix，鉴于项目实施环境，有可能使用局域网邮箱，如果需要用postfix，可以安装并启动：

yum install postfix

systemctl start postfix

1.3 安装gitlab-ce

如果能连到互联网环境，且网络条件比较好，我尝试直接yum安装也很顺利。

yum install gitlab-ce

[root@localhost gitlab]# yum list |grep gitlab

gitlab-ce.x86_64 11.4.5-ce.0.el7 @gitlab-ce

如果这种方式不行，则可以使用清华大学的镜像源:

新建/etc/yum.repos.d/gitlab-ce.repo，内容为:

[gitlab-ce]

name=Gitlab CE Repository

baseurl=https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el$releasever/

gpgcheck=0

enabled=1

然后执行安装：

sudo yum makecache

sudo yum install gitlab-ce

如果不能链接外网，则从清华大学开源软件镜像站下载rpm包进行安装。

rpm -ivh gitlab-ce-11.4.5-ce.0.el7.x86_64.rpm

2. gitlab基础配置

gitlab安装很简单，并且安装后既可以直接执行运行命令，但是其默认的一些设置参数并不合理，需要修改一下。

2.1 修改系统端口

GitLab默认会占用80、8080和9090端口，如果服务器上还有tomcat、Jenkins等其他服务，可能会遇到端口冲突。

所以，这一步操作将会修改GitLab的默认端口为11000、11001和11002。

用vim打开gitlab的配置文件：

vim /etc/gitlab/gitlab.rb

找到关键字：external_url 'http://127.0.0.1'

将其内容改为：external_url 'http://:11000'

找到关键字：unicorn['port'] = 8080

将其内容改为：unicorn['port'] = 11001

找到关键字：prometheus['listen_address'] = 'localhost:9090'

将其内容改为：prometheus['listen_address'] = 'localhost:11002'

修改服务端口后，还需要将系统的这些端口进行开放：

# 开放端口11000 11001和11002

/sbin/iptables -I INPUT -p tcp --dport 11000 -j ACCEPT

/sbin/iptables -I INPUT -p tcp --dport 11001 -j ACCEPT

/sbin/iptables -I INPUT -p tcp --dport 11002 -j ACCEPT

2.2 修改邮件设置

应用默认使用postfix，在安装postfix后，再去设置其他的邮箱是没有效果的

2.2.1 使用postfix

执行vim /etc/gitlab/gitlab.rb进入到配置文件，找到关键字Email Settings修改下面的参数:

### Email Settings

gitlab_rails['gitlab_email_enabled'] = true

gitlab_rails['gitlab_email_from'] = 'gitlab@http://'

gitlab_rails['gitlab_email_display_name'] = 'GitLab'

# gitlab_rails['gitlab_email_reply_to'] = '[email protected]'

设置完成后，重配postfix，执行dpkg-reconfigure postfix 或者vi /etc/postfix/main.cf

postfix设置参考

2.2.2 使用其他SMTP邮箱

### Email Settings

gitlab_rails['gitlab_email_enabled'] = true

### GitLab email server settings

###! Docs: https://docs.gitlab.com/omnibus/settings/smtp.html

###! **Use smtp instead of sendmail/postfix.**

gitlab_rails['smtp_enable'] = true

gitlab_rails['smtp_address'] = "smtp.example.com"

gitlab_rails['smtp_port'] = 25

gitlab_rails['smtp_user_name'] = "[email protected]"

gitlab_rails['smtp_password'] = "这里填授权密码"

gitlab_rails['smtp_domain'] = "example.com"

gitlab_rails['smtp_authentication'] = "login"

gitlab_rails['smtp_enable_starttls_auto'] = true

gitlab_rails['smtp_tls'] = true

###! **Can be: 'none', 'peer', 'client_once', 'fail_if_no_peer_cert'**

###! Docs: http://api.rubyonrails.org/classes/ActionMailer/Base.html

gitlab_rails['smtp_openssl_verify_mode'] = 'peer'

user['git_user_email'] = "[email protected]"

gitlab_rails['gitlab_email_from'] = "[email protected]"

完成配置后可以测试下邮箱：

#进入控制台

gitlab-rails console

#发送测试邮件

Notify.test_email('收件人邮箱', '邮件标题', '邮件正文').deliver_now

2.3 其他设置

2.3.1 解决GitLab头像无法正常显示

原因：gravatar被墙

解决办法：

vim /etc/gitlab/gitlab.rb

#gitlab_rails['gravatar_plain_url'] = 'http://gravatar.duoshuo.com/avatar/%{hash}?s=%{size}&d=identicon'

#修改为：

gitlab_rails['gravatar_plain_url'] = 'http://gravatar.duoshuo.com/avatar/%{hash}?s=%{size}&d=identicon'

#然后在命令行执行：

gitlab-ctl reconfigure

gitlab-rake cache:clear RAILS_ENV=production

2.3.2 解决EOFError: end of file reached

vim /etc/gitlab/gitlab.rb

gitlab_rails['smtp_tls'] = false

#修改为：

gitlab_rails['smtp_tls'] = true

gitlab完成配置后，需要执行 gitlab-ctl reconfigure 命令使得配置生效

3. gitlab服务命令

3.1 Service Management Commands

这类命令来管理服务

command

function

start

启动所有服务

stop

关闭所有服务

restart

重启所有服务

status

查看所有服务状态

tail

查看日志信息

service-list

列举所有启动服务

graceful-kill

平稳停止一个服务

举例：

#启动所有服务

[root@localhost gitlab]# gitlab-ctl start

#启动单独一个服务

[root@localhost gitlab]# gitlab-ctl start nginx

#查看日志，查看所有日志

[root@localhost gitlab]# gitlab-ctl tail

#查看具体一个服务的日志,类似tail -f

[root@localhost gitlab]# gitlab-ctl tail nginx

3.2 General Commands

全局命令

command

function

help

帮助

reconfigure

修改配置文件之后，重新加载

show-config

查看所有服务配置文件信息

uninstall

卸载这个软件

cleanse

清空gitlab数据

service-list

列举所有启动服务

graceful-kill

平稳停止一个服务

举例：

#显示所有服务配置文件

[root@localhost gitlab]#gitlab-ctl show-config

#卸载gitlab

[root@localhost gitlab]#gitlab-ctl uninstall

3.3 DatabaseCommands

数据库命令

command

function

pg-upgrade

更新postgresql版本

revert-pg-upgrade

还远先前的(离现在正在使用靠近的版本)一个数据库版本

show-config

查看所有服务配置文件信息

uninstall

卸载这个软件

cleanse

清空gitlab数据

service-list

列举所有启动服务

graceful-kill

平稳停止一个服务

举例：

#升级数据库

[root@localhost gitlab]# gitlab-ctl pg-upgrade

Checking for an omnibus managed postgresql: OK

Checking if we already upgraded: OK

The latest version 9.6.1 is already running,nothing to do

#降级数据库版本

[root@localhost gitlab]# gitlab-ctl revert-pg-upgrade

安装完成后，使用浏览器打开 http://服务器IP/域名:11000进入登陆界面