以前采用gitosis在Mac OS上架设Git服务器,用于集中管理课题组中的所有Git仓库。Gitosis 是一套用来管理 authorized_keys文件和实现简单连接限制的脚本,用来添加用户和设定权限。它并非通过网页程序,而只是管理一个特殊的 Git 仓库。管理员只需在这个特殊仓库内做好相应的设定,然后推送到服务器上,Gitosis 就会随之改变运行策略。
 
Gitosis没有web页面,使用较为复杂。Gitlab是一个用Ruby on Rails开发的开源项目管理程序,可以通过WEB界面进行访问公开的或者私人项目。它和Github有类似的功能,能够浏览源代码,管理缺陷和注释,但github无法免费建立私有仓库。
 
Gitlab在linux下很容易安装,既可以编译源代码安装,也可以通过rpm包或deb包安装,但目前还没有可供Mac OS X安装的软件包,只能编译源代码安装,既复杂又容易出错。因此我们采用Docker来部署Gitlab。
 
Docker是一个开源的引擎,可以轻松的为任何应用创建一个轻量级的、可移植的、自给自足的容器。Docker Hub (https://hub.docker.com) 上提供了很多的容器镜像,可以直接安装使用。
 
基于Docker在Mac OS X系统中的部署和设置GitLab的具体过程如下:
 
1. 安装Docker for Mac (参见https://docs.docker.com/docker-for-mac/install/
 
2. 下载GitLab镜像
     docker pull gitlab/gitlab-ce
 
 
3. 运行GitLab实例
  sudo docker run -d \
    --hostname xxxx.xxxx.xx \
    --name gitlab \
    --restart always \
    --publish 30001:22 --publish 30000:80 --publish 30002:443 \
    --volume $HOME/gitlab/data:/var/opt/gitlab \
    --volume $HOME/gitlab/logs:/var/log/gitlab \
    --volume $HOME/gitlab/config:/etc/gitlab \
    gitlab/gitlab-ce
 
其中volume选项将gitlab的目录挂载为用户当地目录,以免容器在停止或被删除的时候丢失数据。publish选项将宿主机器的30000、30001和30002映射为容器的80(http)、22(ssh)和443(https)端口。
 
4.配置GitLab实例
 
GitLab的配置存储在/etc/gitlab/gitlab.rb文件中。
 
利用命令“sudo docker exec -it gitlab /bin/bash”可以在gitlab容器中进入bash,也可以用命令“sudo docker exec -it gitlab vi /etc/gitlab/gitlab.rb”直接执行vi编辑GitLab配置文件。由于在运行GitLab实例时,已经用volume选项将gitlab的目录挂载为用户当地目录,因此gitlab.rb文件实际位于$HOME/gitlab/config目录下。
 
修改gitlab.rb文件后,在容器中执行命令gitlab-ctl reconfigure重新配置gitlab。
 
4.1 配置GitLab服务器的访问地址
 
4.1.1 配置http协议所使用的访问地址
将external_url修改为GitLab服务器的访问地址:
    external_url 'http://xxxx.xxxx.xxx:30000'
 
由于定义的url中有端口号,需要将nginx监听的端口号改回80,否则nginx将监听容器的30000端口,造成GitLab无法使用:
    nginx['listen_port'] = 80
 
4.1.2 配置ssh协议所使用的访问地址和端口
    gitlab_rails['gitlab_ssh_host'] = ‘data.comdyn.cn'
    gitlab_rails['gitlab_shell_ssh_port'] =30001
 
4.2 配置邮箱
 
为了采用SMTP服务器而不是缺省的Sendmail发送邮件,需要修改gitlab.rb中的内容,
 
下面以网易163邮箱为例配置邮箱:
 
    gitlab_rails['gitlab_email_from'] = "This email address is being protected from spambots. You need JavaScript enabled to view it.
    gitlab_rails['gitlab_email_reply_to'] = ‘This email address is being protected from spambots. You need JavaScript enabled to view it.'
    
    gitlab_rails['smtp_enable'] = true
    gitlab_rails['smtp_address'] = "smtp.163.com"
    gitlab_rails['smtp_port'] = 465
    gitlab_rails['smtp_user_name'] = "This email address is being protected from spambots. You need JavaScript enabled to view it."
    gitlab_rails['smtp_password'] = "xxxxpassword"
    gitlab_rails['smtp_domain'] = "163.com"
    gitlab_rails['smtp_authentication'] = "login"       
    gitlab_rails['smtp_enable_starttls_auto'] = true
    gitlab_rails['smtp_tls'] =true
 
    gitlab_rails['smtp_openssl_verify_mode'] = "peer"
 
最后,用命令docker restart gitlab重启GitLab,或者在容器中执行命令gitlab-ctl reconfigure重新配置gitlab。
 
5. 导入现有的git仓库
 
将现有的git仓库(如test)导入gitlab需要三步:
 
5.1 将已有的所有git仓库的裸库(如test.git)都拷贝到gitlab目录中。
 
前面在运行gitlab实例时,利用volume选项已经将gitlab的数据目录指定为$HOME/gitlab/data/,因此git仓库将存放在目录$HOME/gitlab/data/git-data/repositories/下。
 
gitlab允许创建组,将多个仓库纳入到一个组中,每个组在repositories下面对应于一个与组名称相同的子目录。将所有裸库拷贝到与其组所对应的子目录中。例如,如果要要将test仓库导入到sub组中的话,则应执行:
    sudo cp -r test.gig $HOME/gitlab/data/git-data/repositories/sub/
 
5.2 利用sudo chown命令,将test.git的拥有者的用户名和组名改为和repositories目录的拥有者相同,以保证gitlab可以访问该仓库。
 
5.3 导入仓库
 
在gitlab容器中执行gitlab-rake命令:
    sudo docker exec -it gitlab gitlab-rake gitlab:import:repos['$HOME/gitlab/data/git-data/repositories’]
导入repositories下的所有仓库,并自动创建组。如果某仓库在gitlab中已存在,则会跳过该仓库。
 
6. 升级gitlab
 
由于gitlab的设置、日志和数据都已经保存在用户目录中,升级gitlab时只需停止和删除当前的gitlab实例,再执行第2步和第3步,重新下载gitlab镜像并启动gitlab实例即可。

用户登录