diff options
| author | Alex Auvolat <alex@adnab.me> | 2024-03-04 15:56:10 +0100 |
|---|---|---|
| committer | Alex Auvolat <alex@adnab.me> | 2024-03-04 15:56:10 +0100 |
| commit | bbde9bc91225ac41ea6e8def61c5b7044bb186a0 (patch) | |
| tree | 6e2bb951b1efb104c61d6e56aae84d7a6b036342 /doc/book/reference-manual/features.md | |
| parent | d0d95fd53f3d4a6fd5adcfbb4cbb031826fd64a4 (diff) | |
| parent | 3168bb34a0082480660e945f7390a5ecab26c665 (diff) | |
| download | garage-bbde9bc91225ac41ea6e8def61c5b7044bb186a0.tar.gz garage-bbde9bc91225ac41ea6e8def61c5b7044bb186a0.zip | |
Merge branch 'main' into next-0.10
Diffstat (limited to 'doc/book/reference-manual/features.md')
| -rw-r--r-- | doc/book/reference-manual/features.md | 22 |
1 files changed, 15 insertions, 7 deletions
diff --git a/doc/book/reference-manual/features.md b/doc/book/reference-manual/features.md index e8ba9510..f7014b26 100644 --- a/doc/book/reference-manual/features.md +++ b/doc/book/reference-manual/features.md @@ -37,6 +37,21 @@ A Garage cluster can very easily evolve over time, as storage nodes are added or Garage will automatically rebalance data between nodes as needed to ensure the desired number of copies. Read about cluster layout management [here](@/documentation/operations/layout.md). +### Several replication modes + +Garage supports a variety of replication modes, with 1 copy, 2 copies or 3 copies of your data, +and with various levels of consistency, in order to adapt to a variety of usage scenarios. +Read our reference page on [supported replication modes](@/documentation/reference-manual/configuration.md#replication_mode) +to select the replication mode best suited to your use case (hint: in most cases, `replication_mode = "3"` is what you want). + +### Compression and deduplication + +All data stored in Garage is deduplicated, and optionnally compressed using +Zstd. Objects uploaded to Garage are chunked in blocks of constant sizes (see +[`block_size`](@/documentation/reference-manual/configuration.md#block_size)), +and the hashes of individual blocks are used to dispatch them to storage nodes +and to deduplicate them. + ### No RAFT slowing you down It might seem strange to tout the absence of something as a desirable feature, @@ -48,13 +63,6 @@ As a consequence, requests can be handled much faster, even in cases where laten between cluster nodes is important (see our [benchmarks](@/documentation/design/benchmarks/index.md) for data on this). This is particularly usefull when nodes are far from one another and talk to one other through standard Internet connections. -### Several replication modes - -Garage supports a variety of replication modes, with 1 copy, 2 copies or 3 copies of your data, -and with various levels of consistency, in order to adapt to a variety of usage scenarios. -Read our reference page on [supported replication modes](@/documentation/reference-manual/configuration.md#replication_mode) -to select the replication mode best suited to your use case (hint: in most cases, `replication_mode = "3"` is what you want). - ### Web server for static websites A storage bucket can easily be configured to be served directly by Garage as a static web site. |