目录
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: ‘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 --à这个文件无需修改 - 3、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: ‘密码略’ -------à同上
- 4、重新配置与启动GitLap
[root@localhost /]# sudo gitlab-ctl reconfigure
tips:只要修改配置文件就需要重启
- 5、重新打开页面,见下图:使用域账户登录即可
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: ‘gitlibldap@XXXX.com’ -------à可咨询部门ops
password: ‘密码略’ -------à可咨询部门ops
- (2)重新打开浏览器,用域账号登录即可
- 5、域账号登录后新建项目,出现如下情况:
问题:如何将git@localhost,改成gitlab@XXXXX.com
即访问页面的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 “wangjie@dangdang.com”
会出现类似下面的信息,一路默认enter键即可:然后,在图中找到 ~/.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) 如下图
- (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操作!