Canasta 1.3.0 released

[Jeffrey Wang]

We are pleased to announce that Canasta 1.3.0 was released on 18 February 2022.

This is a major release that updates Canasta to use the latest LTS version of MediaWiki. (Canasta 1.3 uses MediaWiki 1.39 instead of 1.35.)

----

Preparing for upgrading to Canasta 1.3:

• Before a wiki can be upgraded to MediaWiki 1.39, its extensions and skins must be compatible with MediaWiki 1.39.
• Any user-provided extensions and skins installed under the extensions/ and skins/ directory must be upgraded to the appropriate MediaWiki 1.39 version.
• All bundled extensions have been updated to versions compatible with MediaWiki 1.39.
• For the most part, no special action is needed on them, except for extensions that have changed significantly since Canasta 1.2, such as PluggableAuth, which has been upgraded to 6.1 from 5.7. (There may be more extensions that have changed significantly—check your extensions list and their MediaWiki extensions.)
• To upgrade to 1.3.0, the orchestrator stack should be updated by pulling the latest version from GitHub.
• Canasta for Docker Compose has been upgraded to support Canasta 1.3. You can pull the latest version from the main branch.
• Canasta for Kubernetes does not yet support MediaWiki 1.39/Canasta 1.3. This support is coming soon.
• The upgrade process for Canasta if you are using Docker Compose as your orchestration tool — be sure to follow these steps in order, or your Canasta installation may break:
• Make a backup of your database.
• The recommended way to do so is by using Restic. Note: this requires the Canasta CLI to do. https://canasta.wiki/cli/#using-restic
• You can also manually do this by following the instructions on this page (not officially endorsed by the Canasta developers): https://www.howtogeek.com/devops/how-to-back-up-your-docker-volumes/
• Shut down Canasta.
• If you are using the CLI, run canasta stop.
• If you are manually running Canasta using Docker Compose, run docker compose down.
• Run git pull, then within docker-compose.override.yml, change image: ghcr.io/canastawiki/canasta:1.x.y to image: ghcr.io/canastawiki/canasta:1.3.0
• If you encounter any merge conflicts when pulling the new orchestrator stack, be sure to first move all of your changes in docker-compose.yml to docker-compose.override.yml and then revert to the provided version of docker-compose.yml by running the following: git restore docker-compose.yml
• Start Canasta back up.
• If you are using the CLI, run canasta start.
• If you are manually running Canasta using Docker Compose, run docker compose up -d.
• There is no need to do anything special to MediaWiki such as run update.php or use the web installer to upgrade MediaWiki to 1.39.
• Canasta already runs update.php on every single container launch.
• You can simply start up Canasta as usual and it'll automatically upgrade your wiki to MediaWiki 1.39, whether you use the CLI or docker-compose up -d.

----

Still need to use MediaWiki 1.35?

Canasta 1.2 will be supported until MediaWiki 1.35 is retired. Security updates and some features will continue to be released. The current version of Canasta 1.2.x is Canasta 1.2.2, running on MediaWiki 1.35.8.

To continue using Canasta for Docker Compose on 1.2, change your working branch to "1.2.x" (because the main branch will now be used for Canasta 1.3 and above) by changing your working directory to your Canasta for Docker Compose base directory and running the following:

git pull && git checkout 1.2.x

If you encounter any merge conflicts when doing this, be sure to first move all of your changes in docker-compose.yml to docker-compose.override.yml and then revert to the provided version of docker-compose.yml by running the following:

git restore docker-compose.yml

----

Change log:

• MediaWiki upgraded to 1.39.1.
• Bundled extensions upgraded to versions with MediaWiki 1.39 support.
• Added the extensions AbuseFilter, DeleteBatch, MediaUploader, Mermaid, SemanticDependencyUpdater, TemplateWizard, Title Icon, UserPageViewTracker, WatchAnalytics, and WhosOnline.
• Removed the extensions DiscussionTools and LocalisationUpdate.
• Added the skins MinervaNeue and Vector 2022.
• Added header warning to email-related special pages if $wgSMTP is not set.
  

A comprehensive change log is available under RELEASE_NOTES.md at https://github.com/CanastaWiki/Canasta/blob/master/RELEASE_NOTES.md.

----

In addition, the following orchestrator stacks have also been updated.

Canasta for Docker Compose 1.3.0 (https://github.com/CanastaWiki/Canasta-DockerCompose/releases/tag/v1.3.0) has been released to reflect the following changes:

• The prebuilt Docker images for dependency sidecar containers like MySQL, Elasticsearch, and Caddy now explicitly refer to Docker Hub.
• Elasticsearch now uses 7.10.2 to support CirrusSearch for MediaWiki 1.39.
• The Canasta image used is upgraded to 1.3.0.
  

----

For details into updates included with 1.3.0, please see its corresponding pull request: https://github.com/CanastaWiki/Canasta/pull/141

Thank you to all of the contributors who made 1.3.0 possible. As always, contributions and feedback from the community are welcome and encouraged.