1
1
Fork 0
mirror of https://gitlab.archlinux.org/archlinux/infrastructure.git synced 2024-05-28 03:36:04 +02:00
infrastructure/.gitlab/issue_templates/New GitLab Pages Project.md

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

  1. Have a pipeline that outputs some static HTML to public/ during the build.

  2. Specify this path (public/) as an artifact path.

  3. 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

  4. 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.

  5. At this point, we'll need to add some stuff to the archlinux_org_gitlab_pages variable in archlinux.tf. It should look something like this. Make sure to substitute the your-domain and your-code-shown-by-gitlab strings accordingly:

     "your-domain" = "your-code-shown-by-gitlab"
    
  6. Run terraform apply and go back to GitLab. Hit Verify 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.