自己动手搭建GitLab

古城微笑少年丶 2022-05-28 03:08 938阅读 0赞

*  5825

## 目录 ##

### GitLab概述 ###

#### 为什么要搭建GitLab？ ####

（纯粹是闲的无聊）

#### 软件配置管理工具对比 ####

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

#### GitLab简介 ####

（自行百度-略）

### GitLab安装 ###

#### 安装要求 ####

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

#### 安装方法 ####

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

### GitLab环境搭建 ###

1进入服务器  
本机装个虚机或申请个部门内网虚机 + CentOS 6  
2安装与配置必要的依赖  
\[参考\][https://about.gitlab.com/downloads/][https_about.gitlab.com_downloads]  
![这里写图片描述][SouthEast]  
选择select Operation System->CentOS 6(…….Linux 6)，查看相应信息  
![这里写图片描述][SouthEast 1]  
顺序执行如下命令(附截图)：  
\[root@localhost /\]\# sudo yum install openssh-server  
![这里写图片描述][SouthEast 2]  
![这里写图片描述][SouthEast 3]  
\[root@localhost /\]\# sudo yum install postfix  
![这里写图片描述][SouthEast 4]  
![这里写图片描述][SouthEast 5]  
\[root@localhost /\]\# sudo yum install cronie  
![这里写图片描述][SouthEast 6]  
![这里写图片描述][SouthEast 7]  
\[root@localhost /\]\# sudo service postfix start  
![这里写图片描述][SouthEast 8]  
\[root@localhost /\]\# sudo chkconfig postfix on  
![这里写图片描述][SouthEast 9]  
\[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][https_downloads-packages.s3.amazonaws.com_centos-6.6_gitlab-7.9.0_omnibus.2-1.el6.x86_64.rpm]  
![这里写图片描述][SouthEast 10]  
备注：因为公司网络的原因，上面的一键安装包，可能下载失败，可以通过其他途径，下载后放到服务器根目录后，执行下面的命令  
\[root@localhost /\]\# sudo rpm -i gitlab-7.9.0\_omnibus.2-1.el6.x86\_64.rpm  
![这里写图片描述][SouthEast 11]  
报错了？啥原因？  
推测：可能是因为从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][http_localhost]来访问GitLab  
![这里写图片描述][SouthEast 12]  
(1)默认的Administrator的账号和密码  
Username: root Password: 5iveL!fe  
(2)第一次登录，会自动跳转到修改密码页面，修改成想要的密码即可。  
(3)管理员登录后可以修改自己的邮件信息等  
![这里写图片描述][SouthEast 13]  
修改其他信息的（略）

### 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: ‘gitlibldap@XXXX.com’ ——-à可咨询部门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: ‘gitlibldap@XXXX.com’ ——-à同上  
password: ‘密码略’ ——-à同上

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

4、重新打开页面，见下图：使用域账户登录即可  
![这里写图片描述][SouthEast 14]

### 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、如果用域账号登录发现有如下问题：  
![这里写图片描述][SouthEast 15]  
或提示Could not authorize you from Ldapmain because “Missing credentials”  
(1)解决修改如下：应该是步骤1中的下面3个配置有误  
uid: ‘sAMAccountName’ ——-à默认，不用动  
base: ‘DC=xxxxxx,DC=com’ ——-à可咨询部门ops  
bind\_dn: ‘gitlibldap@XXXX.com’ ——-à可咨询部门ops  
password: ‘密码略’ ——-à可咨询部门ops  
(2)重新打开浏览器，用域账号登录即可

5、域账号登录后新建项目，出现如下情况：  
![这里写图片描述][SouthEast 16]

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

6、服务器重启后，出现web端访问不了的情况：  
![这里写图片描述][SouthEast 18]  
推测：可能与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) 如下图  
![这里写图片描述][SouthEast 19]  
(2) 如下图（title随便填一个即可，图中写的不用填写，是指默认填充的话，不用填写）  
![这里写图片描述][SouthEast 20]  
(3) 上图中的key值需要在，本地windows中生成并查找（需要先安装git，自行百度）  
打开git bash,执行命令：ssh-keygen -t rsa -C “wangjie@dangdang.com”

会出现类似下面的信息，一路默认enter键即可：  
![这里写图片描述][SouthEast 21]  
然后，在图中找到 ~/.ssh/id\_rsa.pub文件，右键记事本打开查看ssh key内容  
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC90olFVGYf7ZkjyAe1eWJ1nTWAlaQMiq0d2Y2k5UdCUr5/rngHd2q86OGM8odwNKdsi1I3YUoACO+jJ6/xCt+CpYk51glC0Sw7+wqHm6llH9+fxG9YdSrfAmGCFsDlkBPrcR+WyDJ1Hi2iAYf5iGl7ANwEfwhJGDIGC9GrAEE1Ji0aS8Q3XkXC5dSEb5yjDF0XUvjN1Zw0Y1JFJABt94fLjDEHgbaCmLckoRqwllp/ROJApFM5jso677/dVXgJY+aHg4nb8Nlmn8mmXEgxNEe8bSNTCTGYNgfy/TCDPCXDbLADtNI8B0qApPDaG+YpM/QQkIODR74iTvRuRQHtw5gt wangjie@dangdang.com  
最后复制内容放到(3)中的key输入框中保存即可，详见(4)图  
(4) 如下图  
![这里写图片描述][SouthEast 22]

