Changeset View
Changeset View
Standalone View
Standalone View
src/docs/user/configuration/configuring_file_storage.diviner
Show First 20 Lines • Show All 160 Lines • ▼ Show 20 Lines | ================= | ||||
- **Cons**: Slightly more complicated than other engines, not free. | - **Cons**: Slightly more complicated than other engines, not free. | ||||
To enable file storage in S3, set these keys: | To enable file storage in S3, set these keys: | ||||
- `amazon-s3.access-key`: Your AWS access key. | - `amazon-s3.access-key`: Your AWS access key. | ||||
- `amazon-s3.secret-key`: Your AWS secret key. | - `amazon-s3.secret-key`: Your AWS secret key. | ||||
- `storage.s3.bucket`: S3 bucket name where files should be stored. | - `storage.s3.bucket`: S3 bucket name where files should be stored. | ||||
Optionally, you may also configure the use of one of S3's three types of | |||||
server-side encryption (SSE-S3, SSE-KMS, SSE-C). See | |||||
[[ https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html | | |||||
S3's SSE documention ]] for more information and the values you may | |||||
wish to use for the following keys: | |||||
- `storage.s3.serverSideEncryption`: The value to send in the | |||||
`x-amz-server-side-encryption` header (e.g., 'AES256' or 'aws:kms'). | |||||
- `storage.s3.serverSideEncryption.aws-kms-key-id`: The value to send in the | |||||
`x-amz-server-side-encryption-aws-kms-key-id` header. | |||||
- `storage.s3.serverSideEncryption.customer.algorithm`: The value to send in | |||||
the `x-amz-server-side-encryption-customer-algorithm` header (e.g., | |||||
'AES256'). | |||||
- `storage.s3.serverSideEncryption.customer.key`: The value to send in the | |||||
`x-amz-server-side-encryption-customer-key` header. Note that this will be | |||||
encoded as base64 when sending. | |||||
Testing Storage Engines | Testing Storage Engines | ||||
======================= | ======================= | ||||
You can test that things are correctly configured by dragging and dropping | You can test that things are correctly configured by dragging and dropping | ||||
a file onto the Phabricator home page. If engines have been configured | a file onto the Phabricator home page. If engines have been configured | ||||
properly, the file should upload. | properly, the file should upload. | ||||
Migrating Files Between Engines | Migrating Files Between Engines | ||||
Show All 22 Lines |