operations stuff:

fix constraints-kgs.txt
add zodbpack configuration
add relstorage-cache / blob-cache on zeoclient
update relstorage pinning. set psycopg2 back to 2.9.5 in all cases, we can't overrride the version from from plone-backend:6.0.15
Add collective.casestudy for local dev.
add sigterm handler by example from davisagli.

Author: fredvd

CHANGELOG.md

@@ -1,6 +1,16 @@
 ## 1.0.21 (unreleased)
 
 
+- Update to Relstorage 4.2.1
+- Simplify and make mxdev config explicit
+- Add collective.casestudy to mxdev, pin 1.0.0b1 for testing/production.
+- Add zodbpack utility container.
+- Add maintenance scripts. 
+- Add docs to use local filestorage, add make install for backend.
+- Deployment fixes for frontend, use newer linux base image for frontend.
+- Fix several frontend jsx template issues and warnings.
+- Updated Volto to 16.34.1
+
 
 ## 1.0.20 (2025-06-25)
 

backend/Dockerfile

@@ -11,11 +11,14 @@ LABEL maintainer="Plone Foundation <marketing@plone.org>" \
 COPY . .
 
 # Install local requirements and fix permissions
-RUN sed "s/PLONE_VERSION/${PLONE_VERSION}/g" constraints-template.txt > constraints.txt
+RUN  
 
 RUN --mount=type=cache,id=ploneorg-pip,target=/root/.cache/pip \
-    ./bin/pip install mxdev \
+    echo "-c https://dist.plone.org/release/${PLONE_VERSION}/constraints.txt" > constraints-kgs.txt \
+    mkdir /data/relstorage-cache /data/blob-cache \
+    && ./bin/pip install mxdev \
     && mv requirements-docker.txt requirements.txt \
     && ./bin/mxdev -c mx.ini \
     && ./bin/pip install -r requirements-mxdev.txt \
-    && chown -R plone: /app
+    && chown -R plone: /app \
+    && mv conf/relstorage.conf etc/relstorage.conf

backend/Dockerfile.maintenance

@@ -118,7 +118,7 @@ i18n: bin/i18ndude ## Update locales
 .PHONY: build-dev install
 build-dev: config ## pip install Plone packages
 	@echo "$(GREEN)==> Setup Build$(RESET)"
-	sed "s/PLONE_VERSION/$(PLONE_VERSION)/g" constraints-template.txt > constraints.txt
+	echo "-c https://dist.plone.org/release/${PLONE_VERSION}/constraints.txt" > constraints-kgs.txt
 	@bin/mxdev -c mx.ini
 	bin/pip install -r requirements-mxdev.txt
 # Forward compatibility

backend/Makefile

@@ -0,0 +1,42 @@
+%define INSTANCE /app
+instancehome $INSTANCE
+
+%define CLIENTHOME $(CLIENT_HOME)
+clienthome $CLIENTHOME
+
+debug-mode $(DEBUG_MODE)
+security-policy-implementation $(SECURITY_POLICY_IMPLEMENTATION)
+verbose-security $(VERBOSE_SECURITY)
+default-zpublisher-encoding $(DEFAULT_ZPUBLISHER_ENCODING)
+
+<environment>
+    CHAMELEON_CACHE $INSTANCE/var/cache
+</environment>
+
+<dos_protection>
+  form-memory-limit $(ZOPE_FORM_MEMORY_LIMIT)
+</dos_protection>
+
+<zodb_db main>
+    # Main database
+    cache-size $(ZODB_CACHE_SIZE)
+    %import relstorage
+    <relstorage>
+        name  $(RELSTORAGE_NAME)
+        read-only  $(RELSTORAGE_READ_ONLY)
+        keep-history  $(RELSTORAGE_KEEP_HISTORY)
+        commit-lock-timeout  $(RELSTORAGE_COMMIT_LOCK_TIMEOUT)
+        create-schema  $(RELSTORAGE_CREATE_SCHEMA)
+        blob-dir /data/blob-cache
+        shared-blob-dir  false
+        blob-cache-size  $(RELSTORAGE_BLOB_CACHE_SIZE)
+        blob-cache-size-check  $(RELSTORAGE_BLOB_CACHE_SIZE_CHECK)
+        blob-cache-size-check-external  $(RELSTORAGE_BLOB_CACHE_SIZE_CHECK_EXTERNAL)
+        blob-chunk-size  $(RELSTORAGE_BLOB_CHUNK_SIZE)
+        cache-local-dir  /data/relstorage-cache
+        <postgresql>
+            dsn $(RELSTORAGE_DSN)
+        </postgresql>
+    </relstorage>
+    mount-point /
+</zodb_db>

backend/conf/relstorage.conf

@@ -0,0 +1 @@
+-c https://dist.plone.org/release/6.0.15/constraints.txt

backend/constraints-kgs.txt

@@ -6,4 +6,6 @@ default_context:
     db_storage: relstorage
     db_relstorage_postgresql_driver: psycopg2
     db_relstorage_postgresql_dsn: dbname='ploneorg' user='ploneorg' host='127.0.0.1' password='ploneorg'
+    db_relstorage_cache_local_mb: 30
     db_blobs_mode: cache
+    db_blob_cache_size: 5GB

backend/constraints-template.txt

@@ -4,15 +4,25 @@
 ; to learn more about mxdev visit https://pypi.org/project/mxdev/
 
 [settings]
-; example how to override a package version
-; version-overrides =
-;     example.package==2.1.0a2
+requirements-in = requirements.txt
+requirements-out = requirements-mxdev.txt
+constraints-out = constraints-mxdev.txt
+default-target = ./sources
+default-use = False
 
-;version-overrides = 
+gh_plone = https://github.com/plone
+gh_collective = https://github.com/collective
 
 [plone.app.vulnerabilities]
-url = https://github.com/plone/plone.app.vulnerabilities.git
-pushurl = git@github.com:plone/plone.app.vulnerabilities.git
+url = ${settings:gh_plone}/plone.app.vulnerabilities.git
+pushurl = ${settings:gh_plone}/plone.app.vulnerabilities.git
 extras =
 branch = master
+use = True
 
+[collective.casestudy]
+url = ${settings:gh_collective}/collective.casestudy.git
+pushurl = ${settings:gh_collective}/collective.casestudy.git
+extras =
+branch = main
+use = True

backend/instance.yaml

@@ -1,8 +1,11 @@
--c constraints.txt
+# This is the requirements file used to build the Docker images for plone.org backend
+# Thes are the Known Good Set constraints downloaed from dist.plnone.org
+-c constraints-kgs.txt
 -e src/ploneorg
 
-relstorage==4.0.0
-#Don't try to updaet psycopg2, it need libpq-dev installed to run, but we don't have that because we import
+relstorage==4.2.0
+#Don't try to update psycopg2, it need libpq-dev installed to run, but we don't have that because we import
 #from plone-backend Docker image
 #psycopg2==2.9.9
-collective.revisionmanager==1.2.2
+collective.revisionmanager==1.2.2
+collective.casestudy==1.0.0b1