GitLab 提供了两种方式来安装,一种是使用官方打包好的文件,这种方法比较简单,也不容易出错;另一种是手动安装,就是把代码下载下来,然后安装各种环境,数据库,编译环境等等,一步一步安装起来,这种就比较麻烦,但是可以安装各种分支版本,比如中文翻译版。
先介绍下自己的环境,是在虚拟机中安装的:
Ununtu 14.04,GitLab 7.4.2 Community Edition
一、使用官方安装包安装
官方安装文档
https://about.gitlab.com/downloads/
1. 下载gitlab安装包
https://downloads-packages.s3.amazonaws.com/ubuntu-14.04/gitlab_7.4.2-omnibus-1_amd64.deb
官方文档使用wget,但是这个文件有280MB,还是用迅雷先下载好,速度比较快。
2. 安装 openssh-server
sudo apt-get install openssh-server
3. 安装邮件服务器
sudo apt-get install postfix
这里选择Internet Site
然后让设置FQDN,但是使用默认的机器名即可,这里不是很确定。
4. 安装gitlab安装包
sudo dpkg -i gitlab_7.4.2-omnibus-1_amd64.deb
安装完之后,会建立一个git用户和一个gitlab-www用户,在GitLab上建立的代码仓库都是放在/home/git/下面。但是奇怪的是,该目录竟然对当前登录的管理员用户不可见,需要用git用户登录才可以,而且git用户还不能登录到图形窗口,只能登录到命令行。由于git用户建立时使用了--disabled-login,需要先设置密码才能登录,可以用passwd git,修改git用户的密码。
5. 配置 gitlab
这一步在官方的文档里面没有,但是如果没有配置的话,直接启动GitLab,会出现不正确的FQDN错误,导致无法正常启动。因此必须做配置。
这边的配置使用这里分享的经验。
sudo mkdir -p /etc/gitlab
sudo touch /etc/gitlab/gitlab.rb
sudo chmod 600 /etc/gitlab/gitlab.rb
sudo gedit /etc/gitlab/gitlab.rb
把'${external_url}'改成部署机器的域名或者IP地址
这个地址很重要,上传的图片什么的,url会以这个为基准,如果地址写错,将无法访问到图片等这些资源。
6. 然后对GitLab进行重配置即可
这一步也是启动 GitLab
sudo gitlab-ctl reconfigure
7. 打开浏览器登陆
Username: root
Password: 5iveL!fe
第一次启动的时候,需要初始化大量的东西,经常会出现502错误,通常是由于内存不足的原因导致,所以需要准备好足够的内存。官方推荐生产环境中使用2G内存,2核CPU。虚拟机中测试1GB内存基本就可以了。