安装
# 安装依赖包 sudo yum install -y curl policycoreutils-python openssh-server # 启用并启动SSHD sudo systemctl enable sshd sudo systemctl start sshd # 在防火墙上永久允许HTTP,并重启防火墙 sudo firewall-cmd --permanent --add-service=http sudo systemctl reload firewalld
安装Postfix来发送通知邮件,当然也可以使用其他SMTP服务器来发送邮件
下载GitLab的RPM包进行安装,下载地址 我这里下载的是CE版本,EE是企业版收费的。
我这里用7
我这里用第一种方法
修改/etc/gitlab/gitlab.rb配置文件
另外把在DNS上配置这个域名指向这个IP,或者修改你自己机器的本地HOST文件。这里的配置是说外部访问GitLab通过哪个域名来访问。启动gitlab
# 这个命令是对GitLab以及其包含的所有组件生效的,也就是重启、停止、启动和重新配置
# reconfigure 的意思是重新配置,每次修改配置文件后需要运行,然后运行restart
gitlab-ctl stop|start|restart|reconfigure
# 查看当前运行状态
gitlab-ctl status
可以看到除了GitLab之外还有很多独立组件,这都是安装包一起安装的。这些独立组件也可以进行启动或者关闭。具体看官方文档
登录
默认用户名是root,第一次登录需要重置密码
默认会安装的组件:
- Nginx 提供代理服务
- Redis 存储用户登录会话,默认会话永不过期
配置
/etc/gitlab/gitlab.rb | 主配置文件 |
/var/log/gitlab/ | 日志目录 |
/var/opt/gitlab/ | 各个服务的主目录 |
/var/opt/gitlab/git-data/repositories | GIT仓库数据目录 |
修改默认仓库数据存储位置
# 建立目录并修改目录权限 mkdir –p /data/git-data chown git:root /data chown git:root /data/git-data chmod 700 /data chmod 700 /data/git-data
修改配置文件
修改后要运行如下命令:
gitlab-ctl reconfigure
gitlab-ctl restart
原来的目录有数据,那么你修改了存储位置还需要做如下操作
主要就是把原来的数据移动过来,同时修复权限问题。如果是同一台机器可以使用cp –rp复制并保留权限。因为我们这里是新建的所以不存在这样的问题。我们建立一个项目看看数据会放到哪里?
用户和组的管理
默认情况下omnibus-gitlab管理用户和组,有些时候我们需要使用外部的系统来管理用户和组比如通过LDAP,成熟的产品有OpenLDAP以及微软的活动目录,如果我们要引入外部的用户和组的管理就需要禁用gitlab的用户管理功能。
自带用户管理功能
创建组
创建用户
添加用户到组
这里要选择用户以及给予这个用户的项目角色,角色和权限相关,一般开发人员就使用【Developer】角色就行。
与Active Directory服务基础使用外部用户管理
微软的AD服务中使用的就是LDAP,当然使用Linux系统的LDAP也可以,只是微软的AD对于用户管理非常方便。我个人觉得不要迷恋开源非开源的也有很多好东西。
首先需要有一台活动目录服务器(安装略)
其次禁用GitLab的用户和组的管理
配置与AD的LADP协议集成
活动目录结构是这样的,所有用户都在Company这个OU下面,在这个OU下面建立不同的OU。
下面的配置是YAML格式的,格式一定要正确,否则会报错。
下面还有一个Secondary,这个是GitLab企业版支持的功能也就是配置两个LDAP服务器,社区版只能用一个。
配置完运行
gitlab-ctl reconfigure
检查是否可以读取LDAP信息,运行
gitlab-rake gitlab:ldap:check
最后重启GitLab,再次打开登录页面
输入用户名域账号wangtao和密码点击登录
关于bind_dn的说明:这个是说你用哪个账号来绑定,如何查找账号请看下图。这个我这里用的是默认的域管理员,你可以用其他的只要权限够就可以。
关于uid的说明:这里面有两种一个是cn;一个是sAMAccountName,有什么区别呢?如果你的域用户都是英文名称那用哪一个都一样,但是如果大部分人都是中文个别外国人是英文,那还是用sAMAccountName。我们来看看这2个名称是什么,通过AD编辑器查看对象属性。
Cn是中文的,而sAMAccountName是英文的,再看下图AD用户和计算机中的用户属性,显示名是中文的,而登陆用的名称时英文的。所以你会看到如果是中文的这两个名字有区别,所以你要配置成sAMAccountName,否则你会无法登陆。
关于base的说明:这里是说从AD中的那个节点开始查找用户,当然你可以设置从AD的根上开始查找,但是这样没有意义,我这里就是设置从存放员工账号的节点开始查找。
关于allow_username_or_email_login的说明:含义是是否启用用户名或者邮件地址登陆,建议不启用。因为我们继承AD通常是使用userPrincipalName登陆,也就是下面红框里面的格式,它的确看起来是邮件地址的格式,但是如果allow_username_or_email_login禁用,那么GitLab会把整个输入当做用户名包括@,如果你启用这个选择,那么GitLab会截断@后面的,导致你使用userPrincipalName这种名称无法登陆。
其他配置说明:
- active_directory:如果你的LDAP服务器是活动目录,那么就配置成true
- timeout:查询LDAP服务的超时时长
- block_auto_created_users:这个不太明白,官方文档说这个作用是严格控制GitLab安装中的活跃用户数量,启用该选项新用户则会被阻止,直到管理员处理。
禁用用户注册
既然通过AD管理用户那就没必要开启用户注册功能
再次打开页面就没有注册标签了
上面说的一些概念在Linux的LDAP中也适用。
参考文档:
https://docs.gitlab.com/omnibus/settings/ldap.html
https://docs.gitlab.com/ee/administration/auth/ldap.html
存储和目录管理
默认路径 | 权限 | 属组属主 | 作用 |
/var/opt/gitlab/git-data | 0700 | git:root | 仓库目录 |
/var/opt/gitlab/git-data/repositories | 2700 | git:root | Git仓库 |
/var/opt/gitlab/gitlab-rails/shared | 0751 | git:gitlab-www | 大对象目录 |
/var/opt/gitlab/gitlab-rails/shared/artifacts | 0700 | git:root | 持续集成目录 |
/var/opt/gitlab/gitlab-rails/shared/lfs-objects | 0700 | git:root | LFS对象 |
/var/opt/gitlab/gitlab-rails/uploads | 0700 | git:root | 用户上传附件目录 |
/var/opt/gitlab/gitlab-rails/shared/pages | 0750 | git:gitlab-www | 用户站点页面 |
/var/opt/gitlab/gitlab-ci/builds | 0700 | git:root | 持续集成构建日志路径 |
/var/opt/gitlab/.ssh | 0700 | git:root | 验证KEYS |
上面这些目录是在omnibus-gitlab包安装的时候自动建立的,有些目录会保存较大的数据,通常这些目录我们会单独挂载到一个分区中比如NFS或者其他地方。我们可以通过在配置文件中搜索路径来修改。
日志查看
日志可以通过命令查看而不需要到日志目录中
# 查看所有日志 gitlab-ctl tail # 查看NGINX的访问日志 gitlab-ctl tail nginx/gitlab_access.log
https://docs.gitlab.com/omnibus/settings/logs.html
启用SSL
默认没有启用SSL,你需要启用SSL并提供证书文件,然后修改NGINX配置。我们这里建立一个自签名证书。
建立证书目录并把证书拷贝过去
把这里改成https
配置证书路径,开启重定向。默认情况下如果你只修改了上面的,那么NGINX将不会监听80端口,这样你访问80端口的网站就失败,所以这里要开启重定向功能。
更新配置
gitlab-ctl reconfigure
如果开启了防火墙需要新增下面的规则
再次登录
虽然是不信任但是已经应用了证书,实际工作中我们肯定是去公共的机构去申请证书。过程就是这样,我这里为了方便又禁用了SSL,因为不信任的证书很不方便。