1.7 KiB
Procedure for adding a GitLab Pages project to GitLab
Details
- Project name: hello
- Desired subdomain: hello.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 the
archlinux_org_gitlab_pages
variable inarchlinux.tf
. It should look something like this. Make sure to substitute theyour-domain
andyour-code-shown-by-gitlab
strings accordingly:"your-domain" = "your-code-shown-by-gitlab"
-
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.