Custom domain for asknot-ng GitLab Pages
cc @shibumi
Procedure for adding a GitLab Pages project to GitLab
Details
- Project name: asknot-ng
- Desired subdomain: whatcanwedofor.archlinux.org
New Pages site checklist
-
Have a pipeline that outputs some static HTML to public/
during the build. -
Specify this path ( public/
) as an artifact path. -
GitLab should now recognize that you're trying to use Pages and will show some relevant information at https://gitlab.archlinux.org/your-namespace/your-project/pages -
At this page, you'll also need to add your custom domain. Add the custom domain you requested earlier. GitLab will then show domain verification information which you'll need in the next step. -
At this point, we'll need to add some stuff to archlinux.tf
. It should look something like this. Make sure to substitute theyour_domain
andyour-domain
strings accordingly:resource "hetznerdns_record" "gitlab_pages_your_domain_a" { zone_id = hetznerdns_zone.archlinux.id name = "your-domain" value = hcloud_floating_ip.gitlab_pages.ip_address type = "A" } resource "hetznerdns_record" "gitlab_pages_your_domain_aaaa" { zone_id = hetznerdns_zone.archlinux.id name = "your-domain" value = var.gitlab_pages_ipv6 type = "AAAA" } resource "hetznerdns_record" "gitlab_pages_your_domain_verification" { zone_id = hetznerdns_zone.archlinux.id name = "_gitlab-pages-verification-code.your-domain" value = "gitlab-pages-verification-code=your-code-shown-by-gitlab" type = "TXT" }
-
Run terraform apply
and go back to GitLab. HitVerify
and it should pick up the new domain verification code. It should then also automatically begin fetching a certificate via Let's Encrypt. That should take roughly 10min.