Resulting changes from the Deep Dive on Pages
As a result of the deep dive on Pages the following artifacts have to be created:
-
Clarify use of "primary IP" on https://docs.gitlab.com/ee/administration/pages/. Maybe example values like "192.0.2.…" with placeholders? -
Is roles ['pages_role']
(with space) typo or valid?- This is valid. I just confirmed. All roles appear to be documented with a space in between.
-
Multiple wild-card certs not possible. Only 1 for an instance. -
Trouble-shooting section about 404 errors generally: browse artifacts of pages job to check whether expected files exist -
Add troubleshooting section about "TLS/SSL-related issues: esp. self-signed certificates which needs to be in /etc/gitlab/trusted-certs/. Same [troubleshooting as for self-signed certs for the GitLab instance" => link to https://docs.gitlab.com/ee/administration/troubleshooting/ssl.html sufficient? -
Add something about "Since each project pages settings has an add custom domain option, does that mean each pages project can only exist in its own custom domain? e.g . is pages1.example.io, pages2.example.io, pages3.example.io (3 different projects) impossible? Multiple domains can be added, but might not show up until pages job deployed the content." -
Clarify that "access control = Pages application registered in project, using API scope". That's rather hidden in https://docs.gitlab.com/ee/user/project/pages/pages_access_control.html#terminating-a-pages-session currently -
Clarify that " disk
-to-gitlab
change for domain_config_source removes potentially 30min wait time for Pages update" -
Mention in https://docs.gitlab.com/ee/administration/pages/#additional-configuration-for-docker-container or so that "chroot + advanced settings … will depend on DNS details" to make caveats more SEO-y -
Remove troubleshooting step that detailed a workaround for projects that are transferred to another namespace. Since Pages is now API based for domain configuration lookups, this step is no longer relevant.
You may find the recording links in #2841 (closed) helpful.
If you are assigned to this issue, please pick at least one task from the above list (pairing is encouraged) and, after creating the merge request or issue, add it to the deep dive issue's description, under the Results heading. Please ask for help where you need it.
Edited by Kenneth Chu