目录结构

在容器内部署 GitLab 的目录结构

gitlab
├── config
├── data
├── logs
├── shell
└── docker-compose.yml

具体的目录结构也是看具体的配置，本文就以这个目录结构为例，进行具体的配置。

配置邮件功能

修改 config/gitlab.rb 文件，编辑邮件配置这一块，这里以腾讯企业邮箱为例。

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.exmail.qq.com"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "[email protected]"
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'] = "[email protected]"

保存与加载配置

上述配置完成保存一下，然后进入 GitLab 容器

docker compose exec gitlab bash

执行命令：

gitlab-ctl reconfigure
gitlab-ctl restart

发送测试邮件

上面操作执行完就已经完成配置了，接下来测试下效果，进入 ruby console 手动发送邮件

首先进入 GitLab 容器的 shell

docker compose exec gitlab bash

之后启动 ruby console

gitlab-rails console

输入命令发邮件

Notify.test_email('[email protected]', 'Test Email', 'This is a test email.').deliver_now

咱们可以做些额外的邮件配置，如果配置有问题，从报错信息也可以直观的看到：

### Email Settings

# gitlab_rails['gitlab_email_enabled'] = true

##! If your SMTP server does not like the default 'From: [email protected]'
##! can change the 'From' with this setting.
gitlab_rails['gitlab_email_from'] = '[email protected]'
gitlab_rails['gitlab_email_display_name'] = 'Example'
gitlab_rails['gitlab_email_reply_to'] = '[email protected]'
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'

使用 docker-compose pull 命令来拉取最新的镜像后，先 down 然后再 up 就可以使更新生效了，如果只是 restart 就只会重新启动现有的容器。

外观配置

在 Admin Area 里，有个“外观”配置，可以修改logo、登录页面的图片、说明（而且还支持markdown）啥的，修改后的效果：

然后还有 New Project Guidelines 和 Profile Image Guidelines，分别是创建项目和用户修改头像时左侧的引导提示。

跟邮件有关的几个功能

• 登录到你的 GitLab 实例。
• 进入 Admin Area（管理员区域）。
• 导航到 Settings > Integrations。

这个页面的中文应该是“实例级集成管理”，我这个版本的 GitLab 有俩跟邮件有关的，分别是：

• 推送时发送电子邮件
• 流水线状态电子邮件

顾名思义，前面邮箱配置好了就可以启用这俩，之后满足条件就可以在指定邮箱接收到通知邮件了

---

原文：开启GitLab的邮件通知功能以及一些外观配置

原作者：DealiAxy