diff options
| author | Trinity Pointard <trinity.pointard@gmail.com> | 2021-11-11 11:56:08 +0100 |
|---|---|---|
| committer | Gitea <gitea@fake.local> | 2021-11-16 15:41:41 +0100 |
| commit | 57df9c6e2d806c55d29faffaac241a153c0d9bcb (patch) | |
| tree | 3a6f0b0e593a5903ffcb9fc228fb904be27aa3d7 /doc/book/src | |
| parent | 9c58ec28d3b23accf782c6eb005b7c3966ec6314 (diff) | |
| download | garage-57df9c6e2d806c55d29faffaac241a153c0d9bcb.tar.gz garage-57df9c6e2d806c55d29faffaac241a153c0d9bcb.zip | |
add s3_api.root_domain to doc book
Diffstat (limited to 'doc/book/src')
| -rw-r--r-- | doc/book/src/cookbook/real_world.md | 1 | ||||
| -rw-r--r-- | doc/book/src/quick_start/index.md | 1 | ||||
| -rw-r--r-- | doc/book/src/reference_manual/configuration.md | 8 |
3 files changed, 10 insertions, 0 deletions
diff --git a/doc/book/src/cookbook/real_world.md b/doc/book/src/cookbook/real_world.md index 70262cc3..7864274c 100644 --- a/doc/book/src/cookbook/real_world.md +++ b/doc/book/src/cookbook/real_world.md @@ -83,6 +83,7 @@ bootstrap_peers = [] [s3_api] s3_region = "garage" api_bind_addr = "[::]:3900" +root_domain = ".s3.garage" [s3_web] bind_addr = "[::]:3902" diff --git a/doc/book/src/quick_start/index.md b/doc/book/src/quick_start/index.md index 9ff8be7f..8de3fd8b 100644 --- a/doc/book/src/quick_start/index.md +++ b/doc/book/src/quick_start/index.md @@ -48,6 +48,7 @@ bootstrap_peers = [] [s3_api] s3_region = "garage" api_bind_addr = "[::]:3900" +root_domain = ".s3.garage" [s3_web] bind_addr = "[::]:3902" diff --git a/doc/book/src/reference_manual/configuration.md b/doc/book/src/reference_manual/configuration.md index e165eb87..7eb64c14 100644 --- a/doc/book/src/reference_manual/configuration.md +++ b/doc/book/src/reference_manual/configuration.md @@ -30,6 +30,7 @@ sled_flush_every_ms = 2000 [s3_api] api_bind_addr = "[::]:3900" s3_region = "garage" +root_domain = ".3.garage" [s3_web] bind_addr = "[::]:3902" @@ -176,6 +177,13 @@ Garage will accept S3 API calls that are targetted to the S3 region defined here API calls targetted to other regions will fail with a AuthorizationHeaderMalformed error message that redirects the client to the correct region. +#### `root_domain` + +The optionnal suffix to access bucket using vhost-style instead of path-style API calls. + +For instance, if `root_domain` is `s3.garage.eu`, a bucket called `deuxfleurs.fr` +can be interacted with with hostname `deuxfleurs.fr.s3.garage.eu`. Note however you +can't interact with it using hostname `deuxfleurs.fr` directly. ## The `[s3_web]` section |