自己动手搭建GitLab

目录

GitLab概述

为什么要搭建GitLab？

（纯粹是闲的无聊）

软件配置管理工具对比

SVN,GIT,TFS,VSS等等（自行百度-略）

GitLab简介

（自行百度-略）

GitLab安装

安装要求

自行百度，本文是基于虚拟机+centOS 6的GitLab搭建

安装方法

参考GitLab在GitHub上的Wiki页面，详细步骤如下

GitLab环境搭建

1进入服务器
本机装个虚机或申请个部门内网虚机 + CentOS 6
2安装与配置必要的依赖
[参考]https://about.gitlab.com/downloads/

选择select Operation System->CentOS 6(…….Linux 6)，查看相应信息

顺序执行如下命令(附截图)：
[root@localhost /]# sudo yum install openssh-server


[root@localhost /]# sudo yum install postfix


[root@localhost /]# sudo yum install cronie


[root@localhost /]# sudo service postfix start

[root@localhost /]# sudo chkconfig postfix on

[root@localhost /]# sudo lokkit -s http -s ssh

3下载一键安装包并安装
[root@localhost /]#
curl -O https://downloads-packages.s3.amazonaws.com/centos-6.6/gitlab-7.9.0_omnibus.2-1.el6.x86_64.rpm

备注：因为公司网络的原因，上面的一键安装包，可能下载失败，可以通过其他途径，下载后放到服务器根目录后，执行下面的命令
[root@localhost /]# sudo rpm -i gitlab-7.9.0_omnibus.2-1.el6.x86_64.rpm

报错了？啥原因？
推测：可能是因为从windows下载并拷贝rpm到linux，导致rpm包文件大小不一致造成的。
解决：scp命令直接将gitlab-7.9.0_omnibus.2-1.el6.x86_64.rpm文件从A服务器拷贝到B服务器即可。

4配置与启动GitLab
执行下面的命令即可
[root@localhost /]# sudo gitlab-ctl reconfigure
类似如下的信息：
* execute[initialize gitlab-rails database] action nothing (skipped due to action :nothing)
* execute[initialize gitlab-ci database] action nothing (skipped due to action :nothing)
* bash[migrate gitlab-rails database] action nothing (skipped due to action :nothing)
* bash[migrate gitlab-ci database] action nothing (skipped due to action :nothing)
Running handlers:
Running handlers complete
Chef Client finished, 2/160 resources updated in 5.431179057 seconds
gitlab Reconfigured!

5打开浏览器并登录
可以在本地先配置hosts：
比如：XXx.XXX.XXX.XXX localhost（可根据服务器中的域名来配置）
这样在浏览器中直接输入http://localhost来访问GitLab

(1)默认的Administrator的账号和密码
Username: root Password: 5iveL!fe
(2)第一次登录，会自动跳转到修改密码页面，修改成想要的密码即可。
(3)管理员登录后可以修改自己的邮件信息等

修改其他信息的（略）

GitLab集成Idap

备注：如果没有这个文件 /etc/gitlab/gitlab.rb就自己建一个，然后如下操作。
1、修改配置文件 /etc/gitlab/gitlab.rb 修改下面地址为你hostname或ip
external_url = ‘gitlab.test.com’

在/etc/gitlab/gitlab.rb 追加ldap配置，如下：

For omnibus packages

gitlab_rails[‘ldap_enabled’] = true
gitlab_rails[‘ldap_servers’] = YAML.load <<-EOS # remember to close this block with ‘EOS’ below
main: # ‘main’ is the GitLab ‘provider ID’ of this LDAP server
label: ‘LDAP’ ——-à默认，不用动
host: ‘xxx.xxx.xxx.xxx’ ——-à详细咨询部门ops
port: xxx ——-à详细咨询部门ops
uid: ‘sAMAccountName’ ——-à默认，不用动
method: ‘plain’ # “tls” or “ssl” or “plain” ——-à默认，不用动
allow_username_or_email_login: true ——-à默认，不用动
#base: ‘OU=XXXXXXXXX,DC=XXXXXXXXX,DC=com’ ——-à如需配置可咨询部门ops
#bind_dn: ‘CN=gitlibldap,OU=XXXXXXXXX,DC=XXXXXXXXX,DC=com’ –à如需配置可咨询部门ops
#password: ‘密码略’ ——-à之前配置的，有问题
base: ‘DC=xxxxxx,DC=com’ ——-à可咨询部门ops
bind_dn: ‘[email protected]’ ——-à可咨询部门ops
password: ‘密码略’ ——-à可咨询部门ops
#active_directory: true ——-à默认，不用动
user_filter: ” ——-à默认，不用动
EOS ——-à别忘了最后加EOS

2、修改文件gitlab.yml———-就搭建过程来看，第1步完成后，基本不需要修改这个文件
该文件所在路径 /var/opt/gitlab/gitlab-rails/etc/gitlab.yml –à如需修改建议，在这里修改
tips：/home/git/gitlab/config/gitlab.yml –à这个文件无需修改

2. Auth settings

# ==========================
## LDAP settings
ldap:
enabled: true
host: ‘xxx.xxx.xxx.xxx’ ——-à同上
port: xxx ——-à同上
uid: ‘sAMAccountName’
base: ‘DC=xxxxxx,DC=com’ ——-à同上
bind_dn: ‘[email protected]’ ——-à同上
password: ‘密码略’ ——-à同上

