infrastructure/.gitlab/issue_templates/New GitLab Pages Project.md

Procedure for adding a GitLab Pages project to GitLab

Details

• Project name: hello
• Desired subdomain: Either hello.archlinux.page or 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. On this page, you'll also need to make sure that Use unique domain is toggled ON. Note down the custom domain.

For a custom domain at *.archlinux.page

1. Add a mapping between the domain name and its generated unique domain from GitLab that you noted earlier into gitlab_pages_archlinux_org_map in host_vars/gitlab.archlinux.org/misc.yml.
2. Run ansible-playbook playbooks/gitlab.archlinux.org.yml -t gitlab.

For a custom domain at *.archlinux.org

Please note that we don't give out custom domains under *.archlinux.org lightly.

1. Add the desired domain name into archlinux_org_gitlab_pages in tf-stage1/archlinux.tf.
2. Add a mapping between the domain name and its generated unique domain from GitLab that you noted earlier into gitlab_pages_archlinux_org_map in host_vars/gitlab.archlinux.org/misc.yml.
3. Run terraform apply.
4. Run ansible-playbook playbooks/gitlab.archlinux.org.yml -t gitlab.