docs: Clarify that encryption should not be in reconciler pipeline

UpgradeImpact
=============
Operators should verify that encryption is not enabled in their
reconciler pipelines; having it enabled there may harm data durability.
For more information, see https://launchpad.net/bugs/1910804

Change-Id: I1a1d78ed91d940ef0b4eba186dcafd714b4fb808
Closes-Bug: #1910804
This commit is contained in:
Tim Burke 2021-01-21 11:53:09 -08:00 committed by Clay Gerrard
parent 4ee05c5ddc
commit 13c0980e71
2 changed files with 9 additions and 2 deletions

View File

@ -781,8 +781,9 @@ encrypted.
Encryption has no impact on the `container-reconciler` service. The Encryption has no impact on the `container-reconciler` service. The
`container-reconciler` uses an internal client to move objects between `container-reconciler` uses an internal client to move objects between
different policy rings. The destination object has the same URL as the source different policy rings. The reconciler's pipeline *MUST NOT* have encryption
object and the object is moved without re-encryption. enabled. The destination object has the same URL as the source object and the
object is moved without re-encryption.
Considerations for developers Considerations for developers

View File

@ -58,6 +58,12 @@
# ionice_priority = # ionice_priority =
[pipeline:main] [pipeline:main]
# Note that the reconciler's pipeline is intentionally very sparse -- it is
# only responsible for moving data from one policy to another and should not
# perform any transformations beyond (potentially) changing erasure coding.
# It notably MUST NOT include transformative middlewares (such as encryption),
# redirection middlewares (such as symlink), or composing middlewares (such
# as slo and dlo).
pipeline = catch_errors proxy-logging cache proxy-server pipeline = catch_errors proxy-logging cache proxy-server
[app:proxy-server] [app:proxy-server]