(5) 添加成功的话，显示如下图：  
![这里写图片描述][SouthEast 23]  
(6) 当当SSH keys增加后，无需用户名和密码即可通过本地cmd或git-bush下载或上传代码等，如：  
![这里写图片描述][SouthEast 24]  
![这里写图片描述][SouthEast 25]  
(7) 如果从windows下载的话，其实也可以用tortoise-git工具(类似tortoise-svn，自行百度)  
具体的使用详见使用说明文档《GitLab的使用说明.doc》有图有真相

8、当新旧gitlab服务器更换的时候，可能会出现如下问题：“在本机无法clone下来”  
![这里写图片描述][SouthEast 26]  
这个报错的原因是，我们clone的还是老的服务器配置的域名gitlab.XXXXXX.com  
需要OPS协助在后台服务器改这个域名对应的ip地址即可！

同时需要删除本机.ssh/known\_hosts文件，重新配置sshkey即可，实现新服务器的git操作！

转自：https://blog.csdn.net/langhailove\_2008/article/details/53921130

[https_about.gitlab.com_downloads]: https://about.gitlab.com/downloads/
[SouthEast]: /images/20220528/42a118ce9c2f4991a44602eeaf988fc5.png
[SouthEast 1]: /images/20220528/c8f3410cc15f478bb79162c52f2db540.png
[SouthEast 2]: /images/20220528/cf963b9cb9274e6eb62b0688ab70cb88.png
[SouthEast 3]: /images/20220528/cf9c4e1e33454c8dbc00db1652db6630.png
[SouthEast 4]: /images/20220528/33b61f394639478bb8b4f3de0c22dd23.png
[SouthEast 5]: /images/20220528/e218bd0ee96647fe94a8118bca53566b.png
[SouthEast 6]: /images/20220528/6ee4c5cfb93f4ebf9c7ebd4c79fc10d0.png
[SouthEast 7]: /images/20220528/0b2ed1982f9b476c84bfa01a7af7f07c.png
[SouthEast 8]: /images/20220528/e953c5358c444d47b8a1ed276463829f.png
[SouthEast 9]: /images/20220528/4523fe4fde69411a9b423deed48de642.png
[https_downloads-packages.s3.amazonaws.com_centos-6.6_gitlab-7.9.0_omnibus.2-1.el6.x86_64.rpm]: https://downloads-packages.s3.amazonaws.com/centos-6.6/gitlab-7.9.0_omnibus.2-1.el6.x86_64.rpm
[SouthEast 10]: /images/20220528/3a4c701c05024cc1868e1befcaae3d1d.png
[SouthEast 11]: /images/20220528/a45110c9aeec4421ba51d1707852fbfc.png
[http_localhost]: http://localhost/
[SouthEast 12]: /images/20220528/6459203f828842fcbddc9af3c83a83cf.png
[SouthEast 13]: /images/20220528/0ca5ca58f8824805aa2ea20564c122a0.png
[SouthEast 14]: /images/20220528/a7c250e1527e4a0797040fa49050e383.png
[SouthEast 15]: /images/20220528/f480c407176c49c9bc59d31fbb86f95c.png
[SouthEast 16]: /images/20220528/16c79191998141adb3f5bfebac45c397.png
[SouthEast 17]: /images/20220528/f8d958ea29174708af580bac416e30f7.png
[http_gitlab.XXXXX.com]: http://gitlab.xxxxx.com/
[SouthEast 18]: /images/20220528/8e7588e4a7054882b0292ecf840db048.png
[SouthEast 19]: /images/20220528/5ff9c3a2163d4f15960e814ddf6d04ce.png
[SouthEast 20]: /images/20220528/5ce09544a52a4abd84aa73edd7b9a55e.png
[SouthEast 21]: /images/20220528/0d22e273dc9b4a2182933f61ae6fe358.png
[SouthEast 22]: /images/20220528/748316e7c01d427a99aa2b22156ca639.png
[SouthEast 23]: /images/20220528/be364f86eb254396ad3b4177d8b8744b.png
[SouthEast 24]: /images/20220528/2251378df3c04e87bb50698cca84f97c.png
[SouthEast 25]: /images/20220528/2205de459918483dbeee3a0adb63ab1c.png
[SouthEast 26]: /images/20220528/e60d64ee1aee4cbe84088d857144ccde.png