开启GitLab的邮件通知功能以及一些外观配置
前言
维护GitLab的同事离职了
刚好又有新实习生需要申请账号
只能我来出手了
其实之前安装了 GitLab 之后一直还是用得比较粗糙的
属于是勉强能用的水平，有些配置都还没改好
这次把邮件功能、域名、外观啥的配置好了，写篇文章记录一下
目录结构
先来回顾一下 GitLab 的目录结构
我们的 GitLab 是使用 docker 部署的
gitlab
├── config
├── data
├── logs
├── shell
└── docker-compose.yml
具体的目录结构也是看具体的配置
本文就以这个目录结构为例，进行具体的配置
配置邮件功能
修改 config/gitlab.rb 文件
话说 GitLab 居然是 ruby 写的？（难怪觉得卡卡的）
编辑邮件配置这一块
这里以腾讯企业邮箱为例
gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.exmail.qq.com"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "gitlab@codelab.com"
gitlab_rails['smtp_password'] = "email-password"
gitlab_rails['smtp_domain'] = "smtp.exmail.qq.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = false
gitlab_rails['smtp_tls'] = false
gitlab_rails['smtp_ssl'] = true
gitlab_rails['smtp_pool'] = false
gitlab_rails['gitlab_email_from'] = "gitlab@codelab.com"
保存与加载配置
配置完成保存一下
进入 GitLab 容器
docker compose exec gitlab bash
执行命令
gitlab-ctl reconfigure
gitlab-ctl restart
搞定
额外邮件配置
对了，还有个额外配置可以改一下，我这里就只修改了 gitlab_email_from 其他的有需要的同学可以改一下
### Email Settings
# gitlab_rails['gitlab_email_enabled'] = true
##! If your SMTP server does not like the default 'From: gitlab@gitlab.example.com'
##! can change the 'From' with this setting.
gitlab_rails['gitlab_email_from'] = 'example@example.com'
gitlab_rails['gitlab_email_display_name'] = 'Example'
gitlab_rails['gitlab_email_reply_to'] = 'noreply@example.com'
gitlab_rails['gitlab_email_subject_suffix'] = ''
gitlab_rails['gitlab_email_smime_enabled'] = false
gitlab_rails['gitlab_email_smime_key_file'] = '/etc/gitlab/ssl/gitlab_smime.key'
gitlab_rails['gitlab_email_smime_cert_file'] = '/etc/gitlab/ssl/gitlab_smime.crt'
gitlab_rails['gitlab_email_smime_ca_certs_file'] = '/etc/gitlab/ssl/gitlab_smime_cas.crt'
发送测试邮件
我用的方法是进入 ruby console 手动发送
在 GitLab 实例的前台页面没找到有什么测试发送的地方
首先进入 GitLab 容器的 shell
docker compose exec gitlab bash
之后启动 ruby console
gitlab-rails console
输入命令发邮件
Notify.test_email('your-email@example.com', 'Test Email', 'This is a test email.').deliver_now
这个方法很好，如果有哪里配置错了，也可以从报错信息里直观的看到
几个跟邮件有关的功能
- 登录到你的 GitLab 实例。
- 进入
Admin Area（管理员区域）。 - 导航到
Settings>Integrations。
这个页面的中文应该是“实例级集成管理”，我这个版本的 GitLab 有俩跟邮件有关的，分别是：
- 推送时发送电子邮件
- 流水线状态电子邮件
顾名思义，前面邮箱配置好了就可以启用这俩
之后满足条件就可以在指定邮箱接收到通知邮件了
重新使用 swag 来分配域名+https
在之前那篇GitLab安装的文章里，我是直接把几个端口都映射出来
现在改成swag做反代，需要修改一下几个地方
例如要分配给 GitLab 的域名是 gitlab.dealiaxy.com
首先修改 docker-compose 配置，把容器加入 swag 网络
version: "3"
services:
gitlab:
image: gitlab/gitlab-ee:latest
restart: always
hostname: gitlab
container_name: gitlab
ports:
- 9443:443
- 9022:22
networks:
- swag
volumes:
- /etc/localtime:/etc/localtime
- ./config:/etc/gitlab
- ./logs:/var/log/gitlab
- ./data:/var/opt/gitlab
networks:
swag:
name: swag
external: true
重启容器
在 swag 里做 GitLab 容器的 80 端口反代
然后 config/gitlab.rb 配置里修改一下
external_url "http://gitlab.dealiaxy.com"
这里使用 HTTP 就好，https 在 swag 那边会配置，如果这里写了 https ，那么会要在 GitLab 里提供证书配置，比较麻烦。
然后 ssh host 也得改一下
gitlab_rails['gitlab_ssh_host'] = gitlab.dealiaxy.com
搞定
外观配置
同样在 Admin Area 里，有个“外观”配置
里面可以修改logo、登录页面的图片、说明（而且还支持markdown）啥的
我稍微改了一下，效果是这样
然后还有 New Project Guidelines 和 Profile Image Guidelines
分别是创建项目和用户修改头像时左侧的引导提示
随便写一点或者用大模型生成就完事了
这样配置下来就有模有样
版本升级
使用 docker-compose pull 命令来拉取最新的镜像后
先 down 然后再 up 就可以使更新生效了~
如果只是 restart 就只会重新启动现有的容器
小结
本文主要还是记录了邮件配置
还有一些比较零散的配置
接下来还要继续完善一下 CICD 流程
到时搞定之后再写文章记录
