Pages administration documentation needs clarification
I'm working with a customer in https://gitlab.zendesk.com/agent/tickets/19420
The Pages docs at http://doc.gitlab.com/ee/pages/administration.html are not very clear about when pages_nginx shoudl and should not be disabled. Can't users use pages_nginx if they're not using HTTPS? The docs suggest to disable pages_nginx in this case, too.
What needs to happen to support user-supplied SSL certificates? @jnijhof told me that pages_nginx has to be disabled to support user-supplied SSL. On top of that, the port for Pages should be a higher port, and a load balancer should proxy 80/443 back to those higher Pages ports. This is not really made clear in the docs and to be honest, I'm still not clear on everything that needs to happen. Maybe we need a note in there, too, that it's OK to use pages_nginx if all of your Pages sites will be at the *.pages.domain and using the same SSL certificates.
@axil Can you please help clarify this? Thanks for your help.
Activity
Added pages label
Relevant tweet:
https://twitter.com/TomasHubelbauer/status/810524556679122948The tweet is somewhat related, but the person on Twitter is actually requesting clarification on another thing. That is that we should mention that a CNAME for custom domains will only work when it's not the apex of the domain. In this case, we should document how to use an A record instead.
mentioned in issue #1436 (closed)
changed milestone to %8.16
From #1436 (closed)
The documentation at https://docs.gitlab.com/ee/pages/administration.html#nginx-configuration can be hard to follow. Most section cover two possible installation methods, one for
sourceand one foromnibusmaking the page very busy. Additionally the NGINX caveats section only covers source installation.
Zendesk ticket: https://gitlab.zendesk.com/agent/tickets/53017
It mentions “source” and “omnibus” caveats … but isn’t very clear if it includes ALL of the steps.
Would be a lot more helpful to have separate pages for source installs vs. omnibus
Related issue: https://gitlab.com/gitlab-com/blog-posts/issues/233
mentioned in merge request !1072 (merged)
-
Relevant issue https://gitlab.com/gitlab-org/gitlab-ee/issues/1357
changed milestone to %8.17
assigned to @axil
mentioned in issue #1357 (closed)
In 8.17 Pages are coming to CE, our Pages documentation needs to be great!
Edited by username-removed-619072@axil If you look to tackle this, I'd love to help brainstorm on the best way to present the information. We currently show 4 'options', none of which includes the absolute easiest way to deploy Pages. Since most of our users are on-premises, I'd love to show the two most likely/easiest configurations first, and then offer others as ancillary/advanced options further down (trying to avoid confusion).
-
@dblessing I'm all ears! Option 4 should be the easiest https://docs.gitlab.com/ee/administration/pages/index.html#option-4-wildcard-http-domain-without-custom-domains.
mentioned in issue gitlab-com/gitlab-docs#69 (closed)
@axil Yes, option 4 should be first. Then, option 3. The other two should be in an advanced section, probably.
-
@dblessing ok cool, I'll change the order :)
-
@dblessing let's continue in https://gitlab.com/gitlab-org/gitlab-ce/issues/28095
