Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add notes on how to install addon packages in an extended container. #67

Closed
wants to merge 12 commits into from
26 changes: 22 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -115,13 +115,31 @@ FROM plone/plone-backend:6.0.0b2
RUN ./bin/pip install "relstorage==3.4.5" "psycopg2==2.9.3 --use-deprecated legacy-resolver"
```

Also create a `requirements.txt` file, with packages to be installed:
Make sure any Plone add-ons you are adding via `pip install` have their corresponding entry
points declared in `setup.py` — otherwise they will not be loaded by Plone:

```plain
pas.plugin.authomatic
```
Rudd-O marked this conversation as resolved.
Show resolved Hide resolved
...
Rudd-O marked this conversation as resolved.
Show resolved Hide resolved
entry_points="""
[z3c.autoinclude.plugin]
target = plone
""",
...
Rudd-O marked this conversation as resolved.
Show resolved Hide resolved

```

Also make sure that your add-ons do not use `zc3.autoinclude` in their `configure.zcml`
configuration file. Instead, list the packages to include in your add-on's
`configure.zcml`, explicitly:

```xml
...
Rudd-O marked this conversation as resolved.
Show resolved Hide resolved
<!-- -*- include dependencies / sync me with setup.py -*- -->
<include package="z3c.jbot" />
...
Rudd-O marked this conversation as resolved.
Show resolved Hide resolved
```

Build your new image
Now build your new image:

```shell
docker build . -t myproject:latest -f Dockerfile
Expand Down
1 change: 1 addition & 0 deletions news/67.bugfix
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
* Document notes on how to ensure addons load within the Plone backend container [Rudd-O]
Rudd-O marked this conversation as resolved.
Show resolved Hide resolved