Skip to content

fix(maintenance): refresh page when turned off (sometimes) #53528

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

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

joshtrichards
Copy link
Member

@joshtrichards joshtrichards commented Jun 16, 2025

We claim on the user-facing maintenance page that it'll automatically refresh when service is restored. However the JS-based watcher wasn't loading because depends on common1.

Not sure how long this was broken for, but probably going back at least several majors (maybe more).

Still only a partial solution to the broader problem, but addresses the scenario that occurs when toggling maintenance mode during operations that do not use the built-in Updater2.

Follow-up ideas:

  • Adjust and clean up template design and language (what I was doing when I noticed this)
  • Remove dependencies on other JS assets
  • Remove dependencies on styling pulled from running system / or ?

Footnotes

  1. Since the maintenance page is "special" (and relatively simple) we should/could probably eliminate it's dependence on common. Of course the maintenance page is still stuck with styling dependencies... See next item.

  2. During normal operations, toggling maintenance mode on/off will work (and refresh automatically with this PR), but when using the standard Updater presumably it'll break due to both a loss of styling and Javascript asset access. This is because in the Updater we replace the entry points as an intermediate step. Directly related to Plain maintenance mode page #5789. Also, somewhat related to, Allow communicating expectations to users during maintenance #35787.

Signed-off-by: Josh <josh.t.richards@gmail.com>
@joshtrichards joshtrichards requested a review from a team as a code owner June 16, 2025 20:01
@joshtrichards joshtrichards requested review from nfebe and skjnldsv and removed request for a team June 16, 2025 20:01
@joshtrichards joshtrichards requested a review from sorbaugh June 16, 2025 20:01
Copy link
Member

@skjnldsv skjnldsv left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Make sense

@joshtrichards joshtrichards added this to the Nextcloud 32 milestone Jun 16, 2025
@joshtrichards
Copy link
Member Author

/backport to stable31

@joshtrichards
Copy link
Member Author

/backport to stable30

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants