Home Explore Blog CI



nixpkgs

1st chunk of `pkgs/servers/web-apps/discourse/how_to_update.md`
753af16bc1afea1cebf30fe13a5590f21db0ebd521aecc54000000010000048c
To update discourse, do the following:

1. Switch to and work from the `master` branch and the directory this
   file is in.
2. Run `./update.py print-diffs` and update the nginx settings and
   backend settings accordingly. If you don't know how to, ask for
   help - do not skip this step!
3. Run `./update.py update`.
4. Run `nix build -L -f ../../../../ discourse.tests` to make sure the
   update works. Also test manually, if possible.
5. If the update works, commit it. If not, apply necessary fixes and
   commit. No manual fixes that would be overwritten by the
   `./update.py` script should be committed - the script should be
   fixed instead.
6. Run `./update.py update-mail-receiver`. If there's an update, do
   step 4 and 5 again.
7. Run `./update.py update-plugins`.
8. Run `nix build -L -f ../../../../ discourseAllPlugins.tests` to
   make sure the plugins build and discourse starts with them. Also
   test manually, if possible.
9. If the update works, commit it. If not, apply necessary fixes and
   commit. No manual fixes that would be overwritten by the
   `./update.py` script should be committed - the script should be
   fixed instead.

Title: Discourse Update Procedure
Summary
This section outlines the steps to update the Discourse application. The process involves switching to the master branch, updating configurations based on diffs, running update scripts, building and testing the application and plugins, and committing changes. Special emphasis is put on avoiding manual fixes that could be overwritten by the update script, and instead fixing the script itself.