From: Michael Stapelberg <stapelberg@debian.org>
Date: Sat, 28 Jan 2017 22:22:42 +0000 (+0100)
Subject: add README for the static mirroring infrastructure
X-Git-Url: https://git.adam-barratt.org.uk/?a=commitdiff_plain;h=6cd7c84d9440b0c0359dcecce3d01f823720125e;p=mirror%2Fdsa-puppet.git

add README for the static mirroring infrastructure
---

diff --git a/modules/roles/README.static-mirroring.txt b/modules/roles/README.static-mirroring.txt
new file mode 100644
index 000000000..bc745babf
--- /dev/null
+++ b/modules/roles/README.static-mirroring.txt
@@ -0,0 +1,29 @@
+For content which can be served via the Apache web server, possibly with a
+custom configuration, Debian runs its static mirroring infrastructure.
+
+The term static mirroring infrastructure includes:
+
+ • components, specifying the data source and other config options.
+   See modules/roles/misc/static-components.yaml
+ • a masterhost for each component, responsible only for distributing data,
+   not for serving data to end users.
+ • machines with the static_mirror role configured in hieradata/common.yaml
+ • a few scripts around rsync(1)
+
+All of the above is managed via Puppet, for details see the files in
+modules/roles/*/static-mirroring.
+
+When data changes, the data source is responsible for running
+static-update-component, which instructs the masterhost via SSH to run
+static-master-update-component.
+
+static-master-update-component transfers a new copy of the source data to the
+masterhost using rsync(1) and, upon successful copy, swaps it with the current
+copy.
+
+The current copy on the masterhost is then distributed to all actual mirrors,
+again placing a new copy alongside their current copy using rsync(1).
+
+Once the data successfully made it to all mirrors, the mirrors are instructed
+to swap the new copy with their current copy, at which point the updated data
+will be served to end users.