目录
1.账号的创建
2.创建一个项目
3. 设置SSH
4.项目创建新的分支
5.创建一个团队
6.修改管理员密码
7.关闭公开注册
8.管理员添加用户
1.账号的创建
当我们部署好远程的gitlab服务器后,首次访问gitlab,我们需要初始化我们的登录密码
这里密码必须是8位已上,输入完密码之后我们跳转至下一页:
这个是登录注册页面,首先我们进入注册页面注册用户:
注册完成后,页面直接跳转到首页,并显示,注册成功!
2.创建一个项目
这里的操作与github十分类似,我们看:
在这里,我们创建一个名为gitlab-test的项目,如下:
点击确定,此时我们可以看到项目已经被创建好了
到此我们的项目创建就已经结束了
3. 设置SSH
为了方便我们使用git克隆和提交代码,我们这里需要在本地生成git密钥,然后设置到gitlab上去
本地生成git密钥非常简单,这里我就不在赘述,这里主要说的是对gitlab上的配置,同样与github十分类似
1)需要在输入框中输入 SSH key 进行搜索,可以找到如下的界面:
这里我们输入本地生成的密钥,点击确定即可。
2)接下来我们来验证我们创建的项目和生成的密钥是否能支持我们完成项目管理相关的工作
在我们的项目页面我们可以看到我们项目的地址,这里的地址是:git@192.168.58.130:XNN12138/gitlab-test.git
此时项目是空的项目,里面什么都没有,接下来,我们在本地克隆项目
此时,我们在本地对此项目进行更改,我们添加一个gitlabTest.txt文件,并提交
此时我们查看gitlab上的项目状态如下:
4.项目创建新的分支
创建新的分支也非常的容易,我们在上面的界面中可以看到一个master按键
这里我们可以看到这里有一个分支,是我们在提交代码的时候默认创建的master分支
我们点击Branches,可以看到如下的页面
这里我们可以看到我们的所有分支,并对分支进行操作
创建分支dev
我们点击New branch,进入如下页面:
Branch name处写入我们要创建的分支dev,点击Create branch,分支创建ok
此时我们在本地创建一个testdev.txt文件并提交到dev分支
此时我们可以看到dev分支的状态已经更新
点击dev我们可以看到我们提交的代码:
此时,我们创建一个分支并提交代码就结束了
5.创建一个团队
创建一个团队是为了便用我们管理团队项目,并给每一个团队成员分配权限
我们进入分支创建页面:
这里我们创建一个名为group-test的团队,创建完成后,我们可以在这里看到当前的团队信息
这里的项目创建与前面的类似,这里不再赘述,我们重点看团队成员的添加和权限的赋值
这里可以看到我们已经添加了一个名为test的团队吃更远,并赋值权限为开发者(developer)
需要说明的是,我们团队中成员的权限一般分为五种,分别是Guest,Reporter,Developer,Maintainer,Owner
这个不好说明,具体的可以参考http://blog.51cto.com/linuxerxy/1870248中的说明。
6.修改管理员密码
在gitlab服务器上我们输入执行:
gitlab-rails console production
此时,我们需要持续输入如下内容,此时就可以完成管理员的密码的修改
[root@localhost gitlab]# gitlab-rails console production
-------------------------------------------------------------------------------------
GitLab: 11.3.4 (30f019d)
GitLab Shell: 8.3.3
postgresql: 9.6.8
-------------------------------------------------------------------------------------
Loading production environment (Rails 4.2.10)
irb(main):001:0> user = User.where(id: 1).first
=> #<User id:1 @root>
irb(main):002:0> user.password=12345678
=> 12345678
irb(main):003:0> user.password_confirmation=12345678
=> 12345678
irb(main):004:0> user.save!
Enqueued ActionMailer::DeliveryJob (Job ID: 0d69d12f-ba9f-45c8-a1ee-1f137f927cab) to Sidekiq(mailers) with arguments: "DeviseMailer", "password_change", "deliver_now", gid://gitlab/User/1
=> true
irb(main):006:0> quit
此时管理员密码修改结束,从上图可以看出来,我们管理员的用户名称为root,密码修改为12345678
使用管理原账号登录,我们可以看到整个的gitlab的使用情况,例如下面是我们可以看到的所有用户
7.关闭公开注册
gitlab作为一个企业的私服,当然是只想本公司的人使用,而新安装的gitlab默认是所有人都可以注册的,这显然与我们的初衷不一样,这里我们设置一定的权限,用来杜绝不必要的人员注册
1.首先我们需要使用管理员账号登录系统
2.点击图中的按钮(Admin area)
3.点击上图所示的Setting按钮,进入下面的界面进行如下的设置
此时,关闭公共注册就设置结束了
4.邮箱的设置
这时,我们在服务器上进行验证邮箱的设置
我们进入配置文件
cd /etc/gitlab
vi gitlab.rb
进行如下的配置;
配置如下:
gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.163.com"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "xxx@163.com"
gitlab_rails['smtp_password'] = "xxx" //这里输入的是设置邮箱pop3/imap/smtp的校验码
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['gitlab_email_from'] = 'xxx@163.com'
user['git_user_email'] = "xxx@163.com"
设置完成后使配置生效,并重新启动服务
此时我们看到,我们的登录页面已经没有了注册功能,此时,我们只能通过管理员来添加用户
8.管理员添加用户
1)进入users目录下
2)点击New user
3)点击创建用户后跳转下面页面,这里我们可以看到当前用户的一些比较全面的信息
4)这里有两种方式可以获取到用户登录的初始密码,第一种是通过邮件的方式返送连接到上面的email中,另外一种是管理员手动设置初始密码,被添加的用户第一次登录可以使用此密码登录,两中方式设置的密码在第一次登陆的时候都会被要求修改
第一种:发送邮件的方式,只要按上述的要求设置成功,就可以在邮箱中看到这样的激活信息
此时我们点击连接,会进入如下激活页面
设置完成后就可以使用了
这里我们需要注意的几个坑:
1)gitlab.rb中的配置信息一定要核对正确,否则邮件发送不成功,在log中报
WARN: Net::SMTPAuthenticationError: 535 5.7.8 Error: authentication failed错误
2)gitlab中发送邮件的端口在防火墙中必须开放,具体的方式可以参考:
这里面有具体的设置方式(比较靠下,需要耐心找一下)
3)设置的公司邮箱pop3/imap/smtp,必须打开,我之前就是没有设置这个导致报警550,邮件发送一直失败
具体的设置方式是(这里是163邮箱的设置方式,其他邮箱的请自行百度)
在网页上登录自己的邮箱,在下面这个位置可以设置
第二种:点击Users页面需要修改的用户的Eidt按钮
在如下所示的位置可以设置初始的登录密码
到此添加新的用户过程结束