diff options
author | GitLab Bot <gitlab-bot@gitlab.com> | 2021-03-06 02:11:43 +0300 |
---|---|---|
committer | GitLab Bot <gitlab-bot@gitlab.com> | 2021-03-06 02:11:43 +0300 |
commit | 13d327df4f3c52505bf8ec1144f2dedb6a351ad6 (patch) | |
tree | 546e42fe159cde302b5e4d0b923d399e79bfbf71 /doc/administration/object_storage.md | |
parent | 9a70fcd2e277721bbe7b9a0c92ed925ddea201b6 (diff) |
Add latest changes from gitlab-org/gitlab@13-9-stable-ee
Diffstat (limited to 'doc/administration/object_storage.md')
-rw-r--r-- | doc/administration/object_storage.md | 18 |
1 files changed, 17 insertions, 1 deletions
diff --git a/doc/administration/object_storage.md b/doc/administration/object_storage.md index 3cad18dc497..3b43f53dc82 100644 --- a/doc/administration/object_storage.md +++ b/doc/administration/object_storage.md @@ -31,6 +31,8 @@ GitLab has been tested on a number of object storage providers: HTTP Range Requests from working with CI job artifacts](https://gitlab.com/gitlab-org/gitlab/-/issues/223806). Be sure to upgrade to GitLab v13.3.0 or above if you use S3 storage with this hardware. +- Ceph S3 prior to [Kraken 11.0.2](https://ceph.com/releases/kraken-11-0-2-released/) does not support the [Upload Copy Part API](https://gitlab.com/gitlab-org/gitlab/-/issues/300604). You may need to [disable multi-threaded copying](#multi-threaded-copying). + ## Configuration guides There are two ways of specifying object storage configuration in GitLab: @@ -752,7 +754,6 @@ To set up an instance profile: "Action": [ "s3:PutObject", "s3:GetObject", - "s3:AbortMultipartUpload", "s3:DeleteObject" ], "Resource": "arn:aws:s3:::test-bucket/*" @@ -764,3 +765,18 @@ To set up an instance profile: 1. [Attach this role](https://aws.amazon.com/premiumsupport/knowledge-center/attach-replace-ec2-instance-profile/) to the EC2 instance hosting your GitLab instance. 1. Configure GitLab to use it via the `use_iam_profile` configuration option. + +### Multi-threaded copying + +GitLab uses the [S3 Upload Part Copy API](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html) +to accelerate the copying of files within a bucket. Ceph S3 [prior to Kraken 11.0.2](https://ceph.com/releases/kraken-11-0-2-released/) +does not support this and [returns a 404 error when files are copied during the upload process](https://gitlab.com/gitlab-org/gitlab/-/issues/300604). + +The feature can be disabled using the `:s3_multithreaded_uploads` +feature flag. To disable the feature, ask a GitLab administrator with +[Rails console access](feature_flags.md#how-to-enable-and-disable-features-behind-flags) +to run the following command: + +```ruby +Feature.disable(:s3_multithreaded_uploads) +``` |