Skip to content

Commit 187b9c4

Browse files
authored
Merge branch '6.0' into integratel-coredev.buildout-2
2 parents 21df2a7 + a4a3f9f commit 187b9c4

File tree

3 files changed

+16
-8
lines changed

3 files changed

+16
-8
lines changed

docs/install/containers/images/backend.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ There are several ways to store data used by applications that run in Docker con
3131

3232
We encourage users of the `Plone` images to familiarize themselves with the options available.
3333

34-
[The Docker documentation](https://docs.docker.com/) is a good starting point for understanding the different storage options and variations.
34+
[The Docker documentation](https://docs.docker.com/guides/docker-concepts/running-containers/persisting-container-data) is a good starting point for understanding the different storage options and variations.
3535

3636

3737
## Configuration Variables
@@ -374,22 +374,30 @@ when Plone starts.
374374

375375
## Advanced usage
376376

377+
This section describes advanced usage of the Plone backend Docker image.
377378

378-
### Arbitrary `--user`
379379

380-
This image supports running as a (mostly) arbitrary user via `--user` on `docker run`, as long as the owner of `/data` matches:
380+
### Arbitrary user and persistent data
381+
382+
You can run Docker as an arbitrary user with the `--user` option.
383+
384+
To persist backend data between restarts of Docker, use both options of `--user` and `-v`.
385+
386+
The following command will run the Plone backend container as an arbitrary user, and persist the backend data in a volume, provided that the owner of the directory `/data` is the same as the `--user` option.
381387

382388
```shell
383389
docker run --user="$(id -u)" -v $(pwd)/data:/data plone/plone-backend
384390
```
385391

386-
The main caveat to note is that some environment variables, such as `ADDONS` and `DEVELOP`, will not work:
392+
````{note}
393+
Some environment variables, such as `ADDONS` and `DEVELOP`, will not work.
387394

388395
```console
389396
$ docker run --user="$(id -u)" -v $(pwd)/data:/data -e ADDONS="eea.facetednavigation" plone/plone-backend
390397
...
391398
error: [Errno 13] Permission denied: '/app/lib/python3.9/site-packages/eea'
392399
```
400+
````
393401

394402

395403
### Multiple containers with ZEO

requirements-initial.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
# From https://dist.plone.org/release/6-latest/constraints.txt
2-
pip==23.2
3-
setuptools==68.0.0
4-
wheel==0.40.0
2+
pip==24.0
3+
setuptools==71.0.0
4+
wheel==0.43.0

submodules/volto

Submodule volto updated 96 files

0 commit comments

Comments
 (0)