asonix/changes #11

Merged
asonix merged 8 commits from asonix/changes into asonix/downstream 2022-11-15 15:16:15 +00:00
Owner

Upgrade notes

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

Update steps

The following instructions are for updating from 3.5.3.

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.

Non-Docker only:

  • The recommended Ruby version has been bumped to 3.0.4. You can upgrade, or you can continue using the old version by overwriting the ``.ruby-version file with e.g. 3.0.3 which was recommended previously
  • Install dependencies: bundle install and yarn install

Both Docker and non-Docker:

⚠️ Incoming federated activity now uses a new ingress queue in Sidekiq. If you customize Sidekiq processes/queues, ensure that there is at least one process handling the ingress queue.

  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
  1. Precompile the assets:
  • Non-Docker: RAILS_ENV=production bundle exec rails assets:precompile
  • Docker: The assets are already precompiled during the build step
  1. Restart all Mastodon processes
  2. 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
  1. Restart all Mastodon processes
## Upgrade notes > 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` ## Update steps The following instructions are for updating from 3.5.3. 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. #### Non-Docker only: - The recommended Ruby version has been bumped to 3.0.4. You can upgrade, or you can continue using the old version by overwriting the ``.ruby-version file with e.g. `3.0.3` which was recommended previously - Install dependencies: `bundle install` and `yarn install` #### Both Docker and non-Docker: > ⚠️ Incoming federated activity now uses a new `ingress` queue in Sidekiq. If you customize Sidekiq processes/queues, ensure that there is at least one process handling the `ingress` queue. 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. 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` 5. Restart all Mastodon processes
asonix added 8 commits 2022-11-15 15:16:06 +00:00
asonix merged commit 66348a04d1 into asonix/downstream 2022-11-15 15:16:15 +00:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: asonix/mastodon#11
No description provided.