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

Recent breaking changes #2525

Open
ClearlyClaire opened this issue Dec 19, 2023 · 0 comments
Open

Recent breaking changes #2525

ClearlyClaire opened this issue Dec 19, 2023 · 0 comments

Comments

@ClearlyClaire
Copy link

ClearlyClaire commented Dec 19, 2023

We now have releases, so this document is less relevant, but I will still try to maintain it somewhat up-to-date.
Releases should be fully documented, and if you want to stick to main instead, you should pay some attention to the changes.

You can assume that any update to main may require running both pre-deployment and post-deployment database migrations, as well as require rebuilding the assets. Those do not constitute breaking changes.

Likewise, the .ruby-version can change at any point without that being considered a breaking change. This means that if you use rbenv, you should do rbenv install after updating the repository. Changes in the required versions of Ruby are considered breaking changes.

2024-11-06 - bf454e9 (#2892)

Dropped support for Ruby 3.1.

2024-08-24 - 49671fe (#2824)

Dropped support for StatsD integration.

2024-05-30 - 2a34c9a (#2721)

Mastodon is now performing stricter checks to prevent client IP address spoofing. This means that if one of your reverse proxy is not on Mastodon's local network, you will need to set TRUSTED_PROXY_IP accordingly, listing the IP address of every trusted reverse-proxy.

2024-05-02 - e7b0948 (#2699)

Last commit before the change: 3024212

Minimum Ruby version has been bumped from 3.0 to 3.1.

In addition, Mastodon requires new environment variables for secret keys to be set.
Generate new secrets and set ACTIVE_RECORD_ENCRYPTION_DETERMINISTIC_KEY, ACTIVE_RECORD_ENCRYPTION_KEY_DERIVATION_SALT, and ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY accordingly before restarting Mastodon.
(Such secrets can be generated by running bin/rails db:encryption:init).

2024-04-30 - 6f74ede (#2697)

Last commit before the change: 113c931

Significant changes have been made to glitch-soc's theming system, which will likely affect forks and flavour authors (but skin authors, end-users, and admins that have made no change to their instance should be unaffected). More details at #2697

2024-02-24 - 78c92c0 (#2647)

Last commit before the change: 25ac55e

Registrations are now closed by default! Also, removed max_toot_chars from the initial state rendering, but that should not affect anything.

2024-02-24 - 25ac55e (#2644)

Last commit before the change: f254140

The composer redesign from upstream has landed, along with CSS and translatable string changes. The doodle feature is temporarily unavailable.

2024-02-12 - 084d051 (#2608)

Branch with the 2024-02-14 security fixes: glitch-soc/security/8c76a208ed30cc1bd54262302b2aed27ae142509

Last commit before the change: 8c76a20

The SCSS has been completely refactored to better match upstream—this should not matter much to end-users or admins, but may greatly affect forks.

2024-01-24 - 634acd0 (#2580)

Branch with the 2024-02-14 security fixes: glitch-soc/security/915cd36ac11fc9d6fd221d68ed5b0749b88c7348

Last commit before the change: 915cd36

Logging format of the streaming server changed for a structured JSON format. This doesn't require changes unless you parse/monitor those logs.

The recommended Ruby version has changed from 3.2.2 to 3.2.3. If you are using rbenv, update the list of available versions and install Ruby 3.2.3 by doing RUBY_CONFIGURE_OPTS=--with-jemalloc rbenv install in the Mastodon install directory (e.g. /home/mastodon/live).

2024-01-14 - 04f786a (#2568)

Branch with the 2024-02-14 security fixes: glitch-soc/security/5f8618443c694e24577f722968c118162c86212c

Last commit before the change: 5f86184

Fontawesome icons have been replaced by Material Symbols. This should not require any action from server admins, but this will likely disrupt downstreams and user styles.

2024-01-11 - cbc9516

Last commit before the change: e5b97ea

fr-QC has been changed to fr-CA, this shouldn't cause issues if the migrations run correctly, but this could affect forks if they have their own translations.

2023-12-29 - 6fe978f (#2544)

Branch with the 2024-02-14 security fixes: glitch-soc/security/19e14654ccde8fb8e8412d3f4575bbcff3184a33

Last commit before the change: 19e1465

The follow recommendation algorithm changed. For the Elasticsearch-based ones to work properly, accounts need to be re-indexed with tootctl search deploy --only=accounts

2023-12-22 - e676b57 (#2537)

Branch with the 2024-02-14 security fixes: glitch-soc/security/f96e71352244b1fb43fe1cdf6ec7608f7486d29d

Last commit before the change: f96e713

Cookies and Rails cache format have changed. Zero-downtime rolling upgrades should be possible if you have already updated recently. Otherwise, stopping all services then starting them. See mastodon#27393 and mastodon#27392

2023-12-21 - d668b85 (#2532)

Branch with the 2024-02-14 security fixes: glitch-soc/security/f425a1e6378bd4fbed568100f0c26acfc6db8fd9

Last commit before the change: f425a1e

The Dockerfile has been rewritten and the streaming server is now in a dedicated docker image, see mastodon#26850

2023-12-19 - 4fdbffc (#2522)

Branch with the 2024-02-14 security fixes: glitch-soc/security/18856371be8603b7f720afaf8500b656c4667573

Last commit before the change: 3d3fa75
Last commit without known significant bugs before the change: 1885637 (bug is #2529

  • minimum NodeJS version changed from NodeJS 16 to NodeJS 18
  • switched from yarn 1 to yarn 4, the switch should be transparent if you use corepack, otherwise you'll have to either install yarn 4 or enable corepack
@glitch-soc glitch-soc locked and limited conversation to collaborators Dec 19, 2023
@ClearlyClaire ClearlyClaire pinned this issue Dec 19, 2023
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant