@@ -592,3 +592,32 @@ Then specify in the master instance parameters:
...
@@ -592,3 +592,32 @@ Then specify in the master instance parameters:
* set ``port`` to ``443``
* set ``port`` to ``443``
* set ``plain_http_port`` to ``80``
* set ``plain_http_port`` to ``80``
Technical notes
===============
Instantiated cluster structure
------------------------------
Instantiating caddy-frontend results with a cluster in various partitions:
* master (the controlling one)
* kedifa (contains kedifa server)
* caddy-frontend-N which contains the running processes to serve sites - this partition can be replicated by ``-frontend-quantity`` parameter
So it means sites are served in `caddy-frontend-N` partition, and this partition is structured as:
* Caddy serving the browser
* (optional) Apache Traffic Server for caching
* Caddy connected to the backend
Kedifa implementation
---------------------
`Kedifa <https://lab.nexedi.com/nexedi/kedifa>`_ server runs on kedifa partition.
Each `caddy-frontend-N` partition downloads certificates from the kedifa server.
Caucase (exposed by ``kedifa-caucase-url`` in master partition parameters) is used to handle certificates for authentication to kedifa server.
If ``automatic-internal-kedifa-caucase-csr`` is enabled (by default it is) there are scripts running on master partition to simulate human to sign certificates for each caddy-frontend-N node.