MyGit

v3.5.0

mastodon/mastodon

版本发布时间: 2022-03-30 21:28:03

mastodon/mastodon最新发布版本:v4.3.0-beta.2(2024-09-17 23:53:19)

Mastodon

Upgrade overview

This release contains upgrade notes that deviate from the norm:

:information_source: Requires streaming API restart :information_source: Requires two-step database migration process for zero-downtime deployment :information_source: Systemd service files updated :warning: Elasticsearch requirement raised to at least 7 :warning: PostgreSQL version in docker-compose.yml has been changed from 9.6 to 14, requires manual upgrade

For more information, scroll down to the upgrade instructions section.

Changelog

Added

Changed

Removed

Deprecated

Fixed

Security

Upgrade notes

To get the code for v3.5.0, use git fetch && git checkout v3.5.0.

As always, make sure you have backups of the database before performing any upgrades. If you are using docker-compose, this is how a backup command might look: docker exec mastodon_db_1 pg_dump -Fc -U postgres postgres > name_of_the_backup.dump

:information_source: Some S3-compatible storage providers (such as Tencent Cloud Object Storage) may require setting S3_FORCE_SINGLE_REQUEST=true to properly handle some requests. :information_source: OAUTH_REDIRECT_AT_SIGN_IN, which wasn't working as intended, has been replaced by an OMNIAUTH_ONLY environment variable that should address the same use case

:information_source: The systemd service files dist/mastodon-web.service, dist/mastodon-sidekiq.service and dist/mastodon-streaming.service were updated. Make sure to update your installed service files, otherwise media uploads might fail to get processed correctly.

Dependencies

Compatibility with Elasticsearch 6.x and earlier has been dropped, and Elasticsearch 7.x is now required for the optional full-text search feature. Other external dependencies have not changed, although the default Ruby version has changed if you are using rbenv (see below). To summarize, the dependency requirements for v3.5.0rc3 are:

Update steps

The following instructions are for updating from 3.4.6.

If you are upgrading directly from an earlier release, please carefully read the upgrade notes for the skipped releases as well, as they often require extra steps such as database migrations or dependency updates.

Docker-only:

The PostgreSQL container version in our docker-compose.yml configuration has been changed from 9.6 to 14 due to EOL (End-of-Life) of 9.6. Detailed instructions on how to migrate your data is available here.

Non-Docker only:

Both Docker and non-Docker:

  1. Run the pre-deployment database migrations by specifying the SKIP_POST_DEPLOYMENT_MIGRATIONS=true environment variable:
    • Non-Docker: SKIP_POST_DEPLOYMENT_MIGRATIONS=true RAILS_ENV=production bundle exec rails db:migrate
    • Docker: docker-compose run --rm -e SKIP_POST_DEPLOYMENT_MIGRATIONS=true web rails db:migrate
  2. Precompile the assets:
    • Non-Docker: RAILS_ENV=production bundle exec rails assets:precompile
    • Docker: The assets are already precompiled during the build step
  3. Restart all Mastodon processes
  4. Clear cache:
    • Non-Docker: RAILS_ENV=production bin/tootctl cache clear
    • Docker: docker-compose run --rm web bin/tootctl cache clear
  5. Now that the new code is running, we can finish the database migrations. This will run the post-deployment ones:
    • Non-Docker: RAILS_ENV=production bundle exec rails db:migrate
    • Docker: docker-compose run --rm web rails db:migrate
  6. Restart all Mastodon processes

Translators

相关地址:原始地址 下载(tar) 下载(zip)

查看:2022-03-30发行的版本