diff options
| author | Florian Klink <flokli@flokli.de> | 2024-03-01T08·56+0200 |
|---|---|---|
| committer | clbot <clbot@tvl.fyi> | 2024-03-03T16·52+0000 |
| commit | 65a810fc0b12e754af47864ab3b9d4b5756cde15 (patch) | |
| tree | ec69ccf0de3dcd53dc47748f8f2a6a649a85ad48 /tvix/docs/component-flow.puml | |
| parent | 6bdaebcb55eef5663f93dbbc8de6a48b459a10c0 (diff) | |
feat(tvix/docs): switch to mdbook r/7645
Some of the docs are still outdated (like architecture and drv path inconsistencies). Change-Id: I7a6afceb008ef4cd19a764dd6c637b39fa842a2e Reviewed-on: https://cl.tvl.fyi/c/depot/+/11072 Autosubmit: flokli <flokli@flokli.de> Tested-by: BuildkiteCI Reviewed-by: edef <edef@edef.eu>
Diffstat (limited to 'tvix/docs/component-flow.puml')
| -rw-r--r-- | tvix/docs/component-flow.puml | 60 |
1 files changed, 0 insertions, 60 deletions
diff --git a/tvix/docs/component-flow.puml b/tvix/docs/component-flow.puml deleted file mode 100644 index 5b6d79b82313..000000000000 --- a/tvix/docs/component-flow.puml +++ /dev/null @@ -1,60 +0,0 @@ -@startuml - -title Tvix build flow - -actor User -participant CLI -participant "Coordinator" as Coord -participant "Evaluator" as Eval -database Store -participant "Builder" as Build - -note over CLI,Eval - Typically runs locally on the invoking machine -end note -/ note over Store, Build - Can be either local or remote -end note - -User-->CLI: User initiates build of `hello` (analogous to `nix-build -f '<nixpkgs>' -A hello`) - -CLI-->Coord: CLI invokes coordinator - -Coord-->Eval: Sends message to start evaluation of `<nixpkgs>` (path lookup) with attribute `hello` -note right: The paths to the evaluator are local file system paths - -Coord<--Eval: Yields derivations to be built -note right - Immediately starts streaming derivations as they are instantiated across - the dependency graph so they can be built while the evaluation is still running. - - There are two types of build requests: One for regular "fire and forget" builds, - and another for IFD (import from derivation). - - These are distinct because IFD needs to be fed back into the evaluator for - further processing while a regular build does not. -end note - -loop while has more derivations - - Coord-->Store: Check if desired paths are in store - alt Store has path - Coord<--Store: Success response - else Store does not have path - Coord-->Build: Request derivation to be built - - alt Build failure - Coord<--Build: Fail response - note left: It's up to the coordinator whether to exit on build failure - else Build success - Build-->Store: Push outputs to store - Build<--Coord: Send success & pushed response - end - - end -end - -CLI<--Coord: Respond success/fail -User<--CLI: Exit success/fail - -@enduml |