How to run Plone without routing#
This guide shows you how to install Plone without any routing resources.
Use it to write your own routing, or to try the chart with kubectl port-forward.
It works with any of the other scenarios.
Prerequisites#
The prerequisites of the scenario it’s combined with, except Gateway API
Install#
helm install plone plone/plone --namespace plone --create-namespace \
--set routing.type=none
Combine these values with the ones of any other scenario, for example --set frontend.enabled=false for the Classic UI.
To try the site, forward a local port to the frontend, or to the backend with the Classic UI:
kubectl port-forward --namespace plone service/plone-frontend 3000:3000
Then open http://localhost:3000.
Write your own routing#
Your routing must send:
with Volto:
/++api++requests to the<release>-backendservice on port 8080, rewritten to/VirtualHostBase/<scheme>/<hostname>:<port>/<site id>/++api++/VirtualHostRoot, followed by the rest of the pathall other requests to the
<release>-frontendservice on port 3000
with the Classic UI: all requests to the backend, rewritten to
/VirtualHostBase/<scheme>/<hostname>:<port>/<site id>/VirtualHostRoot, followed by the rest of the pathwith Varnish: all the requests, rewritten as above, to the
<release>-varnishservice on port 6081, instead of the backend and the frontend
For example, with the hostname plone.example.com over HTTPS and the default site id, /++api++/news becomes /VirtualHostBase/https/plone.example.com:443/Plone/++api++/VirtualHostRoot/news.
Set routing.hostname, routing.https, and routing.port to the public values of your routing, so that Plone generates the same URLs.
For the reasons behind the rewrite, see The Zope virtual host rewrite.