summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorStan Hu <stanhu@gmail.com>2018-01-19 22:07:08 -0800
committerStan Hu <stanhu@gmail.com>2018-01-19 22:31:33 -0800
commit17ba80dae1291c27828fa8c5d944a7bf02f35ff1 (patch)
treeccfe8f45ba615b9f3afab07a9c7c37629521f6d3
parent7fa0a3e7775703ad9e53216f6154a773ca17ad4a (diff)
downloadgitlab-ce-17ba80dae1291c27828fa8c5d944a7bf02f35ff1.tar.gz
Document how to configure Fog with Digital Ocean Spacessh-s3-digitalocean-howto-docs
Closes gitlab-org/gitlab-ee#4419
-rw-r--r--doc/raketasks/backup_restore.md24
1 files changed, 24 insertions, 0 deletions
diff --git a/doc/raketasks/backup_restore.md b/doc/raketasks/backup_restore.md
index 50bb665216e..76f33b765d3 100644
--- a/doc/raketasks/backup_restore.md
+++ b/doc/raketasks/backup_restore.md
@@ -169,6 +169,30 @@ For Omnibus GitLab packages:
1. [Reconfigure GitLab] for the changes to take effect
+#### Digital Ocean Spaces and other S3-compatible providers
+
+Not all S3 providers are fully-compatible with the Fog library. For example,
+if you see `411 Length Required` errors after attempting to upload, you may
+need to downgrade the `aws_signature_version` value from the default value to
+2 [due to this issue](https://github.com/fog/fog-aws/issues/428).
+
+1. For example, with [Digital Ocean Spaces](https://www.digitalocean.com/products/spaces/),
+this example configuration can be used for a bucket in Amsterdam (AMS3):
+
+ ```ruby
+ gitlab_rails['backup_upload_connection'] = {
+ 'provider' => 'AWS',
+ 'region' => 'ams3',
+ 'aws_access_key_id' => 'AKIAKIAKI',
+ 'aws_secret_access_key' => 'secret123',
+ 'aws_signature_version' => 2,
+ 'endpoint' => 'https://ams3.digitaloceanspaces.com'
+ }
+ gitlab_rails['backup_upload_remote_directory'] = 'my.s3.bucket'
+ ```
+
+1. [Reconfigure GitLab] for the changes to take effect
+
---
For installations from source: