Merge pull request #3680 from luixxiul/fix

Update docs/configuring-playbook-s3-goofys.md
This commit is contained in:
Slavi Pantaleev 2024-10-25 13:17:29 +03:00 committed by GitHub
commit b63d8a5687
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -34,18 +34,13 @@ If you have local media store files and wish to migrate to Backblaze B2 subseque
It's a good idea to [make a complete server backup](faq.md#how-do-i-backup-the-data-on-my-server) before migrating your local media store to an S3-backed one. It's a good idea to [make a complete server backup](faq.md#how-do-i-backup-the-data-on-my-server) before migrating your local media store to an S3-backed one.
Follow one of the guides below for a migration path from a locally-stored media store to one stored on S3-compatible storage: After making the backup, follow one of the guides below for a migration path from a locally-stored media store to one stored on S3-compatible storage:
- [Storing Matrix media files on Amazon S3 with Goofys (optional)](#storing-matrix-media-files-on-amazon-s3-with-goofys-optional)
- [Usage](#usage)
- [Migrating from local filesystem storage to S3](#migrating-from-local-filesystem-storage-to-s3)
- [Migrating to any S3-compatible storage (universal, but likely slow)](#migrating-to-any-s3-compatible-storage-universal-but-likely-slow) - [Migrating to any S3-compatible storage (universal, but likely slow)](#migrating-to-any-s3-compatible-storage-universal-but-likely-slow)
- [Migrating to Backblaze B2](#migrating-to-backblaze-b2) - [Migrating to Backblaze B2](#migrating-to-backblaze-b2)
### Migrating to any S3-compatible storage (universal, but likely slow) ### Migrating to any S3-compatible storage (universal, but likely slow)
It's a good idea to [make a complete server backup](faq.md#how-do-i-backup-the-data-on-my-server) before doing this.
1. Proceed with the steps below without stopping Matrix services 1. Proceed with the steps below without stopping Matrix services
2. Start by adding the base S3 configuration in your `vars.yml` file (seen above, may be different depending on the S3 provider of your choice) 2. Start by adding the base S3 configuration in your `vars.yml` file (seen above, may be different depending on the S3 provider of your choice)
@ -72,7 +67,7 @@ It's a good idea to [make a complete server backup](faq.md#how-do-i-backup-the-d
7. Start the S3 service by running this **on the server**: `systemctl start matrix-goofys` 7. Start the S3 service by running this **on the server**: `systemctl start matrix-goofys`
8. Sync the files again by re-running the `rsync` command you see in step #6 8. Sync the files again by re-running the `rsync` command you see in step #5
9. Stop the S3 service by running this **on the server**: `systemctl stop matrix-goofys` 9. Stop the S3 service by running this **on the server**: `systemctl stop matrix-goofys`
@ -93,8 +88,6 @@ It's a good idea to [make a complete server backup](faq.md#how-do-i-backup-the-d
### Migrating to Backblaze B2 ### Migrating to Backblaze B2
It's a good idea to [make a complete server backup](faq.md#how-do-i-backup-the-data-on-my-server) before doing this.
1. While all Matrix services are running, run the following command on the server: 1. While all Matrix services are running, run the following command on the server:
(you need to adjust the 3 `--env` line below with your own data) (you need to adjust the 3 `--env` line below with your own data)
@ -126,7 +119,7 @@ It's a good idea to [make a complete server backup](faq.md#how-do-i-backup-the-d
mv /matrix/synapse/storage/media-store /matrix/synapse/storage/media-store-local-backup mv /matrix/synapse/storage/media-store /matrix/synapse/storage/media-store-local-backup
``` ```
5. Put the [Backblaze B2 settings seen above](#backblaze-b2) in your `vars.yml` file 5. Put the [Backblaze B2 settings](configuring-playbook-s3.md#backblaze-b2) in your `vars.yml` file
6. Run the playbook: `ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,start` 6. Run the playbook: `ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,start`