2021-05-25 gitlab 配置邮箱

1 gitlab的安装

按照官网一般不会有什么问题，安装完后在有docker-compose的文件夹下主要有两个命令常用

// 用于停止gitlab 服务
docker-compose down

// 用于启动gitlab服务
docker-compose up -d

2 邮箱的配置

2.1 配置文件所在的位置

// 我的文件位置
/srv/gitlab/config/gitlab.rb

其中，srv就是我安装gitlab的目录，就是我们下载gitlab后解压完文件的目录

2.2 具体的配置项

打开gitlab.rb，找到关于email server的设置项
我这边是用的阿里云企业邮箱，可以参考如下的配置

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.mxhichina.com"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "你用的邮箱地址" # 如gitlab@your_domail.com
gitlab_rails['smtp_password'] = "邮箱的密码" 
gitlab_rails['smtp_domain'] = "邮箱的域名" #如 your_domain.com
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = false
gitlab_rails['smtp_tls'] = true
gitlab_rails['smtp_ssl'] = false
gitlab_rails['gitlab_email_from'] = 'gitlab@your_domail.com' # 这个地方务必与上面的gitlab_rails['smtp_user_name']一致
gitlab_rails['gitlab_email_display_name'] = 'gitlab'

2.3 如何调试，如果无法收到邮件

官方关于调试的方法 | GitLab
我也经历了配置邮箱的各种纠结，找不到在哪儿看日志，不知道自己哪儿配置错了，只能在网上各种找其他人成功的案例，看他们是怎么配置成功的。
其实最优的方法是依赖gitlab的工具来测试，下面我们就可以通过gitlab-rails 来测试邮件是否配置正确

2.3.1 如何启动gitlab-rails的console窗口？

这也是我遇到的问题，尽管官网有介绍常用的方法，但我都没能打开gitlab-rails的窗口，或许是因为我用的是docker-compose的方法启动，和官网的情况不一致。
其实也很简单，只需三步:

1) 找到启动的docker-compose id

// 显示并筛选出与gitlab相关的docker
docker ps -a | grep gitlab

image.png

2) 进入该镜像的bash

docker exec -it 1a4afa8d851d  bash

image.png

3) 进入gitlab-rails的console

gitlab-rails console

需要稍微等一会，就能看到console, 最后的状态如下：

image.png

2.3.2 如何发送测试邮件？

 Notify.test_email('[email protected]', 'Hello World', 'This is a test message').deliver_now

如果配置有问题，就会在改console窗口报错，可以根据报错的信息去找相应的解决方法，如果没有报错，那么邮件配置就成功了！

以上就是我自己在配置gitlab邮箱的过程中遇到的问题和解决方法。

如果觉得帮到了您，还希望能点个赞！
也欢迎留言沟通~