[{"data":1,"prerenderedAt":390},["ShallowReactive",2],{"navigation":3,"\u002Fworkflows\u002Fruns":194,"\u002Fworkflows\u002Fruns-surround":385},[4,18,31,64,81,102,111,132,149],{"title":5,"path":6,"stem":7,"children":8,"page":17},"Getting started","\u002Fgetting-started","1.getting-started",[9,13],{"title":10,"path":11,"stem":12},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction",{"title":14,"path":15,"stem":16},"Run your first workflow","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F2.quickstart",false,{"title":19,"path":20,"stem":21,"children":22,"page":17},"Core concepts","\u002Fconcepts","2.concepts",[23,27],{"title":24,"path":25,"stem":26},"The platform model","\u002Fconcepts\u002Fplatform","2.concepts\u002F1.platform",{"title":28,"path":29,"stem":30},"Architecture and boundaries","\u002Fconcepts\u002Farchitecture","2.concepts\u002F2.architecture",{"title":32,"path":33,"stem":34,"children":35,"page":17},"Installation","\u002Finstallation","3.installation",[36,40,44,48,52,56,60],{"title":37,"path":38,"stem":39},"Overview and requirements","\u002Finstallation\u002Foverview","3.installation\u002F1.overview",{"title":41,"path":42,"stem":43},"Local evaluation","\u002Finstallation\u002Flocal-evaluation","3.installation\u002F2.local-evaluation",{"title":45,"path":46,"stem":47},"Install the server","\u002Finstallation\u002Fserver","3.installation\u002F3.server",{"title":49,"path":50,"stem":51},"Install a runner","\u002Finstallation\u002Frunner","3.installation\u002F4.runner",{"title":53,"path":54,"stem":55},"Verify the installation","\u002Finstallation\u002Fverification","3.installation\u002F5.verification",{"title":57,"path":58,"stem":59},"Upgrade the platform","\u002Finstallation\u002Fupgrades","3.installation\u002F6.upgrades",{"title":61,"path":62,"stem":63},"Guided installer","\u002Finstallation\u002Finstaller","3.installation\u002F7.installer",{"title":65,"path":66,"stem":67,"children":68,"page":17},"Build workflows","\u002Fworkflows","4.workflows",[69,73,77],{"title":70,"path":71,"stem":72},"Build a Definition","\u002Fworkflows\u002Fdefinitions","4.workflows\u002F0.definitions",{"title":74,"path":75,"stem":76},"Deploy and run workflows","\u002Fworkflows\u002Fruns","4.workflows\u002F1.runs",{"title":78,"path":79,"stem":80},"Inputs, context, and secrets","\u002Fworkflows\u002Finputs-and-secrets","4.workflows\u002F2.inputs-and-secrets",{"title":82,"path":83,"stem":84,"children":85,"page":17},"Run and recover","\u002Foperations","5.operations",[86,90,94,98],{"title":87,"path":88,"stem":89},"Monitor Runs","\u002Foperations\u002Fmonitoring","5.operations\u002F1.monitoring",{"title":91,"path":92,"stem":93},"Approve prepared steps","\u002Foperations\u002Fapprovals","5.operations\u002F2.approvals",{"title":95,"path":96,"stem":97},"Recover or cancel execution","\u002Foperations\u002Frecovery","5.operations\u002F3.recovery",{"title":99,"path":100,"stem":101},"Troubleshooting","\u002Foperations\u002Ftroubleshooting","5.operations\u002F4.troubleshooting",{"title":103,"path":104,"stem":105,"children":106,"page":17},"Action catalog","\u002Fcatalog","6.catalog",[107],{"title":108,"path":109,"stem":110},"Find and use Actions","\u002Fcatalog\u002Foverview","6.catalog\u002F1.overview",{"title":112,"path":113,"stem":114,"children":115,"page":17},"Administration","\u002Fadministration","7.administration",[116,120,124,128],{"title":117,"path":118,"stem":119},"Registries and Environments","\u002Fadministration\u002Fenvironments","7.administration\u002F2.environments",{"title":121,"path":122,"stem":123},"Manage runners","\u002Fadministration\u002Frunners","7.administration\u002F3.runners",{"title":125,"path":126,"stem":127},"Access and approval policies","\u002Fadministration\u002Faccess","7.administration\u002F4.access",{"title":129,"path":130,"stem":131},"Backups and upgrades","\u002Fadministration\u002Fmaintenance","7.administration\u002F5.maintenance",{"title":133,"path":134,"stem":135,"children":136,"page":17},"Develop Actions","\u002Factions","8.actions",[137,141,145],{"title":138,"path":139,"stem":140},"Build your first Action","\u002Factions\u002Fquickstart","8.actions\u002F1.quickstart",{"title":142,"path":143,"stem":144},"Local development","\u002Factions\u002Flocal-development","8.actions\u002F2.local-development",{"title":146,"path":147,"stem":148},"Publish an Action","\u002Factions\u002Fpublishing","8.actions\u002F3.publishing",{"title":150,"path":151,"stem":152,"children":153,"page":17},"Reference","\u002Freference","9.reference",[154,158,162,166,170,174,178,182,186,190],{"title":155,"path":156,"stem":157},"Operator CLI","\u002Freference\u002Foperator-cli","9.reference\u002F1.operator-cli",{"title":159,"path":160,"stem":161},"Installer CLI","\u002Freference\u002Finstaller-cli","9.reference\u002F10.installer-cli",{"title":163,"path":164,"stem":165},"Definition syntax","\u002Freference\u002Fdefinition","9.reference\u002F2.definition",{"title":167,"path":168,"stem":169},"CLI configuration","\u002Freference\u002Fconfiguration","9.reference\u002F3.configuration",{"title":171,"path":172,"stem":173},"API integration","\u002Freference\u002Fapi","9.reference\u002F4.api",{"title":175,"path":176,"stem":177},"Action CLI","\u002Freference\u002Faction-cli","9.reference\u002F5.action-cli",{"title":179,"path":180,"stem":181},"Action SDK","\u002Freference\u002Fsdk","9.reference\u002F6.sdk",{"title":183,"path":184,"stem":185},"Contracts and compatibility","\u002Freference\u002Fcontracts","9.reference\u002F7.contracts",{"title":187,"path":188,"stem":189},"Server configuration","\u002Freference\u002Fserver-configuration","9.reference\u002F8.server-configuration",{"title":191,"path":192,"stem":193},"Runner configuration","\u002Freference\u002Frunner-configuration","9.reference\u002F9.runner-configuration",{"id":195,"title":74,"body":196,"description":379,"extension":380,"meta":381,"navigation":382,"path":75,"seo":383,"stem":76,"__hash__":384},"docs\u002F4.workflows\u002F1.runs.md",{"type":197,"value":198,"toc":372},"minimark",[199,208,213,221,252,262,265,269,272,298,305,309,318,329,339,343,350,354,357,368],[200,201,202,203,207],"p",{},"Deploy a Definition into an Environment to create a ",[204,205,206],"strong",{},"Pypline",". Start a Run when you want to execute it. These are separate operations: many Runs can use the same deployed revision.",[209,210,212],"h2",{"id":211},"deploy-a-definition","Deploy a Definition",[200,214,215,216,220],{},"After ",[217,218,219],"a",{"href":15},"connecting to a server",", use an Environment with a configured registry and compatible runner pool:",[222,223,229],"pre",{"className":224,"code":225,"filename":226,"language":227,"meta":228,"style":228},"language-sh shiki shiki-themes pyplines-light pyplines-light pyplines-dark","pyplines validate .\u002Fworkflow.yaml\npyplines deploy .\u002Fworkflow.yaml --environment development --as example\npyplines info development\u002Fexample\n","Terminal","sh","",[230,231,232,240,246],"code",{"__ignoreMap":228},[233,234,237],"span",{"class":235,"line":236},"line",1,[233,238,239],{},"pyplines validate .\u002Fworkflow.yaml\n",[233,241,243],{"class":235,"line":242},2,[233,244,245],{},"pyplines deploy .\u002Fworkflow.yaml --environment development --as example\n",[233,247,249],{"class":235,"line":248},3,[233,250,251],{},"pyplines info development\u002Fexample\n",[200,253,254,257,258,261],{},[230,255,256],{},"--as"," supplies the installed name without changing the source Definition. If omitted, it defaults to the Definition's ",[230,259,260],{},"name",". Names are unique within an Environment.",[200,263,264],{},"Deployment resolves every Action and captures its contract and image digest. A registry tag changing later does not silently change an existing revision.",[209,266,268],{"id":267},"update-and-inspect-revisions","Update and inspect revisions",[200,270,271],{},"Deploying to an existing name creates another revision. The CLI reads the current revision before submitting an update. For an explicit concurrency check, pass the revision you expect to replace:",[222,273,275],{"className":224,"code":274,"filename":226,"language":227,"meta":228,"style":228},"pyplines deploy .\u002Fworkflow.yaml --environment development --as example --revision 1\npyplines history development\u002Fexample\npyplines info development\u002Fexample --revision 1\npyplines export development\u002Fexample --revision 1 --output .\u002Foriginal.yaml\n",[230,276,277,282,287,292],{"__ignoreMap":228},[233,278,279],{"class":235,"line":236},[233,280,281],{},"pyplines deploy .\u002Fworkflow.yaml --environment development --as example --revision 1\n",[233,283,284],{"class":235,"line":242},[233,285,286],{},"pyplines history development\u002Fexample\n",[233,288,289],{"class":235,"line":248},[233,290,291],{},"pyplines info development\u002Fexample --revision 1\n",[233,293,295],{"class":235,"line":294},4,[233,296,297],{},"pyplines export development\u002Fexample --revision 1 --output .\u002Foriginal.yaml\n",[200,299,300,301,304],{},"The update fails if another deployment has changed the expected revision. Use ",[230,302,303],{},"--revision 0"," when you require a new installation. Export writes the portable Definition, not execution evidence, and refuses to overwrite an existing output file.",[209,306,308],{"id":307},"start-a-run","Start a Run",[222,310,312],{"className":224,"code":311,"filename":226,"language":227,"meta":228,"style":228},"pyplines run start development\u002Fexample --inputs .\u002Finputs.json --wait\n",[230,313,314],{"__ignoreMap":228},[233,315,316],{"class":235,"line":236},[233,317,311],{},[200,319,320,321,324,325,328],{},"Omit ",[230,322,323],{},"--inputs"," if no inputs are required. By default the Run captures the latest revision; ",[230,326,327],{},"--revision 1"," explicitly selects an older one. Existing Runs retain their revision when a new version is deployed.",[200,330,331,334,335,338],{},[230,332,333],{},"--wait"," observes execution, including approval waits, with a default timeout of 1,800 seconds. ",[230,336,337],{},"--timeout"," changes the local wait limit. A timeout stops observation, not execution; do not start another Run merely because the wait ended.",[209,340,342],{"id":341},"repeat-requests-safely","Repeat requests safely",[200,344,345,346,349],{},"Deployment and Run creation accept ",[230,347,348],{},"--key"," for an idempotency key. Automation should persist a unique key for one logical request and reuse it only to retry that same request after an uncertain response. Reusing a key with changed content or a different actor is rejected. Creating a new key requests new work.",[209,351,353],{"id":352},"promote-a-procedure","Promote a procedure",[200,355,356],{},"Deploy the same reviewed Definition into another Environment, with that Environment's registry, context, secrets, platform, and policies configured separately. Deployment resolves Actions again for that target. Verify its resulting digests; the same version label in two registries is not proof of identical content.",[200,358,359,360,363,364,367],{},"Use ",[217,361,362],{"href":88},"monitoring"," to follow execution and ",[217,365,366],{"href":96},"recovery"," when a Run cannot proceed.",[369,370,371],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":228,"searchDepth":242,"depth":242,"links":373},[374,375,376,377,378],{"id":211,"depth":242,"text":212},{"id":267,"depth":242,"text":268},{"id":307,"depth":242,"text":308},{"id":341,"depth":242,"text":342},{"id":352,"depth":242,"text":353},"Manage installed Definitions, revisions, and Run inputs.","md",{},true,{"title":74,"description":379},"eGYHulDs0FGGbFRRrWj1i0GrPQ_BW1GNiONmOwY30nc",[386,388],{"title":70,"path":71,"stem":72,"description":387,"children":-1},"Compose existing Actions into a portable operational workflow.",{"title":78,"path":79,"stem":80,"description":389,"children":-1},"Bind operational parameters and environment-specific values without embedding credentials in YAML.",1792213697350]