Update troubleshoot.md - Entering Docker container, run classic commands #923

acsr · 2025-02-06T09:50:31Z

How to master running local zope commands for debugging inside a Docker container.

Foot into the door from an answer to a ticket. To be enhanced as step 2…

📚 Documentation preview 📚: https://plone-training--923.org.readthedocs.build/

…local zope commands for debugging Foot into the door from an answer to a ticket. To be enhanced as step 2…

docs/plone-deployment/troubleshoot.md

stevepiercy · 2025-09-07T23:49:21Z

@acsr if you have the opportunity to work with the trainers, would you please update this PR for accuracy and completeness? It seems to be in a draft state to me. It also has merge conflicts that you need to resolve. Please let me know. Thank you!

acsr · 2025-09-09T11:39:49Z

@stevepiercy I have looked in to the state and cannot get at once the point how and why the merge conflict is displayed here in github. (I followed the web editor link above https://github.com/plone/training/pull/923/conflicts).

Due to personal issues and no time I cannot follow the sprint in the next days as I would like. I confirmed the general wording of the purpose already. Lets see.

acsr · 2025-09-09T12:41:24Z

I have reread the related issue plone/plone.exportimport#51 and the remarks by @yurj and I am not sure if I get the best approach to make serious suggestions to others in a generic way. I know that @fredvd suggested the use of firing up a dedicated container for the relstorage to filestorage conversion process. He wrapped this up during the Plone Tagung but do not see my skilllevel high enough to finalize the suggestion here.

For me it was enough to get a classic Zope related command to work inside the docker container and recognizing the way to prefix the command with a call of docker-entrypoint.sh to set the environment. I am not sure if this is the right approach and its implications and side effects.

acsr · 2025-09-09T13:50:56Z

Mentioned the challenge in this post + comment: https://community.plone.org/t/how-to-move-production-data-of-a-postgres-based-relstorage-from-a-currrent-cookieplone-based-docker-swarm-live-setup-to-a-similar-staging-site/22278/2

stevepiercy · 2025-09-09T17:40:34Z

@acsr scroll to the end of the pull request. Observe how to resolve merge conflicts:

see: https://community.plone.org/t/corepack-problems-specially-in-ci/20597

…hrough`

Teaching implies a in my opinion outdated understanding of top down education. Some thing they cannot teach. Some hate teachers. The actual content of that pages reflect a more modern aproach and are more inviting. This should be also present in the wording of the TOC and Headlines. The content can also be improved to a more encouraging onboarding of trainers beyond it is already trying tis.

Corrected the component spelling while exporting it . Component was PloneReleaseView , and while exporting it was written as PlonereleaseView. I simply corrected the spelling. To save user's time from debugging small errors .

…ation part of Volto-hands-on training In the internationalisation part of the Volto hands on training,we have to first translate the Plone release content type of our site. The file to be updated is PloneReleaseView.jsx , but the training documentation says the file to be updated is plonerelease.jsx , which we never created in past. I corrected the file which should be updated-- (PloneReleaseView.jsx ,and not the non existent plonerelease.jsx) This can cause confusion to a new developer, and he might create a plonerelease.jsx which technically was PloneReleaseView.jsx .

To load an add-on, the project needs to specify the add-on in the addons key of package.json of main project. In the training , it was written project.json, I corrected it to package.json.

…Volto Version 17+

- Add genindex to toctree and home page - Sort conf.py to align with Documentation for easier future updates - Fix syntax errors - Purge unneeded JavaScript, since it was fixed upstream

Changed title capitalization

- Add `drag.svg` icon

The title needs a clarification and we need a second topic pointing to the latest available training / docs fort Plone 6 Classic / similar to Plone 5

Co-authored-by: Steve Piercy <[email protected]>

fix typo

I believe this should be index.js not config.js.

Co-authored-by: Steve Piercy <[email protected]>

#968) Co-authored-by: Steve Piercy <[email protected]>

…local zope commands for debugging Foot into the door from an answer to a ticket. To be enhanced as step 2…

…-Docker-container

acsr · 2025-09-17T15:39:04Z

As @stevepiercy suggests I would like to have a review by a trainer experienced with docker containers for my change.

Priority Reviewers

The trainings for Installing and Deploying Plone during 2025.ploneconf.org are held by @ericof & @fredvd. Maybe you look first.

The approaches I wrote down came from input by @davisagli and @fredvd. @pbauer was relatively new to the deployment stuff when we fixed our building of images for ARM and troubleshoot the logs. @ksuess if you are into this you can also review this and tenor and scope.

Finally having these tipps after heavily missing them was helpful for me. It is difficult to discover and filter for Plone as newbies with more complex docker setups. Actually the swarm approach is a good entry point when you get a grip at it.

Update troubleshoot.md - Entering a Docker container and run classic …

afbae76

…local zope commands for debugging Foot into the door from an answer to a ticket. To be enhanced as step 2…

acsr mentioned this pull request Feb 6, 2025

How can plone-exporter be called manually inside a docker based Plone 6.0 Volto deployment? plone/plone.exportimport#51

Closed

stevepiercy requested changes Feb 6, 2025

View reviewed changes

docs/plone-deployment/troubleshoot.md Outdated Show resolved Hide resolved

docs/plone-deployment/troubleshoot.md Outdated Show resolved Hide resolved

stevepiercy added this to Plone Documentation Sep 8, 2025

github-project-automation bot moved this to New in Plone Documentation Sep 8, 2025

acsr marked this pull request as draft September 17, 2025 13:06

acsr and others added 19 commits September 17, 2025 17:07

Update troubleshoot.md | add hints for missing stack-create-site step

fb36e4d

see: https://community.plone.org/t/corepack-problems-specially-in-ci/20597

Update troubleshoot.md

c285158

Remove images of 'docs/mastering-plone/_static/' not anymore referenced

a32452a

Update reference installation requisites

20fb677

Update docs/mastering-plone/installation.md

4a14ef6

Create dependabot.yml

87c453e

Move image that's used only in mastering to mastering

0ff5ec3

Restore image

646b0cf

image -> figure

8555217

Add support for tooltips, attrs_block, attrs_inline, and `striket…

a7362b7

…hrough`

Update plonereleasetype.md

d1e07d2

Corrected the component spelling while exporting it . Component was PloneReleaseView , and while exporting it was written as PlonereleaseView. I simply corrected the spelling. To save user's time from debugging small errors .

Update 01-addon-basics.md

712c03b

To load an add-on, the project needs to specify the add-on in the addons key of package.json of main project. In the training , it was written project.json, I corrected it to package.json.

Update documentation to replace jsconfig.json with tsconfig.json for …

306767b

…Volto Version 17+

Update 01-addon-basics.md

d6c2a3f

use {file} for semantic markup

9bab167

- Add sphinx-notfound-page to requirements and configuration

10becfe

- Add genindex to toctree and home page - Sort conf.py to align with Documentation for easier future updates - Fix syntax errors - Purge unneeded JavaScript, since it was fixed upstream

Tweak spacing

119cad4

aboycalledhero and others added 21 commits September 17, 2025 17:07

Update add-a-search-block.md

1dc9b0c

Changed title capitalization

Apply suggestions from code review

3f39f95

Update docs/content-editing/add-a-search-block.md

81d9c7b

Add missing clear.svg icon

266506f

Add HTML markup to display the clear button icon

44dc774

Add the add-document.svg icon

462a17b

- Rename file to align with title

f704ff5

- Add `drag.svg` icon

Bump GitHub Actions versions

6e33d50

Update index.md | Add an explicit Volto scope

7875658

The title needs a clarification and we need a second topic pointing to the latest available training / docs fort Plone 6 Classic / similar to Plone 5

Update docs/content-editing/index.md

4060050

Co-authored-by: Steve Piercy <[email protected]>

Update docs/content-editing/index.md

6c443b4

Co-authored-by: Steve Piercy <[email protected]>

Update blocks.md

6d1979d

fix typo

Update docs/volto-customization/blocks.md

1decda4

Update custom_block.md

799b14c

I believe this should be index.js not config.js.

Update docs/volto-customization/custom_block.md

abb795b

Create PULL_REQUEST_TEMPLATE.md

1d17763

## Configure a mail server: Add info on where to configure (#967)

49137ce

Co-authored-by: Steve Piercy <[email protected]>

Highlight the info that the UI for restricting addable types is not a… (

c3c3274

#968) Co-authored-by: Steve Piercy <[email protected]>

Update troubleshoot.md - Entering a Docker container and run classic …

80e8b70

…local zope commands for debugging Foot into the door from an answer to a ticket. To be enhanced as step 2…

Refine troubleshooting docker commands

ba3ab91

Merge branch 'main' into acsr-patch-Troubleshooting-Commands-inside-a…

ad94a8a

…-Docker-container

acsr marked this pull request as ready for review September 17, 2025 15:28

acsr requested review from davisagli, ksuess, pbauer and ericof September 17, 2025 15:39

stevepiercy moved this from New to Todo in Plone Documentation Sep 17, 2025

stevepiercy moved this from Todo to In Progress in Plone Documentation Sep 17, 2025

stevepiercy requested a review from fredvd September 17, 2025 19:54

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

Update troubleshoot.md - Entering Docker container, run classic commands #923

Update troubleshoot.md - Entering Docker container, run classic commands #923

Uh oh!

acsr commented Feb 6, 2025 •

edited by github-actions bot

Loading

Uh oh!

Uh oh!

Uh oh!

stevepiercy commented Sep 7, 2025

Uh oh!

acsr commented Sep 9, 2025

Uh oh!

acsr commented Sep 9, 2025

Uh oh!

acsr commented Sep 9, 2025

Uh oh!

stevepiercy commented Sep 9, 2025

Uh oh!

acsr commented Sep 17, 2025 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Update troubleshoot.md - Entering Docker container, run classic commands #923

Are you sure you want to change the base?

Update troubleshoot.md - Entering Docker container, run classic commands #923

Uh oh!

Conversation

acsr commented Feb 6, 2025 • edited by github-actions bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

stevepiercy commented Sep 7, 2025

Uh oh!

acsr commented Sep 9, 2025

Uh oh!

acsr commented Sep 9, 2025

Uh oh!

acsr commented Sep 9, 2025

Uh oh!

stevepiercy commented Sep 9, 2025

Uh oh!

acsr commented Sep 17, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Priority Reviewers

Uh oh!

Uh oh!

acsr commented Feb 6, 2025 •

edited by github-actions bot

Loading

acsr commented Sep 17, 2025 •

edited

Loading