Backend#
The backend runs the plone-backend image.
It serves the REST API for the Volto frontend, or the whole site with the Classic UI.
Resources#
Resource |
Name |
Created when |
|---|---|---|
StatefulSet |
|
always |
Service |
|
always |
Headless service |
|
always |
PodDisruptionBudget |
|
|
The headless service is the governing service that StatefulSets require.
It gives each pod a stable DNS name, <release>-backend-<n>.<release>-backend-director.
Image#
Value |
Default |
|---|---|
|
|
|
the |
|
|
Environment variables#
The chart sets these variables on the backend container:
Variable |
Value |
Set when |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
always |
The storage variables depend on storage.type.
With RelStorage, the chart sets DBHOST, DBPORT, DBNAME, DBUSER, DBPASSWORD, RELSTORAGE_DSN, RELSTORAGE_KEEP_HISTORY, and RELSTORAGE_BLOB_CACHE_SIZE.
With ZEO, it sets ZEO_ADDRESS and ZEO_CLIENT_CACHE_SIZE.
See Storage.
The backend.env list adds more variables, after the ones above.
Probes#
Probe |
Request |
Period |
Timeout |
Failure threshold |
|---|---|---|---|---|
Startup |
|
10 seconds |
15 seconds |
60, so up to 10 minutes for the first start |
Readiness |
|
10 seconds |
15 seconds |
3 |
Liveness |
|
10 seconds |
15 seconds |
3 |
Site creation#
With site.create set to true (default), the chart creates the Job <release>-site, which creates the Plone site with the id site.id, if it doesn’t exist yet.
Setting |
Value |
|---|---|
Hook |
|
Deletion |
before a new run, and when it succeeds; a failed Job is kept for its logs |
Retries |
6 |
Image |
the backend image |
Site type |
Volto with |
The backend pods only serve the site, and don’t go through the site creation of the plone-backend image, which isn’t meant for production.
site.profiles and site.defaultLanguage only apply when the site is created.
Volume#
The backend mounts an emptyDir volume at /data, for the client home, the blob cache, and the ZEO client cache.
The content of an emptyDir is lost when its pod is replaced.
Values#
The values of this component are under backend, see Values.
Its pod options are podAnnotations, podSecurityContext, securityContext, nodeSelector, tolerations, and affinity.