orchestration: fix major mischaracterization - only 1 of 13 flows has a human gate
Live-checked every flow's actual Kestra definition for a Pause task. Only app-update has one; the other 6 main flows (os-update-vms, container-update, disk-cleanup, os-update-pbs, os-update-pve, os-update-pve-verify) run fully automatically with no human checkpoint at all - their safety net is the automated health-check/rollback path, not human approval. The doc previously presented check->pause->approve as the universal pattern for all 13 flows and stated outright that 'nothing gets changed on the fleet without a human explicitly resuming a paused flow', which was false for the flows that actually change the fleet. The KB was already correct on this point. Also replaced the mermaid diagram (broke this repo's established Nextcloud-SVG convention) with a real diagram showing both patterns, plus live evidence of the Pause-task check itself.
This commit is contained in:
2 files changed
+26
-17
No files matched your search
@@ -0,0 +1,4 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!-- Do not edit this file with editors other than draw.io -->
|
||||
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
|
||||
<svg xmlns="http://www.w3.org/2000/svg" style="background: transparent; background-color: transparent; color-scheme: light dark;" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="1142px" height="642px" viewBox="0 0 1142 642" content="<mxfile host="embed.diagrams.net" scale="1" border="0"> <diagram name="Flow Patterns" id="orch-patterns-1"> <mxGraphModel dx="1414" dy="791" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1200" pageHeight="640" math="0" shadow="0"> <root> <mxCell id="0" /> <mxCell id="1" parent="0" /> <mxCell id="lane1" parent="1" style="swimlane;whiteSpace=wrap;html=1;startSize=30;fillColor=none;strokeColor=#6c8ebf;dashed=1;fontSize=13;fontStyle=1;fontColor=#333333;align=left;spacingLeft=8;verticalAlign=middle;" value="12 OF 13 FLOWS — no human gate" vertex="1"> <mxGeometry height="140" width="1140" x="30" y="30" as="geometry" /> </mxCell> <mxCell id="l1s" parent="lane1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontColor=#333333;fontSize=12;fontStyle=1;shadow=1;" value="Weekly / scheduled trigger" vertex="1"> <mxGeometry height="60" width="220" x="40" y="50" as="geometry" /> </mxCell> <mxCell id="l1r" parent="lane1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontColor=#333333;fontSize=12;fontStyle=1;shadow=1;" value="Runs the playbook directly&lt;br&gt;&lt;font style=&quot;font-size: 10px;&quot;&gt;os-update-vms, container-update, disk-cleanup, os-update-pbs, dashy-fleet-audit, and 7 more&lt;/font&gt;" vertex="1"> <mxGeometry height="70" width="420" x="360" y="45" as="geometry" /> </mxCell> <mxCell id="l1n" parent="lane1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontColor=#333333;fontSize=12;fontStyle=1;shadow=1;" value="Notify: succeeded / failed" vertex="1"> <mxGeometry height="60" width="220" x="880" y="50" as="geometry" /> </mxCell> <mxCell id="e1" edge="1" parent="lane1" source="l1s" style="html=1;endArrow=block;strokeColor=#6c8ebf;strokeWidth=2;rounded=1;" target="l1r"> <mxGeometry relative="1" as="geometry" /> </mxCell> <mxCell id="e2" edge="1" parent="lane1" source="l1r" style="html=1;endArrow=block;strokeColor=#6c8ebf;strokeWidth=2;rounded=1;" target="l1n"> <mxGeometry relative="1" as="geometry" /> </mxCell> <mxCell id="lane2" parent="1" style="swimlane;whiteSpace=wrap;html=1;startSize=30;fillColor=none;strokeColor=#d79b00;dashed=1;fontSize=13;fontStyle=1;fontColor=#333333;align=left;spacingLeft=8;verticalAlign=middle;" value="1 OF 13 FLOWS (app-update) — check → pause → human approval → apply" vertex="1"> <mxGeometry height="480" width="1140" x="30" y="190" as="geometry" /> </mxCell> <mxCell id="l2s" parent="lane2" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;fontColor=#333333;fontSize=12;fontStyle=1;shadow=1;" value="Weekly schedule" vertex="1"> <mxGeometry height="60" width="180" x="40" y="40" as="geometry" /> </mxCell> <mxCell id="l2c" parent="lane2" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;fontColor=#333333;fontSize=12;fontStyle=1;shadow=1;" value="Check mode run&lt;br&gt;&lt;font style=&quot;font-size: 10px;&quot;&gt;detect pending Vault/Technitium/Alloy updates&lt;/font&gt;" vertex="1">
Line truncated
|
||||
|
After Width: | Height: | Size: 400 KiB |
Reference in new issue
Block a user