前言
因为gitHub
上的项目是公开的,不适合公司内部项目放在上面,而私人的需要收费,这绝非是我们愿意的。所以找了个跟gitHub
很相似,但是又免费的gitLab
。现在将搭建gitLab
过程记录一下留作参考。
正文
gitLab介绍
GitLab是利用 Ruby on Rails
一个开源的版本管理系统,实现一个自托管的Git项目仓库,可通过Web界面进行访问公开的或者私人项目。它拥有与Github类似的功能,能够浏览源代码,管理缺陷和注释。可以管理团队对仓库的访问,它非常易于浏览提交过的版本并提供一个文件历史库。团队成员可以利用内置的简单聊天程序(Wall)进行交流。它还提供一个代码片段收集功能可以轻松实现代码复用,便于日后有需要的时候进行查找。
依赖组件:ruby 1.9.3+,MySQL,git,redis, Sidekiq。
最低配置CPU 1G,RAM 1G+swap可以支持100用户。
先连接SSH
首先要确定ubuntu
上安装并且启动了ssh
服务,然后还要确保linux
系统上的防火墙要关闭,win8
的防火墙可以正常开启SSH
(仿真终端工具有PUTTY,SecureCRT 以及Fterm等)可以google
下载的了.
步骤:
1, 有人说首先要在Virtual Network Editor
做NAT
的端口映射,其实是不需要的;
1
|
ps -e|grep ssh
|
如果结果中只有ssh-agent
,那说明ssh-server
还没有启动,一般ubuntu
是默认安装ssh
的,要是没有安装,可以通过
1
|
sudo apt-get install openssh-server
|
安装ssh服务
1
|
sudo /etc/init.d/ssh start
|
启动ssh服务
初始化root密码
ubuntn
刚安装时候root
还没有密码,设置一个,使用命令
1
|
sudo passwd
|
安装gitlib整合包
官方有安装包与脚本下载,官方安装指南。同样GITHUB上有个社区非官方的安装指南。
但这儿里推荐bitnami
下载打包安装版本 https://bitnami.com/stack/gitlab/installer,省去很多时间。他们也提供相关WIKI
以ubuntu为演示环境,来安装这个包,切换到root
账户, 在终端运行:
如果没有权限,先授权账号:
1
|
chmod 777 bitnami-gitlab-8.5.7-0-linux-x64-installer.run
|
然后切换root
用户执行:
1
|
./bitnami-gitlab-8.5.7-0-linux-x64-installer.run
|
启动命令
第一次安装好了就默认启动了gitlab
,如果要手动启动的话有两种办法
1.找到安装好的路径/opt/gitlab-8.5.7-0
需要root
权限执行命令:
1
|
sudo ./ctlscript.sh start
|
登陆系统
启动后,就可以访问系统页面了,这里先通过ifconfig命令获取当前的ip地址
我的是192.168.153.128
,于是就可以在外面window
系统浏览器访问
http://192.168.153.128/users/sign_in
使用我之前配置的git
登陆,我之前安装的时候配置的管理员账号是git
,密码12345678,
这里我登陆后发现跳转到404
页面,把地址http://192.168.153.128/users/sign_in
后面的users/sign_in
删掉回车就行,就去后界面如下:
创建项目前的设置
如果你是自己一个人玩就直接创建项目即可,因为我这边是给团队使用的,所以需要创建一下用户组,以及添加组成员,配置权限等,下面来介绍这些配置
配置服务器邮件
添加人员或者自己注册的时候需要发邮件激活,所以要先配置服务器,我在bitnami
提供的wiki里面找到了办法,原文如下:
How to configure the email settings of GitLab?
You can configure the SMTP settings during the installation process. If you are using the Virtual Machine or AMI, you can configure it manually. For example, these are the options to configure it using a GMail account:
/opt/bitnami/apps/gitlab/htdocs/config/environments/production.rb
1
2
3
4
5
6
7
8
9
10
11
12config.action_mailer.raise_delivery_errors = true
config.action_mailer.delivery_method = :smtp
config.action_mailer.perform_deliveries = true
config.action_mailer.smtp_settings = {
:address => "smtp.gmail.com",
:port => 587,
:domain => "gmail.com",
:authentication => :plain,
:user_name => "your_account@gmail.com",
:,password => "your_password",
:enable_starttls_auto => true
}
简单的说就是修改/opt/bitnami/apps/gitlab/htdocs/config/environments/production.rb
文件,里面的内容,address
,domain
,user_name
,password
这几个配置成你自己的邮箱,记得你的邮箱必须要支持smtp
。port
端口我默认也是587,不需要修改。
配置好了邮箱,就要测试一下,我们在http://192.168.153.128/users/sign_in
首页,注册一个额用户,然后我收到邮件激活,然后就可以登陆系统了。
可以看到,非管理员登陆右上角就没有Admin Area
功能
创建小组,添加组内成员
让组内成员自己注册账号激活后,我们就准备创建小组了,创建小组是为了方便管理,创建项目的时候直接指定小组,这样小组内的成员都可以看到项目
新增项目
小组创建好了就可以新增一个项目了,这里创建的时候选择edw
这个创建好的小组,并且项目宣称private
私有项目。这样只有小组内的成员可以下载这个项目
配置SSH key
这里切换到tengj
用户登陆,发现已经有了springmvctouchbaidu
项目
但是要下载到本地还需要配置SSH key
,复制我们本地.sshid_rsa.pub
的内容黏贴到下面图中指定的即可。
远程下载项目
这里模拟tengj
下载远程项目,在这之前我已经用管理员账号把项目传上去了,如图
指定一个目录存放该项目,执行git clone
命令:
1
|
$ git clone git@192.168.153.128:edw/springmvctouchbaidu.git
|
搞定,下载下来了。
配置权限
前面文章也说过,一般一个实际项目中master
用来版本发布,一般不在这个分支上开发,所以除了git
管理员用户可以提交代码到master
外,其他组成员只能push
代码到dev
这个分支。
比如我添加tengj
用户的时候选择的是Developer
角色,只要在Protected Branches
中这个勾不够上就行了。这样开发人员就无法push
代码到master
分支上。
下面模拟一下tengj用户提交代码:
总结
ok,花了三天时间终于搞定了,截图还是蛮累人的哈哈,算是比较详细的记录了我这次安装gitlab
的过程,个人感觉比网络上的文章调理清晰多了。一开始查资料快累死了。希望对你有所帮助。