[{"data":1,"prerenderedAt":1655},["ShallowReactive",2],{"navigation":3,"\u002Fautomate\u002Fguides\u002Fdeploy-a-workflow":750,"\u002Fautomate\u002Fguides\u002Fdeploy-a-workflow-surround":1650},[4,80,134,364,428,530,567,646],{"title":5,"path":6,"stem":7,"children":8,"page":42},"Get Started","\u002Fget-started","01.get-started",[9,13,17,43,47],{"title":10,"path":11,"stem":12},"Welcome to UniteLabs","\u002Fget-started\u002Fwelcome","01.get-started\u002F00.welcome",{"title":14,"path":15,"stem":16},"How it works","\u002Fget-started\u002Fhow-it-works","01.get-started\u002F01.how-it-works",{"title":18,"path":19,"stem":20,"children":21,"page":42},"Use Cases","\u002Fget-started\u002Fuse-cases","01.get-started\u002F02.use-cases",[22,26,30,34,38],{"title":23,"path":24,"stem":25},"Instrument Control","\u002Fget-started\u002Fuse-cases\u002Flow-level-instrument-control","01.get-started\u002F02.use-cases\u002F10.low-level-instrument-control",{"title":27,"path":28,"stem":29},"Multi-device Control","\u002Fget-started\u002Fuse-cases\u002Fmulti-device-control","01.get-started\u002F02.use-cases\u002F20.multi-device-control",{"title":31,"path":32,"stem":33},"Workflow Orchestration","\u002Fget-started\u002Fuse-cases\u002Fworkflow-orchestration","01.get-started\u002F02.use-cases\u002F30.workflow-orchestration",{"title":35,"path":36,"stem":37},"Custom Apps and LIMS Integration","\u002Fget-started\u002Fuse-cases\u002Fcustom-apps-lims","01.get-started\u002F02.use-cases\u002F40.custom-apps-lims",{"title":39,"path":40,"stem":41},"Scale and Fleet Management","\u002Fget-started\u002Fuse-cases\u002Fscale-and-fleet","01.get-started\u002F02.use-cases\u002F50.scale-and-fleet",false,{"title":44,"path":45,"stem":46},"Lab as Code","\u002Fget-started\u002Fwhy-code","01.get-started\u002F03.why-code",{"title":48,"path":49,"stem":50,"children":51,"page":42},"Setup","\u002Fget-started\u002Fsetup","01.get-started\u002F20.setup",[52,56,60,64,68,72,76],{"title":53,"path":54,"stem":55},"GroundControl","\u002Fget-started\u002Fsetup\u002Fgroundcontrol","01.get-started\u002F20.setup\u002F10.groundcontrol",{"title":57,"path":58,"stem":59},"Network requirements","\u002Fget-started\u002Fsetup\u002Fnetwork-requirements","01.get-started\u002F20.setup\u002F20.network-requirements",{"title":61,"path":62,"stem":63},"Multi-device Networking","\u002Fget-started\u002Fsetup\u002Fmultiple-devices","01.get-started\u002F20.setup\u002F30.multiple-devices",{"title":65,"path":66,"stem":67},"Connect to Platform","\u002Fget-started\u002Fsetup\u002Fconnect-to-platform","01.get-started\u002F20.setup\u002F40.connect-to-platform",{"title":69,"path":70,"stem":71},"Headless install","\u002Fget-started\u002Fsetup\u002Fheadless-install","01.get-started\u002F20.setup\u002F50.headless-install",{"title":73,"path":74,"stem":75},"Raspberry Pi","\u002Fget-started\u002Fsetup\u002Fraspberry-pi","01.get-started\u002F20.setup\u002F55.raspberry-pi",{"title":77,"path":78,"stem":79},"Installation","\u002Fget-started\u002Fsetup\u002Fsdk-installation","01.get-started\u002F20.setup\u002F60.sdk-installation",{"title":81,"path":82,"stem":83,"children":84,"page":42},"Integrate","\u002Fintegrate","02.integrate",[85,89,93,118],{"title":86,"path":87,"stem":88},"What is a connector?","\u002Fintegrate\u002Fwhat-is-a-connector","02.integrate\u002F00.what-is-a-connector",{"title":90,"path":91,"stem":92},"Calling a Connector","\u002Fintegrate\u002Fcontrol-with-code","02.integrate\u002F05.control-with-code",{"title":94,"path":95,"stem":96,"children":97,"page":42},"Concepts","\u002Fintegrate\u002Fconcepts","02.integrate\u002F10.concepts",[98,102,106,110,114],{"title":99,"path":100,"stem":101},"Connector","\u002Fintegrate\u002Fconcepts\u002Fconnector","02.integrate\u002F10.concepts\u002F10.connector",{"title":103,"path":104,"stem":105},"Module","\u002Fintegrate\u002Fconcepts\u002Fmodule","02.integrate\u002F10.concepts\u002F20.module",{"title":107,"path":108,"stem":109},"Action","\u002Fintegrate\u002Fconcepts\u002Faction","02.integrate\u002F10.concepts\u002F30.action",{"title":111,"path":112,"stem":113},"Subscription","\u002Fintegrate\u002Fconcepts\u002Fsubscription","02.integrate\u002F10.concepts\u002F40.subscription",{"title":115,"path":116,"stem":117},"Device","\u002Fintegrate\u002Fconcepts\u002Fdevice","02.integrate\u002F10.concepts\u002F50.device",{"title":119,"path":120,"stem":121,"children":122,"page":42},"Use a connector","\u002Fintegrate\u002Fuse-a-connector","02.integrate\u002F30.use-a-connector",[123,126,130],{"title":53,"path":124,"stem":125},"\u002Fintegrate\u002Fuse-a-connector\u002Fgroundcontrol","02.integrate\u002F30.use-a-connector\u002F10.groundcontrol",{"title":127,"path":128,"stem":129},"Platform","\u002Fintegrate\u002Fuse-a-connector\u002Fplatform","02.integrate\u002F30.use-a-connector\u002F20.platform",{"title":131,"path":132,"stem":133},"UniteLabs SDK & REST API","\u002Fintegrate\u002Fuse-a-connector\u002Fpython","02.integrate\u002F30.use-a-connector\u002F30.python",{"title":135,"path":136,"stem":137,"children":138,"page":42},"Operate","\u002Foperate","03.operate",[139,142,146,186,259],{"title":135,"path":140,"stem":141},"\u002Foperate\u002Foverview","03.operate\u002F00.overview",{"title":143,"path":144,"stem":145},"Your First Protocol","\u002Foperate\u002Fyour-first-protocol","03.operate\u002F05.your-first-protocol",{"title":94,"path":147,"stem":148,"children":149,"page":42},"\u002Foperate\u002Fconcepts","03.operate\u002F10.concepts",[150,154,158,162,166,170,174,178,182],{"title":151,"path":152,"stem":153},"Liquid Handling","\u002Foperate\u002Fconcepts\u002Fliquid-handling","03.operate\u002F10.concepts\u002F10.liquid-handling",{"title":155,"path":156,"stem":157},"Modules","\u002Foperate\u002Fconcepts\u002Fmodules","03.operate\u002F10.concepts\u002F20.modules",{"title":159,"path":160,"stem":161},"Deck","\u002Foperate\u002Fconcepts\u002Fdeck","03.operate\u002F10.concepts\u002F30.deck",{"title":163,"path":164,"stem":165},"Labware","\u002Foperate\u002Fconcepts\u002Flabware","03.operate\u002F10.concepts\u002F40.labware",{"title":167,"path":168,"stem":169},"Liquids","\u002Foperate\u002Fconcepts\u002Fliquids","03.operate\u002F10.concepts\u002F50.liquids",{"title":171,"path":172,"stem":173},"Liquid Classes","\u002Foperate\u002Fconcepts\u002Fliquid-classes","03.operate\u002F10.concepts\u002F60.liquid-classes",{"title":175,"path":176,"stem":177},"Tips and Tip Tracking","\u002Foperate\u002Fconcepts\u002Ftips","03.operate\u002F10.concepts\u002F70.tips",{"title":179,"path":180,"stem":181},"Simulation","\u002Foperate\u002Fconcepts\u002Fsimulation","03.operate\u002F10.concepts\u002F80.simulation",{"title":183,"path":184,"stem":185},"Error Handling","\u002Foperate\u002Fconcepts\u002Ferror-handling","03.operate\u002F10.concepts\u002F90.error-handling",{"title":187,"path":188,"stem":189,"children":190,"page":42},"Guides","\u002Foperate\u002Fguides","03.operate\u002F20.guides",[191,220,232,256],{"title":163,"path":192,"stem":193,"children":194},"\u002Foperate\u002Fguides\u002Flabware","03.operate\u002F20.guides\u002F10.labware\u002Findex",[195,196,200,204,208,212,216],{"title":163,"path":192,"stem":193},{"title":197,"path":198,"stem":199},"Standard Labware","\u002Foperate\u002Fguides\u002Flabware\u002Fstandard-labware","03.operate\u002F20.guides\u002F10.labware\u002F05.standard-labware",{"title":201,"path":202,"stem":203},"Plates","\u002Foperate\u002Fguides\u002Flabware\u002Fplates","03.operate\u002F20.guides\u002F10.labware\u002F10.plates",{"title":205,"path":206,"stem":207},"Tips and Tip Racks","\u002Foperate\u002Fguides\u002Flabware\u002Ftips-and-racks","03.operate\u002F20.guides\u002F10.labware\u002F20.tips-and-racks",{"title":209,"path":210,"stem":211},"Tubes and Tube Racks","\u002Foperate\u002Fguides\u002Flabware\u002Ftubes-and-tube-racks","03.operate\u002F20.guides\u002F10.labware\u002F30.tubes-and-tube-racks",{"title":213,"path":214,"stem":215},"Troughs","\u002Foperate\u002Fguides\u002Flabware\u002Ftroughs","03.operate\u002F20.guides\u002F10.labware\u002F35.troughs",{"title":217,"path":218,"stem":219},"Carriers and Adapters","\u002Foperate\u002Fguides\u002Flabware\u002Fcarriers-and-adapters","03.operate\u002F20.guides\u002F10.labware\u002F40.carriers-and-adapters",{"title":159,"path":221,"stem":222,"children":223,"page":42},"\u002Foperate\u002Fguides\u002Fdeck","03.operate\u002F20.guides\u002F20.deck",[224,228],{"title":225,"path":226,"stem":227},"Building a Deck","\u002Foperate\u002Fguides\u002Fdeck\u002Fbuilding-a-deck","03.operate\u002F20.guides\u002F20.deck\u002F10.building-a-deck",{"title":229,"path":230,"stem":231},"Save\u002FLoad a Deck","\u002Foperate\u002Fguides\u002Fdeck\u002Fsave-load-deck","03.operate\u002F20.guides\u002F20.deck\u002F20.save-load-deck",{"title":233,"path":234,"stem":235,"children":236,"page":42},"Pipetting","\u002Foperate\u002Fguides\u002Fpipetting","03.operate\u002F20.guides\u002F30.pipetting",[237,241,245,249,252],{"title":238,"path":239,"stem":240},"Basic Pipetting","\u002Foperate\u002Fguides\u002Fpipetting\u002Fbasic-pipetting","03.operate\u002F20.guides\u002F30.pipetting\u002F10.basic-pipetting",{"title":242,"path":243,"stem":244},"Advanced Pipetting","\u002Foperate\u002Fguides\u002Fpipetting\u002Fadvanced-pipetting","03.operate\u002F20.guides\u002F30.pipetting\u002F20.advanced-pipetting",{"title":246,"path":247,"stem":248},"Tip Handling","\u002Foperate\u002Fguides\u002Fpipetting\u002Ftip-handling","03.operate\u002F20.guides\u002F30.pipetting\u002F30.tip-handling",{"title":171,"path":250,"stem":251},"\u002Foperate\u002Fguides\u002Fpipetting\u002Fliquid-classes","03.operate\u002F20.guides\u002F30.pipetting\u002F40.liquid-classes",{"title":253,"path":254,"stem":255},"Labware Transport","\u002Foperate\u002Fguides\u002Fpipetting\u002Flabware-transport","03.operate\u002F20.guides\u002F30.pipetting\u002F50.labware-transport",{"title":179,"path":257,"stem":258},"\u002Foperate\u002Fguides\u002Fsimulation","03.operate\u002F20.guides\u002F40.simulation",{"title":260,"path":261,"stem":262,"children":263,"page":42},"Liquid Handler Guides","\u002Foperate\u002Fdevices","03.operate\u002F30.devices",[264,305,330,347],{"title":265,"path":266,"stem":267,"children":268,"page":42},"Hamilton STAR","\u002Foperate\u002Fdevices\u002Fhamilton-star","03.operate\u002F30.devices\u002F10.hamilton-star",[269,273,277,281,285,289,293,297,301],{"title":270,"path":271,"stem":272},"Positioning & Movement","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fpositioning","03.operate\u002F30.devices\u002F10.hamilton-star\u002F10.positioning",{"title":274,"path":275,"stem":276},"Gripper Module","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fcore-gripper","03.operate\u002F30.devices\u002F10.hamilton-star\u002F20.core-gripper",{"title":278,"path":279,"stem":280},"iSWAP Module","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fiswap","03.operate\u002F30.devices\u002F10.hamilton-star\u002F30.iswap",{"title":282,"path":283,"stem":284},"Using TADM","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Ftadm","03.operate\u002F30.devices\u002F10.hamilton-star\u002F40.tadm",{"title":286,"path":287,"stem":288},"Autoload Module","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fautoload","03.operate\u002F30.devices\u002F10.hamilton-star\u002F50.autoload",{"title":290,"path":291,"stem":292},"Waste Block","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fwaste-block","03.operate\u002F30.devices\u002F10.hamilton-star\u002F60.waste-block",{"title":294,"path":295,"stem":296},"Complex Mixing","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fcomplex-mixing","03.operate\u002F30.devices\u002F10.hamilton-star\u002F66.complex-mixing",{"title":298,"path":299,"stem":300},"Teaching Gripper Paddle Positions","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fgripper-positions","03.operate\u002F30.devices\u002F10.hamilton-star\u002F70.gripper-positions",{"title":302,"path":303,"stem":304},"Training a Custom Deck Position With the iSWAP","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fcustom-deck-position","03.operate\u002F30.devices\u002F10.hamilton-star\u002F75.custom-deck-position",{"title":306,"path":307,"stem":308,"children":309,"page":42},"Hamilton Vantage","\u002Foperate\u002Fdevices\u002Fhamilton-vantage","03.operate\u002F30.devices\u002F20.hamilton-vantage",[310,314,318,322,326],{"title":311,"path":312,"stem":313},"Waste Configuration","\u002Foperate\u002Fdevices\u002Fhamilton-vantage\u002Fwaste-configuration","03.operate\u002F30.devices\u002F20.hamilton-vantage\u002F05.waste-configuration",{"title":315,"path":316,"stem":317},"Covers and Lights","\u002Foperate\u002Fdevices\u002Fhamilton-vantage\u002Fcovers-and-lights","03.operate\u002F30.devices\u002F20.hamilton-vantage\u002F10.covers-and-lights",{"title":319,"path":320,"stem":321},"IDL Module","\u002Foperate\u002Fdevices\u002Fhamilton-vantage\u002Fidl","03.operate\u002F30.devices\u002F20.hamilton-vantage\u002F20.idl",{"title":323,"path":324,"stem":325},"IPG Module","\u002Foperate\u002Fdevices\u002Fhamilton-vantage\u002Fipg","03.operate\u002F30.devices\u002F20.hamilton-vantage\u002F30.ipg",{"title":327,"path":328,"stem":329},"XL Pipettes","\u002Foperate\u002Fdevices\u002Fhamilton-vantage\u002Fxl-channels","03.operate\u002F30.devices\u002F20.hamilton-vantage\u002F40.xl-channels",{"title":331,"path":332,"stem":333,"children":334,"page":42},"Agilent Bravo","\u002Foperate\u002Fdevices\u002Fagilent-bravo","03.operate\u002F30.devices\u002F30.agilent-bravo",[335,338,341,344],{"title":246,"path":336,"stem":337},"\u002Foperate\u002Fdevices\u002Fagilent-bravo\u002Ftip-handling","03.operate\u002F30.devices\u002F30.agilent-bravo\u002F10.tip-handling",{"title":238,"path":339,"stem":340},"\u002Foperate\u002Fdevices\u002Fagilent-bravo\u002Fbasic-pipetting","03.operate\u002F30.devices\u002F30.agilent-bravo\u002F20.basic-pipetting",{"title":171,"path":342,"stem":343},"\u002Foperate\u002Fdevices\u002Fagilent-bravo\u002Fliquid-classes","03.operate\u002F30.devices\u002F30.agilent-bravo\u002F25.liquid-classes",{"title":274,"path":345,"stem":346},"\u002Foperate\u002Fdevices\u002Fagilent-bravo\u002Fusing-the-gripper","03.operate\u002F30.devices\u002F30.agilent-bravo\u002F30.using-the-gripper",{"title":348,"path":349,"stem":350,"children":351,"page":42},"Tecan FluentControl","\u002Foperate\u002Fdevices\u002Ftecan-fluentcontrol","03.operate\u002F30.devices\u002F40.tecan-fluentcontrol",[352,356,360],{"title":353,"path":354,"stem":355},"Connect & Run a Method","\u002Foperate\u002Fdevices\u002Ftecan-fluentcontrol\u002Fconnect-and-run","03.operate\u002F30.devices\u002F40.tecan-fluentcontrol\u002F10.connect-and-run",{"title":357,"path":358,"stem":359},"Sending XML Commands","\u002Foperate\u002Fdevices\u002Ftecan-fluentcontrol\u002Fsending-xml-commands","03.operate\u002F30.devices\u002F40.tecan-fluentcontrol\u002F20.sending-xml-commands",{"title":361,"path":362,"stem":363},"Full Workflow Example","\u002Foperate\u002Fdevices\u002Ftecan-fluentcontrol\u002Ffull-workflow-example","03.operate\u002F30.devices\u002F40.tecan-fluentcontrol\u002F30.full-workflow-example",{"title":365,"path":366,"stem":367,"children":368,"page":42},"Device Guides","\u002Fdevice-guides","06.device-guides",[369,372,385,402,415],{"title":365,"path":370,"stem":371},"\u002Fdevice-guides\u002Foverview","06.device-guides\u002F00.overview",{"title":373,"path":374,"stem":375,"children":376,"page":42},"Incubation","\u002Fdevice-guides\u002Fincubation","06.device-guides\u002F20.incubation",[377,381],{"title":378,"path":379,"stem":380},"Inheco ODTC","\u002Fdevice-guides\u002Fincubation\u002Finheco-odtc","06.device-guides\u002F20.incubation\u002F10.inheco-odtc",{"title":382,"path":383,"stem":384},"Inheco SCILA","\u002Fdevice-guides\u002Fincubation\u002Finheco-scila","06.device-guides\u002F20.incubation\u002F20.inheco-scila",{"title":386,"path":387,"stem":388,"children":389,"page":42},"Heater-Shakers","\u002Fdevice-guides\u002Fheater-shakers","06.device-guides\u002F30.heater-shakers",[390,394,398],{"title":391,"path":392,"stem":393},"Inheco Thermoshake","\u002Fdevice-guides\u002Fheater-shakers\u002Finheco-thermoshake","06.device-guides\u002F30.heater-shakers\u002F10.inheco-thermoshake",{"title":395,"path":396,"stem":397},"QInstruments Bioshake","\u002Fdevice-guides\u002Fheater-shakers\u002Fqinstruments-bioshake","06.device-guides\u002F30.heater-shakers\u002F20.qinstruments-bioshake",{"title":399,"path":400,"stem":401},"QInstruments ColdPlate","\u002Fdevice-guides\u002Fheater-shakers\u002Fqinstruments-coldplate","06.device-guides\u002F30.heater-shakers\u002F30.qinstruments-coldplate",{"title":403,"path":404,"stem":405,"children":406,"page":42},"Readers","\u002Fdevice-guides\u002Freaders","06.device-guides\u002F40.readers",[407,411],{"title":408,"path":409,"stem":410},"Biotek Gen5","\u002Fdevice-guides\u002Freaders\u002Fbiotek-gen5","06.device-guides\u002F40.readers\u002F10.biotek-gen5",{"title":412,"path":413,"stem":414},"Biotek Synergy H1","\u002Fdevice-guides\u002Freaders\u002Fbiotek-synergy-h1","06.device-guides\u002F40.readers\u002F20.biotek-synergy-H1",{"title":416,"path":417,"stem":418,"children":419,"page":42},"Tilt & Turn","\u002Fdevice-guides\u002Ftilt-and-turn","06.device-guides\u002F50.tilt-and-turn",[420,424],{"title":421,"path":422,"stem":423},"TurnStation","\u002Fdevice-guides\u002Ftilt-and-turn\u002Fqinstruments-turnstation","06.device-guides\u002F50.tilt-and-turn\u002F10.qinstruments-turnstation",{"title":425,"path":426,"stem":427},"TiltStation","\u002Fdevice-guides\u002Ftilt-and-turn\u002Fqinstruments-tiltstation","06.device-guides\u002F50.tilt-and-turn\u002F20.qinstruments-tiltstation",{"title":429,"path":430,"stem":431,"children":432,"page":42},"Automate","\u002Fautomate","07.automate",[433,437,441,445,494],{"title":434,"path":435,"stem":436},"What is a workflow?","\u002Fautomate\u002Fwhat-is-a-workflow","07.automate\u002F00.what-is-a-workflow",{"title":438,"path":439,"stem":440},"Workflow template","\u002Fautomate\u002Fworkflow-template","07.automate\u002F05.workflow-template",{"title":442,"path":443,"stem":444},"Your First Workflow","\u002Fautomate\u002Fyour-first-workflow","07.automate\u002F08.your-first-workflow",{"title":94,"pages":446,"path":456,"stem":457,"children":458,"page":42},[447,448,449,450,451,452,453,454,455],"workflow","phase","step","runs","input","artifacts","logs","human-in-the-loop","error-handling","\u002Fautomate\u002Fconcepts","07.automate\u002F10.concepts",[459,463,467,471,475,479,483,487,491],{"title":460,"path":461,"stem":462},"Workflow","\u002Fautomate\u002Fconcepts\u002Fworkflow","07.automate\u002F10.concepts\u002F10.workflow",{"title":464,"path":465,"stem":466},"Phase","\u002Fautomate\u002Fconcepts\u002Fphase","07.automate\u002F10.concepts\u002F20.phase",{"title":468,"path":469,"stem":470},"Step","\u002Fautomate\u002Fconcepts\u002Fstep","07.automate\u002F10.concepts\u002F30.step",{"title":472,"path":473,"stem":474},"Runs","\u002Fautomate\u002Fconcepts\u002Fruns","07.automate\u002F10.concepts\u002F40.runs",{"title":476,"path":477,"stem":478},"Input","\u002Fautomate\u002Fconcepts\u002Finput","07.automate\u002F10.concepts\u002F50.input",{"title":480,"path":481,"stem":482},"Artifacts","\u002Fautomate\u002Fconcepts\u002Fartifacts","07.automate\u002F10.concepts\u002F60.artifacts",{"title":484,"path":485,"stem":486},"Logs","\u002Fautomate\u002Fconcepts\u002Flogs","07.automate\u002F10.concepts\u002F70.logs",{"title":488,"path":489,"stem":490},"Human in the Loop","\u002Fautomate\u002Fconcepts\u002Fhuman-in-the-loop","07.automate\u002F10.concepts\u002F80.human-in-the-loop",{"title":183,"path":492,"stem":493},"\u002Fautomate\u002Fconcepts\u002Ferror-handling","07.automate\u002F10.concepts\u002F90.error-handling",{"title":187,"path":495,"stem":496,"children":497,"page":42},"\u002Fautomate\u002Fguides","07.automate\u002F25.guides",[498,502,506,510,514,518,522,526],{"title":499,"path":500,"stem":501},"Deploy a workflow","\u002Fautomate\u002Fguides\u002Fdeploy-a-workflow","07.automate\u002F25.guides\u002F30.deploy-a-workflow",{"title":503,"path":504,"stem":505},"Run a workflow","\u002Fautomate\u002Fguides\u002Frun-a-workflow","07.automate\u002F25.guides\u002F35.run-a-workflow",{"title":507,"path":508,"stem":509},"CI\u002FCD for workflows","\u002Fautomate\u002Fguides\u002Fcicd-for-workflows","07.automate\u002F25.guides\u002F40.cicd-for-workflows",{"title":511,"path":512,"stem":513},"HITL basics","\u002Fautomate\u002Fguides\u002Fbasic-hitl","07.automate\u002F25.guides\u002F50.basic-hitl",{"title":515,"path":516,"stem":517},"Typed operator inputs","\u002Fautomate\u002Fguides\u002Ftyped-operator-inputs","07.automate\u002F25.guides\u002F55.typed-operator-inputs",{"title":519,"path":520,"stem":521},"Error recovery","\u002Fautomate\u002Fguides\u002Fbasic-error-handling","07.automate\u002F25.guides\u002F60.basic-error-handling",{"title":523,"path":524,"stem":525},"Advanced error handling","\u002Fautomate\u002Fguides\u002Fadvanced-error-handling","07.automate\u002F25.guides\u002F70.advanced-error-handling",{"title":527,"path":528,"stem":529},"Workflows REST API","\u002Fautomate\u002Fguides\u002Fworkflows-api","07.automate\u002F25.guides\u002F80.workflows-api",{"title":531,"path":532,"stem":533,"children":534,"page":42},"Observe","\u002Fobserve","08.observe",[535,539,555],{"title":536,"path":537,"stem":538},"Overview","\u002Fobserve\u002Foverview","08.observe\u002F10.overview",{"title":94,"path":540,"stem":541,"children":542,"page":42},"\u002Fobserve\u002Fconcepts","08.observe\u002F20.concepts",[543,547,551],{"title":544,"path":545,"stem":546},"Object Storage","\u002Fobserve\u002Fconcepts\u002Fstorage","08.observe\u002F20.concepts\u002F10.storage",{"title":548,"path":549,"stem":550},"Secrets","\u002Fobserve\u002Fconcepts\u002Fsecrets","08.observe\u002F20.concepts\u002F20.secrets",{"title":552,"path":553,"stem":554},"Data sources","\u002Fobserve\u002Fconcepts\u002Fdata-sources","08.observe\u002F20.concepts\u002F30.data-sources",{"title":187,"path":556,"stem":557,"children":558,"page":42},"\u002Fobserve\u002Fguides","08.observe\u002F30.guides",[559,563],{"title":560,"path":561,"stem":562},"File System Connector","\u002Fobserve\u002Fguides\u002Ffilesystem-connector","08.observe\u002F30.guides\u002F10.filesystem-connector",{"title":564,"path":565,"stem":566},"Building an ETL","\u002Fobserve\u002Fguides\u002Fbuilding-an-etl","08.observe\u002F30.guides\u002F20.building-an-etl",{"title":568,"path":569,"stem":570,"children":571,"page":42},"Technical Reference","\u002Ftechnical-reference","10.technical-reference",[572,576,580,592,603,614,624,635],{"title":573,"path":574,"stem":575},"Introduction","\u002Ftechnical-reference\u002Fplatform-blueprint","10.technical-reference\u002F00.platform-blueprint",{"title":577,"path":578,"stem":579},"REST API","\u002Ftechnical-reference\u002Frest-api","10.technical-reference\u002F01.rest-api",{"title":53,"path":581,"stem":582,"children":583,"page":42},"\u002Ftechnical-reference\u002Fgroundcontrol","10.technical-reference\u002F10.groundcontrol",[584,588],{"title":585,"path":586,"stem":587},"Install & Setup","\u002Ftechnical-reference\u002Fgroundcontrol\u002Finstall","10.technical-reference\u002F10.groundcontrol\u002F10.install",{"title":589,"path":590,"stem":591},"Changelog","\u002Ftechnical-reference\u002Fgroundcontrol\u002Fchangelog","10.technical-reference\u002F10.groundcontrol\u002F20.changelog",{"title":593,"path":594,"stem":595,"children":596,"page":42},"UniteLabs SDK","\u002Ftechnical-reference\u002Fpython-sdk","10.technical-reference\u002F20.python-sdk",[597,600],{"title":585,"path":598,"stem":599},"\u002Ftechnical-reference\u002Fpython-sdk\u002Finstall","10.technical-reference\u002F20.python-sdk\u002F10.install",{"title":589,"path":601,"stem":602},"\u002Ftechnical-reference\u002Fpython-sdk\u002Fchangelog","10.technical-reference\u002F20.python-sdk\u002F20.changelog",{"title":604,"path":605,"stem":606,"children":607,"page":42},"Liquid Handling SDK","\u002Ftechnical-reference\u002Fpython-liquid-handling-sdk","10.technical-reference\u002F30.python-liquid-handling-sdk",[608,611],{"title":585,"path":609,"stem":610},"\u002Ftechnical-reference\u002Fpython-liquid-handling-sdk\u002Finstall","10.technical-reference\u002F30.python-liquid-handling-sdk\u002F10.install",{"title":589,"path":612,"stem":613},"\u002Ftechnical-reference\u002Fpython-liquid-handling-sdk\u002Fchangelog","10.technical-reference\u002F30.python-liquid-handling-sdk\u002F20.changelog",{"title":163,"path":615,"stem":616,"children":617,"page":42},"\u002Ftechnical-reference\u002Flabware","10.technical-reference\u002F40.labware",[618,621],{"title":585,"path":619,"stem":620},"\u002Ftechnical-reference\u002Flabware\u002Finstall","10.technical-reference\u002F40.labware\u002F10.install",{"title":589,"path":622,"stem":623},"\u002Ftechnical-reference\u002Flabware\u002Fchangelog","10.technical-reference\u002F40.labware\u002F20.changelog",{"title":625,"path":626,"stem":627,"children":628,"page":42},"Python Omnibus","\u002Ftechnical-reference\u002Fpython-omnibus","10.technical-reference\u002F50.python-omnibus",[629,632],{"title":585,"path":630,"stem":631},"\u002Ftechnical-reference\u002Fpython-omnibus\u002Finstall","10.technical-reference\u002F50.python-omnibus\u002F10.install",{"title":589,"path":633,"stem":634},"\u002Ftechnical-reference\u002Fpython-omnibus\u002Fchangelog","10.technical-reference\u002F50.python-omnibus\u002F20.changelog",{"title":636,"path":637,"stem":638,"children":639,"page":42},"Python CDK","\u002Ftechnical-reference\u002Fpython-cdk","10.technical-reference\u002F60.python-cdk",[640,643],{"title":585,"path":641,"stem":642},"\u002Ftechnical-reference\u002Fpython-cdk\u002Finstall","10.technical-reference\u002F60.python-cdk\u002F10.install",{"title":589,"path":644,"stem":645},"\u002Ftechnical-reference\u002Fpython-cdk\u002Fchangelog","10.technical-reference\u002F60.python-cdk\u002F20.changelog",{"title":647,"path":648,"stem":649,"children":650},"Connector Development (CDK)","\u002Fconnector-development","20.connector-development",[651,653,672,705,713,744],{"title":647,"path":648,"stem":652},"20.connector-development\u002Findex",{"title":654,"path":655,"stem":656,"children":657,"page":42},"Getting Started","\u002Fconnector-development\u002Fgetting-started","20.connector-development\u002F10.getting-started",[658,661,665,668],{"title":536,"path":659,"stem":660},"\u002Fconnector-development\u002Fgetting-started\u002Foverview","20.connector-development\u002F10.getting-started\u002F10.overview",{"title":662,"path":663,"stem":664},"What's new","\u002Fconnector-development\u002Fgetting-started\u002Fwhats-new","20.connector-development\u002F10.getting-started\u002F20.whats-new",{"title":77,"path":666,"stem":667},"\u002Fconnector-development\u002Fgetting-started\u002Finstallation","20.connector-development\u002F10.getting-started\u002F30.installation",{"title":669,"path":670,"stem":671},"Contributing","\u002Fconnector-development\u002Fgetting-started\u002Fcontributing","20.connector-development\u002F10.getting-started\u002F40.contributing",{"title":673,"path":674,"stem":675,"children":676,"page":42},"Tutorial","\u002Fconnector-development\u002Ftutorial","20.connector-development\u002F20.tutorial",[677,681,685,689,693,697,701],{"title":678,"path":679,"stem":680},"Walkthrough","\u002Fconnector-development\u002Ftutorial\u002Fwalkthrough","20.connector-development\u002F20.tutorial\u002F00.walkthrough",{"title":682,"path":683,"stem":684},"SiLA Endpoints","\u002Fconnector-development\u002Ftutorial\u002Fsila-endpoints","20.connector-development\u002F20.tutorial\u002F10.sila-endpoints",{"title":686,"path":687,"stem":688},"Data Endpoints","\u002Fconnector-development\u002Ftutorial\u002Fdata-endpoints","20.connector-development\u002F20.tutorial\u002F20.data-endpoints",{"title":690,"path":691,"stem":692},"Controls","\u002Fconnector-development\u002Ftutorial\u002Fcontrols","20.connector-development\u002F20.tutorial\u002F30.controls",{"title":694,"path":695,"stem":696},"SiLA Data Types","\u002Fconnector-development\u002Ftutorial\u002Fdata-types","20.connector-development\u002F20.tutorial\u002F40.data-types",{"title":698,"path":699,"stem":700},"Feature","\u002Fconnector-development\u002Ftutorial\u002Fconnector-structure","20.connector-development\u002F20.tutorial\u002F70.connector-structure",{"title":702,"path":703,"stem":704},"Hardware Communication","\u002Fconnector-development\u002Ftutorial\u002Fhardware-communication","20.connector-development\u002F20.tutorial\u002F90.hardware-communication",{"title":94,"path":706,"stem":707,"children":708,"page":42},"\u002Fconnector-development\u002Fconcepts","20.connector-development\u002F30.concepts",[709],{"title":710,"path":711,"stem":712},"SiLA","\u002Fconnector-development\u002Fconcepts\u002Fsila","20.connector-development\u002F30.concepts\u002Fsila",{"title":187,"path":714,"stem":715,"children":716,"page":42},"\u002Fconnector-development\u002Fguides","20.connector-development\u002F40.guides",[717,721,725,729,733,736,740],{"title":718,"path":719,"stem":720},"Configuration","\u002Fconnector-development\u002Fguides\u002Fconfiguration","20.connector-development\u002F40.guides\u002F20.configuration",{"title":722,"path":723,"stem":724},"Deployment","\u002Fconnector-development\u002Fguides\u002Fdeployment","20.connector-development\u002F40.guides\u002F30.deployment",{"title":726,"path":727,"stem":728},"Security","\u002Fconnector-development\u002Fguides\u002Fsecurity","20.connector-development\u002F40.guides\u002F40.security",{"title":730,"path":731,"stem":732},"Subscriptions","\u002Fconnector-development\u002Fguides\u002Fsubscriptions","20.connector-development\u002F40.guides\u002F45.subscriptions",{"title":183,"path":734,"stem":735},"\u002Fconnector-development\u002Fguides\u002Ferror-handling","20.connector-development\u002F40.guides\u002F50.error-handling",{"title":737,"path":738,"stem":739},"Serial Troubleshooting","\u002Fconnector-development\u002Fguides\u002Fserial-troubleshooting","20.connector-development\u002F40.guides\u002F70.serial-troubleshooting",{"title":741,"path":742,"stem":743},"Testing","\u002Fconnector-development\u002Fguides\u002Ftesting","20.connector-development\u002F40.guides\u002F80.testing",{"title":745,"path":746,"stem":747,"children":748},"References","\u002Fconnector-development\u002Freference","20.connector-development\u002F50.reference\u002Findex",[749],{"title":745,"path":746,"stem":747},{"id":751,"title":499,"body":752,"description":1643,"extension":1644,"links":1645,"meta":1646,"navigation":1647,"path":500,"seo":1648,"stem":501,"__hash__":1649},"docs\u002F07.automate\u002F25.guides\u002F30.deploy-a-workflow.md",{"type":753,"value":754,"toc":1627},"minimark",[755,770,776,833,838,849,941,952,965,969,988,991,1083,1087,1090,1095,1114,1125,1129,1145,1149,1168,1177,1202,1206,1225,1243,1247,1278,1288,1292,1348,1372,1384,1388,1414,1427,1431,1438,1528,1538,1559,1571,1575,1582,1585,1589,1623],[756,757,758,759,763,764,769],"p",{},"In this guide you will use the ",[760,761,762],"code",{},"scripts\u002Fdeploy.py"," CLI shipped with the ",[765,766,768],"a",{"href":767},"\u002Fautomate\u002Fworkflow-template\u002F","workflow template"," to bundle one (or every) workflow in your repo and register it with the UniteLabs platform.",[756,771,772],{},[773,774,775],"strong",{},"Prerequisites",[777,778,779,806,817],"ul",{},[780,781,782,783,785,786,789,790,793,794,797,798,801,802,805],"li",{},"A repo cloned (or scaffolded) from the ",[765,784,768],{"href":767},". Each top-level ",[760,787,788],{},"w*-*\u002F"," directory is a standalone workflow package with its own ",[760,791,792],{},"pyproject.toml"," declaring ",[760,795,796],{},"[project].name",", ",[760,799,800],{},"[project].version",", and ",[760,803,804],{},"[tool.unitelabs.workflow]"," metadata.",[780,807,808,816],{},[765,809,813],{"href":810,"rel":811},"https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002F",[812],"nofollow",[760,814,815],{},"uv"," (latest) and Python 3.12+.",[780,818,819,820,797,823,797,826,797,829,832],{},"UniteLabs API credentials: ",[760,821,822],{},"BASE_URL",[760,824,825],{},"AUTH_URL",[760,827,828],{},"CLIENT_ID",[760,830,831],{},"CLIENT_SECRET",".",[834,835,837],"h2",{"id":836},"store-your-credentials","Store your credentials",[756,839,840,841,844,845,848],{},"Copy ",[760,842,843],{},".env.example"," to ",[760,846,847],{},".env"," at the repo root and fill in the four values:",[850,851,856],"pre",{"className":852,"code":853,"filename":847,"language":854,"meta":855,"style":855},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","BASE_URL=https:\u002F\u002Fapi.\u003Cyour-tenant>.unitelabs.io\u002F\nAUTH_URL=https:\u002F\u002Fauth.\u003Cyour-tenant>.unitelabs.io\u002Frealms\u002F\u003Ctenant-id>\u002Fprotocol\u002Fopenid-connect\u002F\nCLIENT_ID=\u003Cyour-client-id>\nCLIENT_SECRET=\u003Cyour-client-secret>\n","bash","",[760,857,858,886,915,929],{"__ignoreMap":855},[859,860,863,866,870,874,877,880,883],"span",{"class":861,"line":862},"line",1,[859,864,822],{"class":865},"sTEyZ",[859,867,869],{"class":868},"sMK4o","=",[859,871,873],{"class":872},"sfazB","https:\u002F\u002Fapi.",[859,875,876],{"class":868},"\u003C",[859,878,879],{"class":872},"your-tenant",[859,881,882],{"class":868},">",[859,884,885],{"class":872},".unitelabs.io\u002F\n",[859,887,889,891,893,896,898,900,902,905,907,910,912],{"class":861,"line":888},2,[859,890,825],{"class":865},[859,892,869],{"class":868},[859,894,895],{"class":872},"https:\u002F\u002Fauth.",[859,897,876],{"class":868},[859,899,879],{"class":872},[859,901,882],{"class":868},[859,903,904],{"class":872},".unitelabs.io\u002Frealms\u002F",[859,906,876],{"class":868},[859,908,909],{"class":872},"tenant-id",[859,911,882],{"class":868},[859,913,914],{"class":872},"\u002Fprotocol\u002Fopenid-connect\u002F\n",[859,916,918,920,923,926],{"class":861,"line":917},3,[859,919,828],{"class":865},[859,921,922],{"class":868},"=\u003C",[859,924,925],{"class":872},"your-client-id",[859,927,928],{"class":868},">\n",[859,930,932,934,936,939],{"class":861,"line":931},4,[859,933,831],{"class":865},[859,935,922],{"class":868},[859,937,938],{"class":872},"your-client-secret",[859,940,928],{"class":868},[756,942,943,945,946,948,949,832],{},[760,944,762],{}," loads ",[760,947,847],{}," automatically when run locally. CI\u002FCD pipelines set the same four variables as platform secrets — see ",[765,950,507],{"href":951},"\u002Fautomate\u002Fguides\u002Fcicd-for-workflows\u002F",[953,954,956],"callout",{"icon":955},"i-heroicons-shield-exclamation",[756,957,958,960,961,964],{},[760,959,847],{}," is in the template's ",[760,962,963],{},".gitignore",". Never commit credentials.",[834,966,968],{"id":967},"what-the-deploy-script-does","What the deploy script does",[756,970,971,973,974,797,977,980,981,984,985,987],{},[760,972,762],{}," is a PEP-723 single-file CLI — its own dependencies (",[760,975,976],{},"requests",[760,978,979],{},"python-dotenv",") are declared inline so ",[760,982,983],{},"uv run scripts\u002Fdeploy.py …"," resolves them into an ephemeral env. There is no project-level ",[760,986,792],{}," at the repo root.",[756,989,990],{},"For each workflow you deploy it:",[992,993,994,1011,1029,1053,1059,1069],"ol",{},[780,995,996,999,1000,1003,1004,1006,1007,1010],{},[773,997,998],{},"Discovers the workflow"," by globbing ",[760,1001,1002],{},"w*-*\u002Fpyproject.toml"," and matching ",[760,1005,796],{}," (the ",[773,1008,1009],{},"slug",").",[780,1012,1013,1016,1017,1020,1021,1024,1025,1028],{},[773,1014,1015],{},"Builds a bundle"," as a zip with the workflow directory verbatim plus the ",[760,1018,1019],{},"shared\u002F"," library flat-vendored at the bundle root, so ",[760,1022,1023],{},"import shared.steps.X"," resolves on the platform without ",[760,1026,1027],{},"sys.path"," tricks.",[780,1030,1031,1034,1035,1038,1039,1042,1043,1045,1046,1048,1049,1052],{},[773,1032,1033],{},"Stitches install-time dependencies"," from the workflow's ",[760,1036,1037],{},"[project].dependencies"," + ",[760,1040,1041],{},"shared","'s ",[760,1044,1037],{}," (deduped, workflow wins, the local ",[760,1047,1041],{}," entry dropped) and sends the merged list to the platform's ",[760,1050,1051],{},"dependencies"," field. The platform installs the runtime venv from this list.",[780,1054,1055,1058],{},[773,1056,1057],{},"Authenticates"," with OAuth2 client credentials.",[780,1060,1061,1064,1065,1068],{},[773,1062,1063],{},"Looks up the workflow"," by its ",[760,1066,1067],{},"display_name"," (paginated, client-side match). If found, PATCHes it; otherwise POSTs a new record. The lookup refuses to deploy on duplicate display names, so you can never silently overwrite the wrong record.",[780,1070,1071,1074,1075,1078,1079,1082],{},[773,1072,1073],{},"Patches metadata"," — description, tags, ",[760,1076,1077],{},"enabled: true"," — so a \"soft-deleted\" record (the UI delete only flips ",[760,1080,1081],{},"enabled=false",") is resurrected on redeploy rather than living on as a hidden duplicate.",[834,1084,1086],{"id":1085},"commands","Commands",[756,1088,1089],{},"All five forms are mutually exclusive; pick whichever fits your need.",[1091,1092,1094],"h3",{"id":1093},"deploy-a-single-workflow","Deploy a single workflow",[850,1096,1098],{"className":852,"code":1097,"language":854,"meta":855,"style":855},"uv run scripts\u002Fdeploy.py w03-liquid-handling\n",[760,1099,1100],{"__ignoreMap":855},[859,1101,1102,1105,1108,1111],{"class":861,"line":862},[859,1103,815],{"class":1104},"sBMFI",[859,1106,1107],{"class":872}," run",[859,1109,1110],{"class":872}," scripts\u002Fdeploy.py",[859,1112,1113],{"class":872}," w03-liquid-handling\n",[756,1115,1116,1117,1119,1120,1122,1123,832],{},"The positional argument is the workflow's ",[773,1118,1009],{}," — ",[760,1121,796],{}," in its ",[760,1124,792],{},[1091,1126,1128],{"id":1127},"deploy-every-workflow","Deploy every workflow",[850,1130,1132],{"className":852,"code":1131,"language":854,"meta":855,"style":855},"uv run scripts\u002Fdeploy.py --all\n",[760,1133,1134],{"__ignoreMap":855},[859,1135,1136,1138,1140,1142],{"class":861,"line":862},[859,1137,815],{"class":1104},[859,1139,1107],{"class":872},[859,1141,1110],{"class":872},[859,1143,1144],{"class":872}," --all\n",[1091,1146,1148],{"id":1147},"deploy-only-what-changed","Deploy only what changed",[850,1150,1152],{"className":852,"code":1151,"language":854,"meta":855,"style":855},"uv run scripts\u002Fdeploy.py --changed-from origin\u002Fmain\n",[760,1153,1154],{"__ignoreMap":855},[859,1155,1156,1158,1160,1162,1165],{"class":861,"line":862},[859,1157,815],{"class":1104},[859,1159,1107],{"class":872},[859,1161,1110],{"class":872},[859,1163,1164],{"class":872}," --changed-from",[859,1166,1167],{"class":872}," origin\u002Fmain\n",[756,1169,1170,1171,1174,1175,1010],{},"Runs ",[760,1172,1173],{},"git diff --name-only \u003Cref>..HEAD"," and deploys only the workflows whose directory was touched. Use it locally to preview what a merge would redeploy, or in CI on push-to-main (see ",[765,1176,507],{"href":951},[953,1178,1180],{"icon":1179},"i-heroicons-light-bulb",[756,1181,1182,1185,1186,1188,1189,1191,1192,1194,1195,1197,1198,1201],{},[773,1183,1184],{},"The \"everything affected\" rule."," A change under ",[760,1187,1019],{}," or to ",[760,1190,762],{}," itself marks every workflow as affected — ",[760,1193,1019],{}," is vendored into every bundle and ",[760,1196,762],{}," rewrites every bundle's contents. The rule lives in the Python helper ",[760,1199,1200],{},"affected_workflows()"," so it's testable and single-source.",[1091,1203,1205],{"id":1204},"deploy-a-tagged-release","Deploy a tagged release",[850,1207,1209],{"className":852,"code":1208,"language":854,"meta":855,"style":855},"uv run scripts\u002Fdeploy.py --git-tag w03-liquid-handling\u002Fv1.2.0\n",[760,1210,1211],{"__ignoreMap":855},[859,1212,1213,1215,1217,1219,1222],{"class":861,"line":862},[859,1214,815],{"class":1104},[859,1216,1107],{"class":872},[859,1218,1110],{"class":872},[859,1220,1221],{"class":872}," --git-tag",[859,1223,1224],{"class":872}," w03-liquid-handling\u002Fv1.2.0\n",[756,1226,1227,1228,1231,1232,1234,1235,1238,1239,1242],{},"Parses the tag (",[760,1229,1230],{},"\u003Cslug>\u002Fv\u003CX.Y.Z>","), verifies the workflow's ",[760,1233,800],{}," matches ",[760,1236,1237],{},"1.2.0",", and adds ",[760,1240,1241],{},"v1.2.0"," to the platform tags. Refuses to deploy if pyproject and tag disagree — the pyproject is the source of truth.",[1091,1244,1246],{"id":1245},"print-without-deploying","Print without deploying",[850,1248,1250],{"className":852,"code":1249,"language":854,"meta":855,"style":855},"uv run scripts\u002Fdeploy.py --list\nuv run scripts\u002Fdeploy.py --list --changed-from origin\u002Fmain\n",[760,1251,1252,1263],{"__ignoreMap":855},[859,1253,1254,1256,1258,1260],{"class":861,"line":862},[859,1255,815],{"class":1104},[859,1257,1107],{"class":872},[859,1259,1110],{"class":872},[859,1261,1262],{"class":872}," --list\n",[859,1264,1265,1267,1269,1271,1274,1276],{"class":861,"line":888},[859,1266,815],{"class":1104},[859,1268,1107],{"class":872},[859,1270,1110],{"class":872},[859,1272,1273],{"class":872}," --list",[859,1275,1164],{"class":872},[859,1277,1167],{"class":872},[756,1279,1280,1281,1284,1285,1287],{},"Prints the selected slugs (one per line) and exits ",[773,1282,1283],{},"before"," loading ",[760,1286,847],{}," or authenticating. CI pipelines (or you, locally) can use this to sanity-check the selection without needing credentials.",[834,1289,1291],{"id":1290},"channels-dev-stg-prd","Channels: DEV \u002F STG \u002F PRD",[850,1293,1295],{"className":852,"code":1294,"language":854,"meta":855,"style":855},"uv run scripts\u002Fdeploy.py w03-liquid-handling --channel dev\nuv run scripts\u002Fdeploy.py --all --channel stg\nuv run scripts\u002Fdeploy.py --git-tag w03-liquid-handling\u002Fv1.2.0 --channel prd\n",[760,1296,1297,1314,1330],{"__ignoreMap":855},[859,1298,1299,1301,1303,1305,1308,1311],{"class":861,"line":862},[859,1300,815],{"class":1104},[859,1302,1107],{"class":872},[859,1304,1110],{"class":872},[859,1306,1307],{"class":872}," w03-liquid-handling",[859,1309,1310],{"class":872}," --channel",[859,1312,1313],{"class":872}," dev\n",[859,1315,1316,1318,1320,1322,1325,1327],{"class":861,"line":888},[859,1317,815],{"class":1104},[859,1319,1107],{"class":872},[859,1321,1110],{"class":872},[859,1323,1324],{"class":872}," --all",[859,1326,1310],{"class":872},[859,1328,1329],{"class":872}," stg\n",[859,1331,1332,1334,1336,1338,1340,1343,1345],{"class":861,"line":917},[859,1333,815],{"class":1104},[859,1335,1107],{"class":872},[859,1337,1110],{"class":872},[859,1339,1221],{"class":872},[859,1341,1342],{"class":872}," w03-liquid-handling\u002Fv1.2.0",[859,1344,1310],{"class":872},[859,1346,1347],{"class":872}," prd\n",[756,1349,1350,1353,1354,1357,1358,1357,1361,1364,1365,1367,1368,1371],{},[760,1351,1352],{},"--channel"," layers on top of any of the forms above. It prepends ",[760,1355,1356],{},"[DEV] ","\u002F",[760,1359,1360],{},"[STG] ",[760,1362,1363],{},"[PRD] "," to the platform ",[760,1366,1067],{}," and adds the channel name as a platform tag. The result: a single tenant can host ",[773,1369,1370],{},"parallel DEV, STG, and PRD records of the same workflow"," as distinct platform entries — bench testing on DEV doesn't risk the production record.",[756,1373,1374,1375,1377,1378,1381,1382,832],{},"The channel-to-trigger mapping is established by CI; locally you'll usually omit ",[760,1376,1352],{}," (deploys land as untagged \"main\" records) or pass ",[760,1379,1380],{},"--channel dev"," when iterating against a shared DEV tenant. The full mapping is in ",[765,1383,507],{"href":951},[834,1385,1387],{"id":1386},"extra-platform-tags","Extra platform tags",[850,1389,1391],{"className":852,"code":1390,"language":854,"meta":855,"style":855},"uv run scripts\u002Fdeploy.py w03-liquid-handling --tag prod --tag stable\n",[760,1392,1393],{"__ignoreMap":855},[859,1394,1395,1397,1399,1401,1403,1406,1409,1411],{"class":861,"line":862},[859,1396,815],{"class":1104},[859,1398,1107],{"class":872},[859,1400,1110],{"class":872},[859,1402,1307],{"class":872},[859,1404,1405],{"class":872}," --tag",[859,1407,1408],{"class":872}," prod",[859,1410,1405],{"class":872},[859,1412,1413],{"class":872}," stable\n",[756,1415,1416,1419,1420,1423,1424,1426],{},[760,1417,1418],{},"--tag\u002F-t"," is repeatable and stacks with ",[760,1421,1422],{},"--git-tag","'s version label and ",[760,1425,1352],{},"'s channel tag. Use it for ad-hoc labels (a feature flag, a customer name) without bumping the workflow's version.",[834,1428,1430],{"id":1429},"release-a-workflow","Release a workflow",[756,1432,1433,1434,1437],{},"Each workflow ships independently. To release ",[760,1435,1436],{},"w03-liquid-handling v1.2.0",":",[992,1439,1440,1453,1493],{},[780,1441,1442,1445,1446,1449,1450,832],{},[773,1443,1444],{},"Bump the version."," Edit ",[760,1447,1448],{},"w03-liquid-handling\u002Fpyproject.toml"," and set ",[760,1451,1452],{},"[project].version = \"1.2.0\"",[780,1454,1455,1458],{},[773,1456,1457],{},"Commit:",[850,1459,1461],{"className":852,"code":1460,"language":854,"meta":855,"style":855},"git add w03-liquid-handling\u002Fpyproject.toml\ngit commit -m \"release: w03-liquid-handling v1.2.0\"\n",[760,1462,1463,1474],{"__ignoreMap":855},[859,1464,1465,1468,1471],{"class":861,"line":862},[859,1466,1467],{"class":1104},"git",[859,1469,1470],{"class":872}," add",[859,1472,1473],{"class":872}," w03-liquid-handling\u002Fpyproject.toml\n",[859,1475,1476,1478,1481,1484,1487,1490],{"class":861,"line":888},[859,1477,1467],{"class":1104},[859,1479,1480],{"class":872}," commit",[859,1482,1483],{"class":872}," -m",[859,1485,1486],{"class":868}," \"",[859,1488,1489],{"class":872},"release: w03-liquid-handling v1.2.0",[859,1491,1492],{"class":868},"\"\n",[780,1494,1495,1498],{},[773,1496,1497],{},"Tag and push:",[850,1499,1501],{"className":852,"code":1500,"language":854,"meta":855,"style":855},"git tag w03-liquid-handling\u002Fv1.2.0\ngit push origin main --tags\n",[760,1502,1503,1512],{"__ignoreMap":855},[859,1504,1505,1507,1510],{"class":861,"line":862},[859,1506,1467],{"class":1104},[859,1508,1509],{"class":872}," tag",[859,1511,1224],{"class":872},[859,1513,1514,1516,1519,1522,1525],{"class":861,"line":888},[859,1515,1467],{"class":1104},[859,1517,1518],{"class":872}," push",[859,1520,1521],{"class":872}," origin",[859,1523,1524],{"class":872}," main",[859,1526,1527],{"class":872}," --tags\n",[756,1529,1530,1531,1534,1535,1537],{},"The tag push triggers ",[760,1532,1533],{},"deploy-prd"," in CI — see ",[765,1536,507],{"href":951},". You can also run the release locally:",[850,1539,1541],{"className":852,"code":1540,"language":854,"meta":855,"style":855},"uv run scripts\u002Fdeploy.py --git-tag w03-liquid-handling\u002Fv1.2.0 --channel prd\n",[760,1542,1543],{"__ignoreMap":855},[859,1544,1545,1547,1549,1551,1553,1555,1557],{"class":861,"line":862},[859,1546,815],{"class":1104},[859,1548,1107],{"class":872},[859,1550,1110],{"class":872},[859,1552,1221],{"class":872},[859,1554,1342],{"class":872},[859,1556,1310],{"class":872},[859,1558,1347],{"class":872},[953,1560,1562],{"icon":1561},"i-heroicons-information-circle",[756,1563,1564,1565,1567,1568,1570],{},"The tag form ",[760,1566,1230],{}," is mandatory — bare ",[760,1569,1241],{}," tags won't match the deploy regex, intentionally. A repo with several workflows needs per-workflow tags so bumping one doesn't pretend every other workflow changed.",[834,1572,1574],{"id":1573},"verify","Verify",[756,1576,1577,1578,1581],{},"Open the UniteLabs Workflows page and confirm the workflow appears with the expected ",[760,1579,1580],{},"[CHANNEL]"," prefix, version, and tags.",[756,1583,1584],{},"The script's stdout shows what landed on the platform — display name, resolved entrypoint, bundle size, dep count, and whether the record was created or updated.",[834,1586,1588],{"id":1587},"next-steps","Next steps",[777,1590,1591,1602,1611],{},[780,1592,1593,1598,1599,1601],{},[765,1594,1595],{"href":951},[773,1596,1597],{},"Set up CI\u002FCD"," — wire ",[760,1600,762],{}," into GitHub Actions or GitLab CI with the three-channel (dev\u002Fstg\u002Fprd) model.",[780,1603,1604,1610],{},[765,1605,1607],{"href":1606},"\u002Fautomate\u002Fguides\u002Frun-a-workflow\u002F",[773,1608,1609],{},"Trigger a workflow run"," — confirm the deployment end-to-end.",[780,1612,1613,1622],{},[765,1614,1617],{"href":1615,"rel":1616},"https:\u002F\u002Fgitlab.com\u002Funitelabs\u002Fworkflows\u002Fworkflow-template\u002F-\u002Fblob\u002Fmain\u002FAGENTS.md",[812],[773,1618,1619],{},[760,1620,1621],{},"AGENTS.md"," — authoring rules for adding new workflows to the template.",[1624,1625,1626],"style",{},"html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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);}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":855,"searchDepth":862,"depth":888,"links":1628},[1629,1630,1631,1638,1639,1640,1641,1642],{"id":836,"depth":888,"text":837},{"id":967,"depth":888,"text":968},{"id":1085,"depth":888,"text":1086,"children":1632},[1633,1634,1635,1636,1637],{"id":1093,"depth":917,"text":1094},{"id":1127,"depth":917,"text":1128},{"id":1147,"depth":917,"text":1148},{"id":1204,"depth":917,"text":1205},{"id":1245,"depth":917,"text":1246},{"id":1290,"depth":888,"text":1291},{"id":1386,"depth":888,"text":1387},{"id":1429,"depth":888,"text":1430},{"id":1573,"depth":888,"text":1574},{"id":1587,"depth":888,"text":1588},"Bundle a workflow from a workflow-template repo and ship it to the UniteLabs platform with scripts\u002Fdeploy.py.","md",null,{},true,{"title":499,"description":1643},"vjPE2jasmmjxpBbs_5u7TiXoM_9lwbd0RObO5x-XQ88",[1651,1653],{"title":183,"path":492,"stem":493,"description":1652},"How errors are classified, retried, and recovered at each level of the workflow hierarchy — from automatic step retries to operator-assisted recovery.",{"title":503,"path":504,"stem":505,"description":1654},"Trigger a workflow run from the platform UI, the UniteLabs SDK, or the REST API.",1783607789284]