GitLab Pages integration with Let’s Encrypt
GitLab Pages integration with Let’s Encrypt
在 GitLab 12.1 中 . 对于 GitLab 12.1 之前的版本,请参见手册”让我们加密”说明 .
GitLab Pages 与 Let’s Encrypt(LE)的集成使您可以将 LE 证书用于具有自定义域的 Pages 网站,而不必麻烦自己发行和更新它们. GitLab 现成的为您服务.
是一个免费,自动化和开源的证书颁发机构.
警告:此功能仅涵盖自定义域的证书,而不包含运行Pages 守护程序所需的通配符证书 . 在跟踪通配符证书的生成.
- 创建一个项目在 GitLab 包含您的网站的源代码.
- 并验证您的所有权.
- 确认您的网站已启动并且正在运行,可以通过您的自定义域进行访问.
注意: GitLab 的”让我们加密”集成已启用,并在 GitLab.com 上可用. 对于自我管理的 GitLab 实例,请确保您的管理员已启用它 .
满足要求后,启用”让我们加密”集成:
- 导航到项目的“设置”>”页面” .
- 找到您的域,然后单击详细信息 .
- 点击右上角的编辑 .
通过使用 Let’s Encrypt切换自动证书管理来启用 Let’s Encrypt 集成:
启用后,GitLab 将获得 LE 证书并将其添加到关联的 Pages 域中. 它也会由 GitLab 自动更新.
Notes:
- 颁发证书和更新 Pages 配置可能需要一个小时 .
- 如果您在域设置中已经具有 SSL 证书,它将继续工作,直到被 Let’s Encrypt 的证书替换为止.
在 GitLab 13.0 中引入 .
如果您遇到错误, 则在获取 Let’s Encrypt 证书时出了点问题 ,您可以尝试按照以下步骤再次获取证书:
- 转到项目的设置>页面 .
- 在您的域上单击” 编辑 “.
- Click Retry.
Message “GitLab is obtaining a Let’s Encrypt SSL certificate for this domain. This process can take some time. Please try again later.” hangs for more than an hour
- 转到项目的设置>页面 .
- 在您的域上单击删除 .
- Add the domain again and verify it.
- .
- 如果一段时间后仍然看到相同的消息:
- 请确保您已正确设置只有一个或
A
DNS 记录为您的域. - 确保您的域没有
AAAA
DNS 记录. - 转到步骤 1.
- 请确保您已正确设置只有一个或