3、重新配置与启动GitLap
[root@localhost /]# sudo gitlab-ctl reconfigure
tips：只要修改配置文件就需要重启

4、重新打开页面，见下图：使用域账户登录即可

GitLab的使用说明

（详见next《GitLab的使用说明》有图有真相）

GitLab使用问题汇总

1、可以看到登录界面，但是无法登录提示“retry later或422…..类似信息”
推测：可能配置文件修改后没有reconfigure，可以尝试重新执行：
解决：
[root@localhost /]# sudo gitlab-ctl reconfigure
通常问题就可以解决了！

2、如何在服务器查看GitLap是否正在运行？
[root@localhost config]# sudo gitlab-ctl status
run: logrotate: (pid 29012) 2700s; run: log: (pid 27288) 82266s
run: nginx: (pid 27881) 81901s; run: log: (pid 27257) 82272s
run: postgresql: (pid 27886) 81901s; run: log: (pid 27124) 82300s
run: redis: (pid 27894) 81900s; run: log: (pid 27065) 82306s
run: sidekiq: (pid 28407) 81844s; run: log: (pid 27229) 82278s
run: unicorn: (pid 28455) 81819s; run: log: (pid 27187) 82284s

3、如何在服务器重启GitLap？
[root@localhost config]# sudo gitlab-ctl restart
ok: run: logrotate: (pid 32682) 0s
ok: run: nginx: (pid 32686) 0s
ok: run: postgresql: (pid 32691) 1s
ok: run: redis: (pid 32700) 0s
ok: run: sidekiq: (pid 32706) 1s
ok: run: unicorn: (pid 32711) 0s

4、如果用域账号登录发现有如下问题：

或提示Could not authorize you from Ldapmain because “Missing credentials”
(1)解决修改如下：应该是步骤1中的下面3个配置有误
uid: ‘sAMAccountName’ ——-à默认，不用动
base: ‘DC=xxxxxx,DC=com’ ——-à可咨询部门ops
bind_dn: ‘[email protected]’ ——-à可咨询部门ops
password: ‘密码略’ ——-à可咨询部门ops
(2)重新打开浏览器，用域账号登录即可

5、域账号登录后新建项目，出现如下情况：

问题：如何将git@localhost，改成[email protected]
即访问页面的url从http://localhost/……..修改成http://gitlab.XXXXX.com/………..
(1)解决方法：修改hostname
A、修改/etc/sysconfig/network中的hostname
B、修改/etc/hosts文件
C、重启系统reboot
(2)执行reconfig命令后，重新登录并查看或新建项目
（如果重启系统后，无法访问web页报错503，查看下面的6）

6、服务器重启后，出现web端访问不了的情况：

推测：可能与apache服务启动，相冲突了，
解决：需要杀掉并卸载httpd
[root@gitlab ~]# netstat -tulnp | grep 80 —>找到httpd的pid
[root@gitlab ~]# kill -9 pid —>杀掉httpd
[root@gitlab ~]# yum -y remove httpd —>卸载httpd
卸载之后，应该可以正常登录！

7、如何使用GitLab页面中的SSH keys？
备注：SSH keys是干什么的，自行百度
操作步骤：
(1) 如下图

(2) 如下图（title随便填一个即可，图中写的不用填写，是指默认填充的话，不用填写）

(3) 上图中的key值需要在，本地windows中生成并查找（需要先安装git，自行百度）
打开git bash,执行命令：ssh-keygen -t rsa -C “[email protected]”

会出现类似下面的信息，一路默认enter键即可：

然后，在图中找到 ~/.ssh/id_rsa.pub文件，右键记事本打开查看ssh key内容
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC90olFVGYf7ZkjyAe1eWJ1nTWAlaQMiq0d2Y2k5UdCUr5/rngHd2q86OGM8odwNKdsi1I3YUoACO+jJ6/xCt+CpYk51glC0Sw7+wqHm6llH9+fxG9YdSrfAmGCFsDlkBPrcR+WyDJ1Hi2iAYf5iGl7ANwEfwhJGDIGC9GrAEE1Ji0aS8Q3XkXC5dSEb5yjDF0XUvjN1Zw0Y1JFJABt94fLjDEHgbaCmLckoRqwllp/ROJApFM5jso677/dVXgJY+aHg4nb8Nlmn8mmXEgxNEe8bSNTCTGYNgfy/TCDPCXDbLADtNI8B0qApPDaG+YpM/QQkIODR74iTvRuRQHtw5gt [email protected]
最后复制内容放到(3)中的key输入框中保存即可，详见(4)图
(4) 如下图

(5) 添加成功的话，显示如下图：

(6) 当当SSH keys增加后，无需用户名和密码即可通过本地cmd或git-bush下载或上传代码等，如：


(7) 如果从windows下载的话，其实也可以用tortoise-git工具(类似tortoise-svn，自行百度)
具体的使用详见使用说明文档《GitLab的使用说明.doc》有图有真相

8、当新旧gitlab服务器更换的时候，可能会出现如下问题：“在本机无法clone下来”

这个报错的原因是，我们clone的还是老的服务器配置的域名gitlab.XXXXXX.com
需要OPS协助在后台服务器改这个域名对应的ip地址即可！
同时需要删除本机.ssh/known_hosts文件，重新配置sshkey即可，实现新服务器的git操作！