How-to guides#

How-to guides show you how to solve a specific task. Each one assumes you know what you want, and shows you the steps.

Prepare the cluster#

🐘 Install the CloudNativePG operator

Install the operator that runs the PostgreSQL cluster of the chart.

How to install the CloudNativePG operator
🚦 Enable the Gateway API provider of Traefik

Turn on Gateway API in the Traefik of k3s or Rancher Desktop.

How to enable the Gateway API provider of Traefik on k3s
πŸ”— Attach the site to a Gateway

Point the HTTPRoute of the chart at the Gateway that serves the site.

How to attach the site to a Gateway
πŸ”’ Serve the site over HTTPS

Terminate TLS at the Gateway or the ingress controller.

How to serve the site over HTTPS

Choose an installation#

🌐 Volto with PostgreSQL

The default: Volto, RelStorage on a CloudNativePG cluster, and Gateway API.

How to install Plone with Volto and PostgreSQL
⚑ Volto with PostgreSQL and Varnish

The default, with Varnish caching the pages, the API, and the assets.

How to install Plone with Volto, PostgreSQL, and Varnish
πŸ—„οΈ Volto with ZEO

Volto, with a ZEO server deployed by the chart.

How to install Plone with Volto and ZEO
πŸ›οΈ Classic UI with PostgreSQL

The Classic UI, rendered by the backend, on RelStorage.

How to install Plone with the Classic UI and PostgreSQL
πŸ›οΈ Classic UI with ZEO

The Classic UI, with a ZEO server deployed by the chart.

How to install Plone with the Classic UI and ZEO
πŸ”Œ Use an external PostgreSQL server

Connect RelStorage to a PostgreSQL server that the chart doesn’t manage.

How to use an external PostgreSQL server
πŸ”Œ Use an external ZEO server

Connect the backend to a ZEO server that the chart doesn’t deploy.

How to use an external ZEO server
🧭 Route the site with ingress-nginx

Create Ingress resources, for clusters that still run ingress-nginx.

How to route the site with ingress-nginx
🚫 Run Plone without routing

Skip the routing resources, and bring your own.

How to run Plone without routing
πŸ“¦ Use your own images

Run your own backend and frontend images, and set environment variables.

How to use your own images and environment variables

Configure the site and the database#

βš™οΈ Configure the Plone site

Set the site id, the add-on profiles, and the default language.

How to configure the Plone site
πŸ”‘ Change the admin password

Replace the default password of the admin user.

How to change the admin password
🐘 Configure the PostgreSQL cluster

Size, replicate, and back up the CloudNativePG cluster.

How to configure the PostgreSQL cluster
🧹 Pack the database

Schedule the pack job, and keep the history you need for undo.

How to pack the database

Scale and cache#

πŸ“ˆ Scale and make the site highly available

Run more replicas, with disruption budgets.

How to scale and make the site highly available
⚑ Cache the site with Varnish

Put Varnish in front of the backend and the frontend.

How to cache the site with Varnish
✏️ Customize the Varnish VCL

Change how Varnish routes and caches the requests.

How to customize the Varnish VCL

Upgrade#

🚚 Migrate from the previous charts

Move an installation of the previous charts to this one.

How to migrate from the previous charts