GitLab的安装、配置、使用
前言
上周去参与“中国数字经济创新发展大会”了,然后又忙新项目的事情,博客又有一段时间没有更新,今天周一事情比较少,立刻开始写文,最近有挺多值得记录的东西~
进入正文,最近我们搭了个Gitlab,并且把正在开发的项目代码都迁移到自建的Gitlab上,整个过程还是比较流畅的(就是有点费内存
PS:立即下单给这台服务器买了四条16G内存组四通道~
在此之前,我们团队一直使用Gitee企业版作为代码管理,不过随着网络安全和信息安全管控越来越严格,加之五月份新政策加紧了对国内开源项目的管控,我们还是决定将代码放到一个更加可控的平台上比较好。
在对比了Gitea和Gitlab之后,决定使用Gitlab搭建我们团队自己的代码管理系统。
开始
Gitlab有开源免费的社区版,功能够用,如果后续需要用更多功能还可以换企业版
所以为了方便后续升级,我们选择使用企业版镜像,未激活的情况下与社区版无异,需要升级的话只要购买它的订阅即可平滑升级到企业版。
关于部署方式,云原生时代当然使用Docker~
老规矩,用我最喜欢的compose编排镜像
找一个空间足够大的盘,创建gitlab目录,然后创建docker-compose.yml
文件
配置内容如下
version: "3"
services:
gitlab:
image: gitlab/gitlab-ee:latest
restart: always
hostname: gitlab
ports:
- 1100:80
- 1101:443
- 1102:22
volumes:
- /etc/localtime:/etc/localtime
- ./config:/etc/gitlab
- ./logs:/var/log/gitlab
- ./data:/var/opt/gitlab
具体端口映射规则可以自己定义,volume映射也可以改,但记得第一个/etc/localtime
是固定的,把本机的时间传给gitlab镜像。
保存完在目录下执行docker-compose up
就能跑起来了
首次登录
Gitlab默认管理员用户是root
密码在/etc/gitlab/initial_root_password
文件里
可以进入容器内部查看
优化内存使用
Gitlab吃内存真是名不虚传啊
我们使用的这个服务器是32G内存,在默认配置下一直吃满内存,甚至在使用过程中经常出现各种5xx错误,然后一看剩余内存就几百M……
果然是内存老虎啊~
然后就尝试各种配置,经过几天的摸索,终于把内存占用控制在16G左右
修改配置文件,在Gitlab容器中,这个文件的位置是/etc/gitlab/gitlab.rb
前面我们在docker compose中做了映射,也可以在本机目录下修改./config/gitlab.rb
文件
puma['worker_timeout'] = 30
gitlab_rails['time_zone'] = 'Asia/Shanghai'
puma['worker_processes'] = 2
postgresql['shared_buffers'] = "256MB"
sidekiq['max_concurrency'] = 8
postgresql['max_worker_processes'] = 4
puma['per_worker_max_memory_mb'] = 600
prometheus_monitoring['enable'] = false
sidekiq['min_concurrency'] = 8
修改完要进入容器里执行以下命令之一(重新载入配置或重启gitlab),才能使修改生效
gitlab-ctl reconfigure
gitlab-ctl restart
clone地址
刚运行起来,clone地址是这样的,这不行啊,复制下来没法直接clone到本地,需要配置一下
HTTP的域名配置比较简单,进入menu->admin->settings->general->Visibility and access controls->Custom Git clone URL for HTTP(S)
填入gitlab的网址和端口号并点击保存即可生效
不过HTTP需要登录太麻烦了,我们一般用SSH
SSH地址好像没法在前台配置,需要修改配置文件
依然是前面说的那个配置文件,修改这俩行,分别配置IP地址和端口
gitlab_rails['gitlab_ssh_host'] = 'ssh.域名或IP地址'
gitlab_rails['gitlab_shell_ssh_port'] = 1102
重新载入配置就行了~
external_url配置
这个地址的配置涉及到好几个地方,比如发送的邮件里的跳转链接,代码片段编辑的跳转链接等~
还是在配置文件里修改
找到这一行,# external_url 'GENERATED_EXTERNAL_URL'
去掉前面的#
注释,把URL改成Gitlab的内网地址http://ip:1100
(之前把1100映射到了80端口)
需要注意一点就是Gitlab会根据这里URL的端口来决定提供web服务的端口
所以设置了这个URL的话,要同步修改docker-compose.yml
里的端口映射配置
比如这里设置了1100,那么同步docker-compose.yml
修改为
ports:
- 1100:1100
搞定~
参考资料
- GitLab部署笔记(Docker):https://www.hash070.top/archives/gitlab-withdocker.html
- GitLab最新版限制内存大小puma命令:https://blog.csdn.net/m0_46542378/article/details/125344764
- GitLab修改端口和修改发邮件跳转地址的前缀:https://www.52jingya.com/aid4087