From 1e147b9154a8e4f21458254fa908e8c2f93a912b Mon Sep 17 00:00:00 2001 From: cinereal Date: Sat, 25 Oct 2025 15:42:56 +0200 Subject: [PATCH] compare tests by diagram Signed-off-by: cinereal --- architecture-docs/architecture.md | 10 +++++++--- architecture-docs/deploy-basic.mmd | 10 ++++++++++ architecture-docs/deploy-basic.png | Bin 0 -> 10260 bytes .../{test-setup.mmd => deploy-cli.mmd} | 0 .../{test-setup.png => deploy-cli.png} | Bin 5 files changed, 17 insertions(+), 3 deletions(-) create mode 100644 architecture-docs/deploy-basic.mmd create mode 100644 architecture-docs/deploy-basic.png rename architecture-docs/{test-setup.mmd => deploy-cli.mmd} (100%) rename architecture-docs/{test-setup.png => deploy-cli.png} (100%) diff --git a/architecture-docs/architecture.md b/architecture-docs/architecture.md index 5749257..cb4b541 100644 --- a/architecture-docs/architecture.md +++ b/architecture-docs/architecture.md @@ -105,7 +105,7 @@ For compatibility with existing clients, it reuses the protocol of Amazon S3. Considered alternatives include: -- file storage: less centralized for backups +- file storage: less centralised for backups ## Architecture @@ -202,9 +202,13 @@ Tests created so far cover: - builds for the (virtual) machines making up our internal infrastructure - ensuring any checks exposed by our Nix flake have been exposed in CI -An illustration demonstrating the set-up of our test deploying our applications is shown below: +Out of these, the set-up for our basic deployment test for example may be visualised as follows: -![](./test-setup.png){ width=100% } +![](./deploy-basic.png){ width=100% } + +Our test deploying our applications by command-line by comparison would look like: + +![](./deploy-cli.png){ width=100% } The latest info on our CI may be found at: diff --git a/architecture-docs/deploy-basic.mmd b/architecture-docs/deploy-basic.mmd new file mode 100644 index 0000000..87ba437 --- /dev/null +++ b/architecture-docs/deploy-basic.mmd @@ -0,0 +1,10 @@ +flowchart LR + deployer["deployer
has store paths
runs nixops4
"] + + subgraph target_machines["target machines"] + direction TB + hello + cowsay + end + + deployer -->|deploys| target_machines diff --git a/architecture-docs/deploy-basic.png b/architecture-docs/deploy-basic.png new file mode 100644 index 0000000000000000000000000000000000000000..34bffb0fad56796f556b3034af914dc9c9f0cf87 GIT binary patch literal 10260 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 literal 0 HcmV?d00001 diff --git a/architecture-docs/test-setup.mmd b/architecture-docs/deploy-cli.mmd similarity index 100% rename from architecture-docs/test-setup.mmd rename to architecture-docs/deploy-cli.mmd diff --git a/architecture-docs/test-setup.png b/architecture-docs/deploy-cli.png similarity index 100% rename from architecture-docs/test-setup.png rename to architecture-docs/deploy-cli.png