GitLab使用
目录
实验环境
1台centos7.6虚机
gitlab/gitlab-ce:15.0.3-ce.0
实验软件(无)
1、GitLab组织配置
1.Namespaces 名称空间
不同namespace的项目,其url是不一样的。
用户自己有一个默认的namespace的:
2.Members成员
gitlab里的权限一般会和ldap做集成的。
这里是有很多role可以去选择的:
3.Groups组管理
之前在删除某个gitlab离职用户后,他的项目也被删除了。因此,创建项目一般建议都放置在组里;
2、GitLab项目管理
配置group名称最好与项目组有关的,例如业务的简称等等。项目组的类型分为 Private、Internal、Public三种类型。
- Private 私有类型(当group为私有类型,后面组下面的项目都是私有类型)
- Public 公开类型
创建组
生成代码
来到https://start.spring.io网站,初始化一个springboot项目:
生成项目代码:
下载项目代码:
创建项目
在这个页面可以创建一个空的项目、根据一个模板创建项目、导入一个已存在的项目(Gitlab、GitHub等系统)
创建项目:
创建一个叫做devops-demo-service
私有类型项目
将项目代码推送到刚创建的项目里
- 我们看下刚才创建的项目代码
将demo.zip
解压,能看到这个demo目录只是一个纯目录,而不是git仓库
- 利用刚才创建目录后的提示,将demo内容推送到新创建的项目里去
cd existing_folder
git init --initial-branch=main #这里注意下,git的这个--initial-branch参数需要git高一点的版本,否则会报错。
git remote add origin http://172.29.9.101:8076/devops6/devops-demo-service.git
git add .
git commit -m "Initial commit"
git push -u origin main
推送过程:
这里注意下,git的这个–initial-branch参数需要git高一点的版本,否则会报错。
当前git版本:
但是,这里也可以使用其它方式来实现这个效果:
执行过程如下:
注意:自己pc上已经有了这个签名配置了,这里就不再重新配置了哦。
cd demo
git init
git checkout -b main
git remote add origin http://172.29.9.101:8076/devops6/devops-demo-service.git
git add .
git commit -m "Initial commit"
git push -u origin main
来到项目这里,发现已经可以看见代码了:
这边我们再推送一个README.md
文件到仓库:
Win@DESKTOP-VUMV922 MINGW64 ~/Desktop/demo (main)
$ echo devops6 > README.md
Win@DESKTOP-VUMV922 MINGW64 ~/Desktop/demo (main)
$ git add .
warning: in the working copy of 'README.md', LF will be replaced by CRLF the next time Git touches it
Win@DESKTOP-VUMV922 MINGW64 ~/Desktop/demo (main)
$ git commit -m "add Readme"
[main 5617ddd] add Readme
1 file changed, 1 insertion(+)
create mode 100644 README.md
Win@DESKTOP-VUMV922 MINGW64 ~/Desktop/demo (main)
$ git push
Enumerating objects: 4, done.
Counting objects: 100% (4/4), done.
Delta compression using up to 8 threads
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 273 bytes | 273.00 KiB/s, done.
Total 3 (delta 1), reused 0 (delta 0), pack-reused 0
To http://172.29.9.101:8076/devops6/devops-demo-service.git
52558bc..5617ddd main -> main
Win@DESKTOP-VUMV922 MINGW64 ~/Desktop/demo (main)
到项目上确认下:(符合预期)
创建特性分支
为什么要拉取分支? 一个分支不够吗? 一般我们使用 master
主干分支存放最新的能够发布生产的代码,而单独创建一些特性分支来做项目需求任务的开发分支。 这样的好处是防止主干分支污染,对分支起到了保护的作用。
下面进入 devops-demo-service
项目主页,然后基于主干分支master,创建特性分支feature-dev-01。操作如下:
特性分支开发与提交
查看当前本地分支,发现没有刚刚远程创建的 feature-dev-01
分支。
Win@DESKTOP-VUMV922 MINGW64 ~/Desktop/demo (main)
$ git branch -a
* main
remotes/origin/main
Win@DESKTOP-VUMV922 MINGW64 ~/Desktop/demo (main)
$
git pull
同步远程仓库所做的更新到本地, 这样远程的feature-dev-01分支就同步到了本地。然后我们使用 git checkout feature-dev-01切换到特性分支。
Win@DESKTOP-VUMV922 MINGW64 ~/Desktop/demo (main)
$ git pull
From http://172.29.9.101:8076/devops6/devops-demo-service
* [new branch] feature-dev-01 -> origin/feature-dev-01
Already up to date.
Win@DESKTOP-VUMV922 MINGW64 ~/Desktop/demo (main)
$ git branch -a
* main
remotes/origin/feature-dev-01
remotes/origin/main
Win@DESKTOP-VUMV922 MINGW64 ~/Desktop/demo (main)
$ git checkout feature-dev-01
Switched to a new branch 'feature-dev-01'
branch 'feature-dev-01' set up to track 'origin/feature-dev-01'.
Win@DESKTOP-VUMV922 MINGW64 ~/Desktop/demo (feature-dev-01)
$
我们更改下README.md文件内容,然后将更改内容提交到远程仓库。
Win@DESKTOP-VUMV922 MINGW64 ~/Desktop/demo (feature-dev-01)
$ echo 情出自愿-事过无悔 > README.md
Win@DESKTOP-VUMV922 MINGW64 ~/Desktop/demo (feature-dev-01)
$ git add .
warning: in the working copy of 'README.md', LF will be replaced by CRLF the next time Git touches it
Win@DESKTOP-VUMV922 MINGW64 ~/Desktop/demo (feature-dev-01)
$ git commit -m "modify README.md"
[feature-dev-01 7cf5639] modify README.md
1 file changed, 1 insertion(+), 1 deletion(-)
Win@DESKTOP-VUMV922 MINGW64 ~/Desktop/demo (feature-dev-01)
$ git push origin feature-dev-01
Enumerating objects: 5, done.
Counting objects: 100% (5/5), done.
Delta compression using up to 8 threads
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 294 bytes | 294.00 KiB/s, done.
Total 3 (delta 1), reused 0 (delta 0), pack-reused 0
remote:
remote: To create a merge request for feature-dev-01, visit:
remote: http://172.29.9.101:8076/devops6/devops-demo-service/-/merge_requests/new?merge_request%5Bsource_branch%5D=feature-dev-01
remote:
To http://172.29.9.101:8076/devops6/devops-demo-service.git
5617ddd..7cf5639 feature-dev-01 -> feature-dev-01
我们来到gitlab项目页面,刷新下:
这样我们就把本地的特性分支开发的代码提交到了远程特性分支中了, 接下来对应该对该特性分支进行测试验证,没问题后合并到主干分支。
特性分支合并操作
将特性分支 feature-dev-01 代码合并到主干分支main Merge Request。
在这个页面,选择源分支和目标分支。
在这个页面:
- 1 指定合并请求的标题
- 2 描述信息,一般都是变更信息
- 3 指定主管进行审核(最终该用户决定是否合并)
- 4 指定进行代码审查的同事
- 5 合并成功后删除源分支(最后很定要删除源分支,可以先保留一个版本后再删除,此处最好取消勾选)
交合并后,由管理员审查进行合并。
合并后的效果: 特性分支的更改已经同步到了主干分支。
到此一个基本的项目开发提交代码过程就已经完成了。(多熟悉一下这个过程)
分支策略管理最佳实践
还是要避免一个情况,防止main分支被污染。
最佳实践:特性分支开发,版本分支发布
。
案例:
接着继续以main分支创建2个特性分支:feature-dev-02
,feature-dev-03
以main分支创建1个版本分支:RELEASE-1.1.1
此时,在gitlab web ide里修改特性分支feature-dev-02/03
里的代码并提交。
然后,将2个特性分支代码feature-dev-02/03
提交合并到版本分支RELEASE-1.1.1
里
此时,版本分支经过dev-stag-prod
环境测试无问题后,就打上一个tag,然后合并到主干分支中去。
确认生产发布成功了,这个时候,你打上一个tag。
验证:
3、GitLab用户管理
gitlab重置用户密码
(测试成功)-2022.5.13
1、web界面方式
2、控制台方式
gitlab版本:gitlab/gitlab-ce:14.9.3-ce.0
👉🏼 忘记密码情况下
[root@devops ~]#docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
11a54a1f4a2a gitlab/gitlab-ce:14.9.3-ce.0 "/assets/wrapper" 6 days ago Up 44 hours (healthy) 0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp, 0.0.0.0:2222->22/tcp devops_tutorial_gitlab
f3f039aa667a jenkins/jenkins:2.332.2-centos7-jdk8 "/sbin/tini -- /usr/…" 4 weeks ago Up 41 hours 0.0.0.0:8080->8080/tcp, :::8080->8080/tcp, 0.0.0.0:50000->50000/tcp, :::50000->50000/tcp jenkins
[root@devops ~]#docker exec -it devops_tutorial_gitlab bash
root@11a54a1f4a2a:/# gitlab-rails console -e production
--------------------------------------------------------------------------------
Ruby: ruby 2.7.5p203 (2021-11-24 revision f69aeb8314) [x86_64-linux]
GitLab: 14.9.3 (ec11aba56f1) FOSS
GitLab Shell: 13.24.0
PostgreSQL: 12.7
------------------------------------------------------------[ booted in 73.71s ]
Loading production environment (Rails 6.1.4.6)
irb(main):001:0>
irb(main):002:0> User.all
=> #<ActiveRecord::Relation [#<User id:1 @root>]>
irb(main):003:0> user = User.where(id:1).first
=> #<User id:1 @root>
irb(main):004:0> user.password='12345678'
=> "12345678"
irb(main):005:0> user.password_confirmation='12345678'
=> "12345678"
irb(main):006:0> user.save!
=> true
irb(main):007:0> exit
root@11a54a1f4a2a:/#
# 修改完后,立马生效!
以上亲测有效!
4、GitLab系统管理
1.版本更新
- rpm : rpm -Uvh
- docker: 替换新版本镜像
注意跨版本升级需要先升级到当前版本的最后一个版本。
gitlab升级时,高可用,不太好保证,这里用一套蓝环境,一套绿环境,同时只有一套在线;
Gitlab有自己的备份配置,开起来就好了;
2.WebHook触发器
进入GitLab项目设置, 进入 webhook
配置页面;
- 配置要触发的URL,即Jenkins触发器接口URL;
- 选择发生哪种GitLab事件后触发此Webhook;例如:Push提交代码、Tag创建标签等等;
事件:
- Push 提交事件
- Tag Push 创建事件
- MergeRequest 合并事件
- Issue 问题创建更新事件
这里先随便写一个url http:/192.168.1.200:8080/generic-webhook-trigger/invoke?token=devops03-demo-service
,用于测试。
添加webhook后,发现报以下错误:
解决方法:进入admin管理页面设置 > network
找到"Outbound requests"勾选允许请求webhooks和服务。(更改后,重启触发即可)保存配置。
再次添加webhook后,发现就可以正常添加了:
测试模拟触发
模拟事件触发,点击test按钮选择push事件,此时去看下Jenkins是否成功被触发
触发成功则提示: Hook executed successfully: HTTP 200, 此时可以看下Jenkins是否已经触发了一次构建;
Webhook问题排查调试
进入webhook添加页面的最下方,点击你所创建的webhook的 Edit
按钮 ;
webhook历史记录: 此记录可以判断,当前动作提交是否产生了webhook。
点击 View details
可以看到此webhook发送给对端Jenkins的数据信息,和请求状态。
- 200: 表示触发Jenkins请求成功;
- Resend Request: 重新发送请求;(此处便于排查调试错误)
- RequestBody: GitLab传递给Jenkins的数据信息;
如果Jenkins触发成功了之后,我们可以在Jenkins的构建日志中查看效果。 这些数据就是gitlab post传递过来的。
到此:你基本上已经知道了Gitlab如何触发Jenkins的了。(多看几遍,多练习几遍)
本次自己测试效果:
3. 邮件通知配置
次部分,本次未测试,仅做记录。之前gitlab实验时有用到过次配置。
编辑/etc/gitlab/gitlab.rb文件开启gitlab email。这里以QQ邮箱为例
### GitLab email server settings
###! Docs: https://docs.gitlab.com/omnibus/settings/smtp.html
###! **Use smtp instead of sendmail/postfix.**
gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.qq.com"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "2560350642@qq.com"
gitlab_rails['smtp_password'] = "exngzyvnggekjdgwecga"
gitlab_rails['smtp_domain'] = "smtp.qq.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = true
### Email Settings
gitlab_rails['gitlab_email_enabled'] = true
gitlab_rails['gitlab_email_from'] = '2560350642@qq.com'
gitlab_rails['gitlab_email_display_name'] = 'GitLab Admin'
重新配置
gitlab-ctl stop ;
gitlab-ctl reconfigure ;
gitlab-ctl start gitlab-ctl status
登录gitlab-rails控制台,发送测试邮件。
su - git
gitlab-rails console
irb(main):002:0> Notify.test_email('2560350642@qq.com', 'test email', 'gitlab email test').deliver_now
Notify#test_email: processed outbound mail in 0.5ms
Delivered mail 5eba1b04de4e5_12903fe2ca0c79b0519ec@gitlab-995f97976-2nmb4.mail (1055.9ms)
Date: Tue, 12 May 2020 03:41:56 +0000
From: GitLab Admin <2560350642@qq.com>
Reply-To: GitLab Admin <noreply@192.168.1.200>
To: 2560350642@qq.com
Message-ID: <5eba1b04de4e5_12903fe2ca0c79b0519ec@gitlab-995f97976-2nmb4.mail>
Subject: Message Subject
Mime-Version: 1.0
Content-Type: text/html;
charset=UTF-8
Content-Transfer-Encoding: 7bit
Auto-Submitted: auto-generated
X-Auto-Response-Suppress: All
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
<html><body><p>Message Body And Linuxea.com</p></body></html>
=> #<Mail::Message:70243016426420, Multipart: false, Headers: <Date: Tue, 12 May 2020 03:41:56 +0000>, <From: GitLab Admin <2560350642@qq.com>>, <Reply-To: GitLab Admin <noreply@192.168.1.200>>, <To: 2560350642@qq.com>, <Message-ID: <5eba1b04de4e5_12903fe2ca0c79b0519ec@gitlab-995f97976-2nmb4.mail>>, <Subject: Message Subject>, <Mime-Version: 1.0>, <Content-Type: text/html; charset=UTF-8>, <Content-Transfer-Encoding: 7bit>, <Auto-Submitted: auto-generated>, <X-Auto-Response-Suppress: All>>
测试邮件:
关于我
我的博客主旨:
- 排版美观,语言精炼;
- 文档即手册,步骤明细,拒绝埋坑,提供源码;
- 本人实战文档都是亲测成功的,各位小伙伴在实际操作过程中如有什么疑问,可随时联系本人帮您解决问题,让我们一起进步!
🍀 微信二维码
x2675263825 (舍得), qq:2675263825。
🍀 微信公众号
《云原生架构师实战》
🍀 语雀
https://www.yuque.com/xyy-onlyone
🍀 csdn
https://blog.csdn.net/weixin_39246554?spm=1010.2135.3001.5421
🍀 知乎
https://www.zhihu.com/people/foryouone
最后
好了,关于本次就到这里了,感谢大家阅读,最后祝大家生活快乐,每天都过的有意义哦,我们下期见!