[{"data":1,"prerenderedAt":2347},["ShallowReactive",2],{"navigation":3,"\u002Fhow-to\u002Fautomate\u002Fcicd-for-workflows":909,"\u002Fhow-to\u002Fautomate\u002Fcicd-for-workflows-surround":2342},[4,59,188,271,445,591,760,791],{"title":5,"type":6,"device":6,"path":7,"stem":8,"children":9,"page":41},"Get Started",null,"\u002Fget-started\u002F","01.get-started",[10,15,42,47,51,55],{"title":11,"path":12,"stem":13,"type":14,"device":6},"Welcome to UniteLabs","\u002Fget-started\u002Fwelcome\u002F","01.get-started\u002F00.welcome","landing",{"title":16,"type":6,"device":6,"path":17,"stem":18,"children":19,"page":41},"Setup","\u002Fget-started\u002Fsetup\u002F","01.get-started\u002F01.setup",[20,25,29,33,37],{"title":21,"path":22,"stem":23,"type":24,"device":6},"Get access","\u002Fget-started\u002Fsetup\u002Fget-access\u002F","01.get-started\u002F01.setup\u002F00.get-access","howto",{"title":26,"path":27,"stem":28,"type":24,"device":6},"GroundControl","\u002Fget-started\u002Fsetup\u002Fgroundcontrol\u002F","01.get-started\u002F01.setup\u002F10.groundcontrol",{"title":30,"path":31,"stem":32,"type":24,"device":6},"Connect to Platform","\u002Fget-started\u002Fsetup\u002Fconnect-to-platform\u002F","01.get-started\u002F01.setup\u002F20.connect-to-platform",{"title":34,"path":35,"stem":36,"type":24,"device":6},"Set up your development machine","\u002Fget-started\u002Fsetup\u002Fdeveloper-machine\u002F","01.get-started\u002F01.setup\u002F30.developer-machine",{"title":38,"path":39,"stem":40,"type":24,"device":6},"SDK installation","\u002Fget-started\u002Fsetup\u002Fsdk-installation\u002F","01.get-started\u002F01.setup\u002F40.sdk-installation",false,{"title":43,"path":44,"stem":45,"type":46,"device":6},"Control a device","\u002Fget-started\u002Fcontrol-a-device\u002F","01.get-started\u002F02.control-a-device","tutorial",{"title":48,"path":49,"stem":50,"type":46,"device":6},"Liquid handling as code","\u002Fget-started\u002Fliquid-handling-as-code\u002F","01.get-started\u002F03.liquid-handling-as-code",{"title":52,"path":53,"stem":54,"type":46,"device":6},"Automate your workflows","\u002Fget-started\u002Fautomate-your-workflows\u002F","01.get-started\u002F04.automate-your-workflows",{"title":56,"path":57,"stem":58,"type":6,"device":6},"Self-Paced Setup Guide","\u002Fget-started\u002Fself-onboarding\u002F","01.get-started\u002F90.self-onboarding",{"title":60,"type":6,"device":6,"path":61,"stem":62,"children":63,"page":41},"How-to","\u002Fhow-to\u002F","02.how-to",[64,118,163,180],{"title":65,"type":6,"device":6,"path":66,"stem":67,"children":68,"page":41},"Connectors and devices","\u002Fhow-to\u002Fintegrate\u002F","02.how-to\u002F02.integrate",[69,102],{"title":70,"type":6,"device":6,"path":71,"stem":72,"children":73,"page":41},"Connect a device","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device",[74,78,82,86,90,94,98],{"title":75,"path":76,"stem":77,"type":24,"device":6},"Connector Configuration","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Fconnector-configuration\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F10.connector-configuration",{"title":79,"path":80,"stem":81,"type":24,"device":6},"With an executable","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Fwith-an-executable\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F20.with-an-executable",{"title":83,"path":84,"stem":85,"type":24,"device":6},"From source","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Ffrom-source\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F30.from-source",{"title":87,"path":88,"stem":89,"type":24,"device":6},"Build your own","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Fbuild-yourself\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F40.build-yourself",{"title":91,"path":92,"stem":93,"type":24,"device":6},"Headless install","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Fheadless-install\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F50.headless-install",{"title":95,"path":96,"stem":97,"type":24,"device":6},"Raspberry Pi","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Fraspberry-pi\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F55.raspberry-pi",{"title":99,"path":100,"stem":101,"type":24,"device":6},"Multi-device Networking","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Fmultiple-devices\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F60.multiple-devices",{"title":103,"type":6,"device":6,"path":104,"stem":105,"children":106,"page":41},"Use a device","\u002Fhow-to\u002Fintegrate\u002Fuse-a-device\u002F","02.how-to\u002F02.integrate\u002F30.use-a-device",[107,110,114],{"title":26,"path":108,"stem":109,"type":24,"device":6},"\u002Fhow-to\u002Fintegrate\u002Fuse-a-device\u002Fgroundcontrol\u002F","02.how-to\u002F02.integrate\u002F30.use-a-device\u002F10.groundcontrol",{"title":111,"path":112,"stem":113,"type":24,"device":6},"Platform","\u002Fhow-to\u002Fintegrate\u002Fuse-a-device\u002Fplatform\u002F","02.how-to\u002F02.integrate\u002F30.use-a-device\u002F20.platform",{"title":115,"path":116,"stem":117,"type":24,"device":6},"UniteLabs SDK & REST API","\u002Fhow-to\u002Fintegrate\u002Fuse-a-device\u002Fpython\u002F","02.how-to\u002F02.integrate\u002F30.use-a-device\u002F30.python",{"title":119,"type":6,"device":6,"path":120,"stem":121,"children":122,"page":41},"Workflows","\u002Fhow-to\u002Fautomate\u002F","02.how-to\u002F07.automate",[123,127,131,135,139,143,147,151,155,159],{"title":124,"path":125,"stem":126,"type":24,"device":6},"Deploy a workflow","\u002Fhow-to\u002Fautomate\u002Fdeploy-a-workflow\u002F","02.how-to\u002F07.automate\u002F30.deploy-a-workflow",{"title":128,"path":129,"stem":130,"type":24,"device":6},"Run a workflow","\u002Fhow-to\u002Fautomate\u002Frun-a-workflow\u002F","02.how-to\u002F07.automate\u002F35.run-a-workflow",{"title":132,"path":133,"stem":134,"type":24,"device":6},"CI\u002FCD for workflows","\u002Fhow-to\u002Fautomate\u002Fcicd-for-workflows\u002F","02.how-to\u002F07.automate\u002F40.cicd-for-workflows",{"title":136,"path":137,"stem":138,"type":24,"device":6},"HITL basics","\u002Fhow-to\u002Fautomate\u002Fbasic-hitl\u002F","02.how-to\u002F07.automate\u002F50.basic-hitl",{"title":140,"path":141,"stem":142,"type":24,"device":6},"Slack notifications and operator confirmation","\u002Fhow-to\u002Fautomate\u002Fslack-notifications\u002F","02.how-to\u002F07.automate\u002F52.slack-notifications",{"title":144,"path":145,"stem":146,"type":24,"device":6},"Typed operator inputs","\u002Fhow-to\u002Fautomate\u002Ftyped-operator-inputs\u002F","02.how-to\u002F07.automate\u002F55.typed-operator-inputs",{"title":148,"path":149,"stem":150,"type":24,"device":6},"Pause and resume a run","\u002Fhow-to\u002Fautomate\u002Fpause-and-resume\u002F","02.how-to\u002F07.automate\u002F57.pause-and-resume",{"title":152,"path":153,"stem":154,"type":24,"device":6},"Error recovery","\u002Fhow-to\u002Fautomate\u002Fbasic-error-handling\u002F","02.how-to\u002F07.automate\u002F60.basic-error-handling",{"title":156,"path":157,"stem":158,"type":24,"device":6},"Advanced error handling","\u002Fhow-to\u002Fautomate\u002Fadvanced-error-handling\u002F","02.how-to\u002F07.automate\u002F70.advanced-error-handling",{"title":160,"path":161,"stem":162,"type":24,"device":6},"Emit lineage events","\u002Fhow-to\u002Fautomate\u002Femitting-lineage-events\u002F","02.how-to\u002F07.automate\u002F90.emitting-lineage-events",{"title":164,"type":6,"device":6,"path":165,"stem":166,"children":167,"page":41},"Data","\u002Fhow-to\u002Fobserve\u002F","02.how-to\u002F08.observe",[168,172,176],{"title":169,"path":170,"stem":171,"type":24,"device":6},"File System Connector","\u002Fhow-to\u002Fobserve\u002Ffilesystem-connector\u002F","02.how-to\u002F08.observe\u002F10.filesystem-connector",{"title":173,"path":174,"stem":175,"type":24,"device":6},"Building an ETL","\u002Fhow-to\u002Fobserve\u002Fbuilding-an-etl\u002F","02.how-to\u002F08.observe\u002F20.building-an-etl",{"title":177,"path":178,"stem":179,"type":24,"device":6},"Read lineage events","\u002Fhow-to\u002Fobserve\u002Freading-lineage-events\u002F","02.how-to\u002F08.observe\u002F30.reading-lineage-events",{"title":111,"type":6,"device":6,"path":181,"stem":182,"children":183,"page":41},"\u002Fhow-to\u002Fplatform\u002F","02.how-to\u002F09.platform",[184],{"title":185,"path":186,"stem":187,"type":24,"device":6},"UniteLabs Desktop","\u002Fhow-to\u002Fplatform\u002Funitelabs-desktop\u002F","02.how-to\u002F09.platform\u002F10.unitelabs-desktop",{"title":189,"type":6,"device":6,"path":190,"stem":191,"children":192},"Technical Reference","\u002Ftechnical-reference\u002F","03.technical-reference",[193,196,201,213,226,235,244,253,262],{"title":194,"path":190,"stem":195,"type":14,"device":6},"Overview","03.technical-reference\u002Findex",{"title":197,"path":198,"stem":199,"type":200,"device":6},"REST API","\u002Ftechnical-reference\u002Frest-api\u002F","03.technical-reference\u002F01.rest-api","reference",{"title":119,"type":6,"device":6,"path":202,"stem":203,"children":204,"page":41},"\u002Ftechnical-reference\u002Fautomate\u002F","03.technical-reference\u002F07.automate",[205,209],{"title":206,"path":207,"stem":208,"type":200,"device":6},"Workflow template","\u002Ftechnical-reference\u002Fautomate\u002Fworkflow-template\u002F","03.technical-reference\u002F07.automate\u002F05.workflow-template",{"title":210,"path":211,"stem":212,"type":200,"device":6},"Workflows REST API","\u002Ftechnical-reference\u002Fautomate\u002Fworkflows-api\u002F","03.technical-reference\u002F07.automate\u002F80.workflows-api",{"title":26,"type":6,"device":6,"path":214,"stem":215,"children":216},"\u002Ftechnical-reference\u002Fgroundcontrol\u002F","03.technical-reference\u002F10.groundcontrol\u002Findex",[217,218,222],{"title":194,"path":214,"stem":215,"type":14,"device":6},{"title":219,"path":220,"stem":221,"type":200,"device":6},"Network requirements","\u002Ftechnical-reference\u002Fgroundcontrol\u002Fnetwork-requirements\u002F","03.technical-reference\u002F10.groundcontrol\u002F10.network-requirements",{"title":223,"path":224,"stem":225,"type":200,"device":6},"Changelog","\u002Ftechnical-reference\u002Fgroundcontrol\u002Fchangelog\u002F","03.technical-reference\u002F10.groundcontrol\u002F20.changelog",{"title":227,"type":6,"device":6,"path":228,"stem":229,"children":230},"UniteLabs SDK","\u002Ftechnical-reference\u002Fpython-sdk\u002F","03.technical-reference\u002F20.python-sdk\u002Findex",[231,232],{"title":194,"path":228,"stem":229,"type":14,"device":6},{"title":223,"path":233,"stem":234,"type":200,"device":6},"\u002Ftechnical-reference\u002Fpython-sdk\u002Fchangelog\u002F","03.technical-reference\u002F20.python-sdk\u002F20.changelog",{"title":236,"type":6,"device":6,"path":237,"stem":238,"children":239},"Liquid Handling SDK","\u002Ftechnical-reference\u002Fpython-liquid-handling-sdk\u002F","03.technical-reference\u002F30.python-liquid-handling-sdk\u002Findex",[240,241],{"title":194,"path":237,"stem":238,"type":14,"device":6},{"title":223,"path":242,"stem":243,"type":200,"device":6},"\u002Ftechnical-reference\u002Fpython-liquid-handling-sdk\u002Fchangelog\u002F","03.technical-reference\u002F30.python-liquid-handling-sdk\u002F20.changelog",{"title":245,"type":6,"device":6,"path":246,"stem":247,"children":248},"Labware","\u002Ftechnical-reference\u002Flabware\u002F","03.technical-reference\u002F40.labware\u002Findex",[249,250],{"title":194,"path":246,"stem":247,"type":14,"device":6},{"title":223,"path":251,"stem":252,"type":200,"device":6},"\u002Ftechnical-reference\u002Flabware\u002Fchangelog\u002F","03.technical-reference\u002F40.labware\u002F20.changelog",{"title":254,"type":6,"device":6,"path":255,"stem":256,"children":257},"Python Omnibus","\u002Ftechnical-reference\u002Fpython-omnibus\u002F","03.technical-reference\u002F50.python-omnibus\u002Findex",[258,259],{"title":194,"path":255,"stem":256,"type":14,"device":6},{"title":223,"path":260,"stem":261,"type":200,"device":6},"\u002Ftechnical-reference\u002Fpython-omnibus\u002Fchangelog\u002F","03.technical-reference\u002F50.python-omnibus\u002F20.changelog",{"title":263,"type":6,"device":6,"path":264,"stem":265,"children":266},"Python CDK","\u002Ftechnical-reference\u002Fpython-cdk\u002F","03.technical-reference\u002F60.python-cdk\u002Findex",[267,268],{"title":194,"path":264,"stem":265,"type":14,"device":6},{"title":223,"path":269,"stem":270,"type":200,"device":6},"\u002Ftechnical-reference\u002Fpython-cdk\u002Fchangelog\u002F","03.technical-reference\u002F60.python-cdk\u002F20.changelog",{"title":272,"type":6,"device":6,"path":273,"stem":274,"children":275,"page":41},"Concepts","\u002Fconcepts\u002F","04.concepts",[276,315,339,383,422],{"title":277,"type":6,"device":6,"path":278,"stem":279,"children":280,"page":41},"Labs as code","\u002Fconcepts\u002Flabs-as-code\u002F","04.concepts\u002F01.labs-as-code",[281,286,290],{"title":282,"path":283,"stem":284,"type":285,"device":6},"Lab as Code","\u002Fconcepts\u002Flabs-as-code\u002Fwhy-code\u002F","04.concepts\u002F01.labs-as-code\u002F00.why-code","explanation",{"title":287,"path":288,"stem":289,"type":285,"device":6},"How it works","\u002Fconcepts\u002Flabs-as-code\u002Fhow-it-works\u002F","04.concepts\u002F01.labs-as-code\u002F01.how-it-works",{"title":291,"type":6,"device":6,"path":292,"stem":293,"children":294,"page":41},"Use Cases","\u002Fconcepts\u002Flabs-as-code\u002Fuse-cases\u002F","04.concepts\u002F01.labs-as-code\u002F02.use-cases",[295,299,303,307,311],{"title":296,"path":297,"stem":298,"type":285,"device":6},"Instrument Control","\u002Fconcepts\u002Flabs-as-code\u002Fuse-cases\u002Flow-level-instrument-control\u002F","04.concepts\u002F01.labs-as-code\u002F02.use-cases\u002F10.low-level-instrument-control",{"title":300,"path":301,"stem":302,"type":285,"device":6},"Multi-device Control","\u002Fconcepts\u002Flabs-as-code\u002Fuse-cases\u002Fmulti-device-control\u002F","04.concepts\u002F01.labs-as-code\u002F02.use-cases\u002F20.multi-device-control",{"title":304,"path":305,"stem":306,"type":285,"device":6},"Workflow Orchestration","\u002Fconcepts\u002Flabs-as-code\u002Fuse-cases\u002Fworkflow-orchestration\u002F","04.concepts\u002F01.labs-as-code\u002F02.use-cases\u002F30.workflow-orchestration",{"title":308,"path":309,"stem":310,"type":285,"device":6},"Custom Apps and LIMS Integration","\u002Fconcepts\u002Flabs-as-code\u002Fuse-cases\u002Fcustom-apps-lims\u002F","04.concepts\u002F01.labs-as-code\u002F02.use-cases\u002F40.custom-apps-lims",{"title":312,"path":313,"stem":314,"type":285,"device":6},"Scale and Fleet Management","\u002Fconcepts\u002Flabs-as-code\u002Fuse-cases\u002Fscale-and-fleet\u002F","04.concepts\u002F01.labs-as-code\u002F02.use-cases\u002F50.scale-and-fleet",{"title":65,"type":6,"device":6,"path":316,"stem":317,"children":318,"page":41},"\u002Fconcepts\u002Fintegrate\u002F","04.concepts\u002F02.integrate",[319,323,327,331,335],{"title":320,"path":321,"stem":322,"type":285,"device":6},"Device","\u002Fconcepts\u002Fintegrate\u002Fdevice\u002F","04.concepts\u002F02.integrate\u002F05.device",{"title":324,"path":325,"stem":326,"type":285,"device":6},"Connector","\u002Fconcepts\u002Fintegrate\u002Fconnector\u002F","04.concepts\u002F02.integrate\u002F10.connector",{"title":328,"path":329,"stem":330,"type":285,"device":6},"Module","\u002Fconcepts\u002Fintegrate\u002Fmodule\u002F","04.concepts\u002F02.integrate\u002F20.module",{"title":332,"path":333,"stem":334,"type":285,"device":6},"Action","\u002Fconcepts\u002Fintegrate\u002Faction\u002F","04.concepts\u002F02.integrate\u002F30.action",{"title":336,"path":337,"stem":338,"type":285,"device":6},"Subscription","\u002Fconcepts\u002Fintegrate\u002Fsubscription\u002F","04.concepts\u002F02.integrate\u002F40.subscription",{"title":340,"type":6,"device":6,"path":341,"stem":342,"children":343,"page":41},"Liquid handling and robots","\u002Fconcepts\u002Foperate\u002F","04.concepts\u002F03.operate",[344,348,352,356,359,363,367,371,375,379],{"title":345,"path":346,"stem":347,"type":285,"device":6},"Liquid Handling","\u002Fconcepts\u002Foperate\u002Fliquid-handling\u002F","04.concepts\u002F03.operate\u002F10.liquid-handling",{"title":349,"path":350,"stem":351,"type":285,"device":6},"Modules","\u002Fconcepts\u002Foperate\u002Fmodules\u002F","04.concepts\u002F03.operate\u002F20.modules",{"title":353,"path":354,"stem":355,"type":285,"device":6},"Deck","\u002Fconcepts\u002Foperate\u002Fdeck\u002F","04.concepts\u002F03.operate\u002F30.deck",{"title":245,"path":357,"stem":358,"type":285,"device":6},"\u002Fconcepts\u002Foperate\u002Flabware\u002F","04.concepts\u002F03.operate\u002F40.labware",{"title":360,"path":361,"stem":362,"type":285,"device":6},"Liquids","\u002Fconcepts\u002Foperate\u002Fliquids\u002F","04.concepts\u002F03.operate\u002F50.liquids",{"title":364,"path":365,"stem":366,"type":285,"device":6},"Liquid Classes","\u002Fconcepts\u002Foperate\u002Fliquid-classes\u002F","04.concepts\u002F03.operate\u002F60.liquid-classes",{"title":368,"path":369,"stem":370,"type":285,"device":6},"Parameter Sets","\u002Fconcepts\u002Foperate\u002Fparameter-sets\u002F","04.concepts\u002F03.operate\u002F65.parameter-sets",{"title":372,"path":373,"stem":374,"type":285,"device":6},"Tips and Tip Tracking","\u002Fconcepts\u002Foperate\u002Ftips\u002F","04.concepts\u002F03.operate\u002F70.tips",{"title":376,"path":377,"stem":378,"type":285,"device":6},"Simulation","\u002Fconcepts\u002Foperate\u002Fsimulation\u002F","04.concepts\u002F03.operate\u002F80.simulation",{"title":380,"path":381,"stem":382,"type":285,"device":6},"Error Handling","\u002Fconcepts\u002Foperate\u002Ferror-handling\u002F","04.concepts\u002F03.operate\u002F90.error-handling",{"title":119,"type":6,"device":6,"path":384,"stem":385,"children":386,"page":41},"\u002Fconcepts\u002Fautomate\u002F","04.concepts\u002F07.automate",[387,391,395,399,403,407,411,415,419],{"title":388,"path":389,"stem":390,"type":285,"device":6},"Workflow","\u002Fconcepts\u002Fautomate\u002Fworkflow\u002F","04.concepts\u002F07.automate\u002F10.workflow",{"title":392,"path":393,"stem":394,"type":285,"device":6},"Phase","\u002Fconcepts\u002Fautomate\u002Fphase\u002F","04.concepts\u002F07.automate\u002F20.phase",{"title":396,"path":397,"stem":398,"type":285,"device":6},"Step","\u002Fconcepts\u002Fautomate\u002Fstep\u002F","04.concepts\u002F07.automate\u002F30.step",{"title":400,"path":401,"stem":402,"type":285,"device":6},"Runs","\u002Fconcepts\u002Fautomate\u002Fruns\u002F","04.concepts\u002F07.automate\u002F40.runs",{"title":404,"path":405,"stem":406,"type":285,"device":6},"Input","\u002Fconcepts\u002Fautomate\u002Finput\u002F","04.concepts\u002F07.automate\u002F50.input",{"title":408,"path":409,"stem":410,"type":285,"device":6},"Artifacts","\u002Fconcepts\u002Fautomate\u002Fartifacts\u002F","04.concepts\u002F07.automate\u002F60.artifacts",{"title":412,"path":413,"stem":414,"type":285,"device":6},"Logs","\u002Fconcepts\u002Fautomate\u002Flogs\u002F","04.concepts\u002F07.automate\u002F70.logs",{"title":416,"path":417,"stem":418,"type":285,"device":6},"Human in the Loop","\u002Fconcepts\u002Fautomate\u002Fhuman-in-the-loop\u002F","04.concepts\u002F07.automate\u002F80.human-in-the-loop",{"title":380,"path":420,"stem":421,"type":285,"device":6},"\u002Fconcepts\u002Fautomate\u002Ferror-handling\u002F","04.concepts\u002F07.automate\u002F90.error-handling",{"title":164,"type":6,"device":6,"path":423,"stem":424,"children":425,"page":41},"\u002Fconcepts\u002Fobserve\u002F","04.concepts\u002F08.observe",[426,429,433,437,441],{"title":194,"path":427,"stem":428,"type":14,"device":6},"\u002Fconcepts\u002Fobserve\u002Foverview\u002F","04.concepts\u002F08.observe\u002F10.overview",{"title":430,"path":431,"stem":432,"type":285,"device":6},"Object Storage","\u002Fconcepts\u002Fobserve\u002Fstorage\u002F","04.concepts\u002F08.observe\u002F10.storage",{"title":434,"path":435,"stem":436,"type":285,"device":6},"Secrets","\u002Fconcepts\u002Fobserve\u002Fsecrets\u002F","04.concepts\u002F08.observe\u002F20.secrets",{"title":438,"path":439,"stem":440,"type":285,"device":6},"Data sources","\u002Fconcepts\u002Fobserve\u002Fdata-sources\u002F","04.concepts\u002F08.observe\u002F30.data-sources",{"title":442,"path":443,"stem":444,"type":285,"device":6},"Data lineage","\u002Fconcepts\u002Fobserve\u002Fdata-lineage\u002F","04.concepts\u002F08.observe\u002F40.data-lineage",{"title":446,"type":6,"device":6,"path":447,"stem":448,"children":449,"page":41},"Devices","\u002Fdevices\u002F","05.devices",[450,453,501,514,530,567],{"title":194,"path":451,"stem":452,"type":14,"device":6},"\u002Fdevices\u002Foverview\u002F","05.devices\u002F00.overview",{"title":454,"path":455,"page":41,"children":456},"Heater-shakers","\u002Fdevices\u002Fheater-shakers\u002F",[457,478,488],{"title":458,"path":459,"stem":460,"type":200,"device":461},"QInstruments BioShake","\u002Fdevices\u002Fqinstruments-bioshake\u002F","05.devices\u002F10.qinstruments-bioshake",{"slug":462,"vendor":463,"category":464,"connector":462,"package":465,"models":466,"communication":473,"vendor_software":6,"os":474},"qinstruments-bioshake","QInstruments","Plate Shakers & Temperature Control","unitelabs-qinstruments-bioshake",[467,468,469,470,471,472],"BioShake 3000 \u002F 3000 elm \u002F 3000 elm DWP","BioShake 3000-T \u002F 3000-T elm","BioShake 5000 elm","BioShake D30 \u002F D30 elm \u002F D30-T \u002F D30-T elm","BioShake Q1 \u002F Q1 (1.2 mm) \u002F Q1 (3.0 mm) \u002F Q2","HeatPlate","serial (RS-232 over USB)",[475,476,477],"windows","linux","macos",{"title":479,"path":480,"stem":481,"type":200,"device":482},"QInstruments ColdPlate","\u002Fdevices\u002Fqinstruments-coldplate\u002F","05.devices\u002F20.qinstruments-coldplate",{"slug":483,"vendor":463,"category":464,"connector":462,"package":465,"models":484,"communication":473,"vendor_software":6,"os":487},"qinstruments-coldplate",[485,486],"ColdPlate","ColdPlate slim",[475,476,477],{"title":489,"path":490,"stem":491,"type":200,"device":492},"Inheco Thermoshake","\u002Fdevices\u002Finheco-thermoshake\u002F","05.devices\u002F30.inheco-thermoshake",{"slug":493,"vendor":494,"category":464,"connector":495,"models":496},"inheco-thermoshake","Inheco","inheco-tec-controller",[497,498,499,500],"Thermoshake AC","Thermoshake AC LC","Thermoshake Classic","Thermoshake RM",{"title":502,"path":503,"page":41,"children":504},"Incubation","\u002Fdevices\u002Fincubation\u002F",[505],{"title":506,"path":507,"stem":508,"type":200,"device":509},"Inheco SCILA","\u002Fdevices\u002Finheco-scila\u002F","05.devices\u002F40.inheco-scila",{"slug":510,"vendor":494,"category":502,"connector":510,"models":511},"inheco-scila",[512,513],"SCILA","SCILA MIX 2-gas mixing device",{"title":515,"path":516,"page":41,"children":517},"Thermal cyclers","\u002Fdevices\u002Fthermal-cyclers\u002F",[518],{"title":519,"path":520,"stem":521,"type":200,"device":522},"Inheco ODTC","\u002Fdevices\u002Finheco-odtc\u002F","05.devices\u002F50.inheco-odtc",{"slug":523,"vendor":494,"category":524,"connector":523,"models":525},"inheco-odtc","Thermal Cycler",[526,527,528,529],"ODTC 96","ODTC 96XL","ODTC 384","ODTC 384XL",{"title":531,"path":532,"page":41,"children":533},"Readers","\u002Fdevices\u002Freaders\u002F",[534,543,552],{"title":535,"path":536,"stem":537,"type":200,"device":538},"Agilent Biotek Gen5","\u002Fdevices\u002Fbiotek-gen5\u002F","05.devices\u002F60.biotek-gen5",{"slug":539,"vendor":540,"category":541,"connector":542},"biotek-gen5","Agilent","Readers & Imagers","gen5",{"title":544,"path":545,"stem":546,"type":200,"device":547},"Biotek Synergy H1","\u002Fdevices\u002Fbiotek-synergy-h1\u002F","05.devices\u002F70.biotek-synergy-h1",{"slug":548,"vendor":540,"category":541,"connector":549,"models":550},"biotek-synergy-h1","agilent-synergy-h1",[551],"BioTek Synergy H1",{"title":553,"path":554,"stem":555,"type":200,"device":556},"Tecan Infinite 200","\u002Fdevices\u002Ftecan-infinite-200\u002F","05.devices\u002F75.tecan-infinite-200",{"slug":557,"vendor":558,"category":541,"connector":557,"package":559,"models":560,"communication":564,"vendor_software":565,"os":566},"tecan-infinite-200","Tecan","unitelabs-tecan-infinite-200",[561,562,563],"Infinite F200","Infinite M200","Infinite M200 Pro","USB","i-control on Windows only, for its USB driver",[475,476,477],{"title":568,"path":569,"page":41,"children":570},"Tilt & turn","\u002Fdevices\u002Ftilt-and-turn\u002F",[571,581],{"title":572,"path":573,"stem":574,"type":200,"device":575},"QInstruments TiltStation","\u002Fdevices\u002Fqinstruments-tiltstation\u002F","05.devices\u002F80.qinstruments-tiltstation",{"slug":576,"vendor":463,"category":577,"connector":462,"package":465,"models":578,"communication":473,"vendor_software":6,"os":580},"qinstruments-tiltstation","Plate Tilting",[579],"TiltStation",[475,476,477],{"title":582,"path":583,"stem":584,"type":200,"device":585},"QInstruments TurnStation","\u002Fdevices\u002Fqinstruments-turnstation\u002F","05.devices\u002F90.qinstruments-turnstation",{"slug":586,"vendor":463,"category":587,"connector":462,"package":465,"models":588,"communication":473,"vendor_software":6,"os":590},"qinstruments-turnstation","Plate Rotating",[589],"TurnStation",[475,476,477],{"title":592,"type":6,"device":6,"path":593,"stem":594,"children":595,"page":41},"Liquid Handling and Robots","\u002Fliquid-handling-and-robots\u002F","06.liquid-handling-and-robots",[596,599,611,635,638,679,704,721,738],{"title":194,"path":597,"stem":598,"type":14,"device":6},"\u002Fliquid-handling-and-robots\u002Foverview\u002F","06.liquid-handling-and-robots\u002F00.overview",{"title":353,"type":6,"device":6,"path":600,"stem":601,"children":602,"page":41},"\u002Fliquid-handling-and-robots\u002Fdeck\u002F","06.liquid-handling-and-robots\u002F10.deck",[603,607],{"title":604,"path":605,"stem":606,"type":24,"device":6},"Building a Deck","\u002Fliquid-handling-and-robots\u002Fdeck\u002Fbuilding-a-deck\u002F","06.liquid-handling-and-robots\u002F10.deck\u002F10.building-a-deck",{"title":608,"path":609,"stem":610,"type":24,"device":6},"Save\u002FLoad a Deck","\u002Fliquid-handling-and-robots\u002Fdeck\u002Fsave-load-deck\u002F","06.liquid-handling-and-robots\u002F10.deck\u002F20.save-load-deck",{"title":612,"type":6,"device":6,"path":613,"stem":614,"children":615,"page":41},"Pipetting","\u002Fliquid-handling-and-robots\u002Fpipetting\u002F","06.liquid-handling-and-robots\u002F20.pipetting",[616,620,624,628,631],{"title":617,"path":618,"stem":619,"type":24,"device":6},"Basic Pipetting","\u002Fliquid-handling-and-robots\u002Fpipetting\u002Fbasic-pipetting\u002F","06.liquid-handling-and-robots\u002F20.pipetting\u002F10.basic-pipetting",{"title":621,"path":622,"stem":623,"type":24,"device":6},"Advanced Pipetting","\u002Fliquid-handling-and-robots\u002Fpipetting\u002Fadvanced-pipetting\u002F","06.liquid-handling-and-robots\u002F20.pipetting\u002F20.advanced-pipetting",{"title":625,"path":626,"stem":627,"type":24,"device":6},"Tip Handling","\u002Fliquid-handling-and-robots\u002Fpipetting\u002Ftip-handling\u002F","06.liquid-handling-and-robots\u002F20.pipetting\u002F30.tip-handling",{"title":364,"path":629,"stem":630,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Fpipetting\u002Fliquid-classes\u002F","06.liquid-handling-and-robots\u002F20.pipetting\u002F40.liquid-classes",{"title":632,"path":633,"stem":634,"type":24,"device":6},"Labware Transport","\u002Fliquid-handling-and-robots\u002Fpipetting\u002Flabware-transport\u002F","06.liquid-handling-and-robots\u002F20.pipetting\u002F50.labware-transport",{"title":376,"path":636,"stem":637,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Fsimulation\u002F","06.liquid-handling-and-robots\u002F30.simulation",{"title":639,"type":6,"device":6,"path":640,"stem":641,"children":642,"page":41},"Hamilton STAR","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star",[643,647,651,655,659,663,667,671,675],{"title":644,"path":645,"stem":646,"type":24,"device":6},"Positioning & Movement","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fpositioning\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F10.positioning",{"title":648,"path":649,"stem":650,"type":24,"device":6},"Gripper Module","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fcore-gripper\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F20.core-gripper",{"title":652,"path":653,"stem":654,"type":24,"device":6},"iSWAP Module","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fiswap\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F30.iswap",{"title":656,"path":657,"stem":658,"type":24,"device":6},"Using TADM","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Ftadm\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F40.tadm",{"title":660,"path":661,"stem":662,"type":24,"device":6},"Autoload Module","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fautoload\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F50.autoload",{"title":664,"path":665,"stem":666,"type":24,"device":6},"Waste Block","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fwaste-block\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F60.waste-block",{"title":668,"path":669,"stem":670,"type":24,"device":6},"Complex Mixing","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fcomplex-mixing\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F66.complex-mixing",{"title":672,"path":673,"stem":674,"type":24,"device":6},"Teaching Gripper Paddle Positions","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fgripper-positions\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F70.gripper-positions",{"title":676,"path":677,"stem":678,"type":24,"device":6},"Training a Custom Deck Position With the iSWAP","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fcustom-deck-position\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F75.custom-deck-position",{"title":680,"type":6,"device":6,"path":681,"stem":682,"children":683,"page":41},"Hamilton Vantage","\u002Fliquid-handling-and-robots\u002Fhamilton-vantage\u002F","06.liquid-handling-and-robots\u002F42.hamilton-vantage",[684,688,692,696,700],{"title":685,"path":686,"stem":687,"type":24,"device":6},"Waste Configuration","\u002Fliquid-handling-and-robots\u002Fhamilton-vantage\u002Fwaste-configuration\u002F","06.liquid-handling-and-robots\u002F42.hamilton-vantage\u002F05.waste-configuration",{"title":689,"path":690,"stem":691,"type":24,"device":6},"Covers and Lights","\u002Fliquid-handling-and-robots\u002Fhamilton-vantage\u002Fcovers-and-lights\u002F","06.liquid-handling-and-robots\u002F42.hamilton-vantage\u002F10.covers-and-lights",{"title":693,"path":694,"stem":695,"type":24,"device":6},"IDL Module","\u002Fliquid-handling-and-robots\u002Fhamilton-vantage\u002Fidl\u002F","06.liquid-handling-and-robots\u002F42.hamilton-vantage\u002F20.idl",{"title":697,"path":698,"stem":699,"type":24,"device":6},"IPG Module","\u002Fliquid-handling-and-robots\u002Fhamilton-vantage\u002Fipg\u002F","06.liquid-handling-and-robots\u002F42.hamilton-vantage\u002F30.ipg",{"title":701,"path":702,"stem":703,"type":24,"device":6},"XL Pipettes","\u002Fliquid-handling-and-robots\u002Fhamilton-vantage\u002Fxl-channels\u002F","06.liquid-handling-and-robots\u002F42.hamilton-vantage\u002F40.xl-channels",{"title":705,"type":6,"device":6,"path":706,"stem":707,"children":708,"page":41},"Agilent Bravo","\u002Fliquid-handling-and-robots\u002Fagilent-bravo\u002F","06.liquid-handling-and-robots\u002F43.agilent-bravo",[709,712,715,718],{"title":625,"path":710,"stem":711,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Fagilent-bravo\u002Ftip-handling\u002F","06.liquid-handling-and-robots\u002F43.agilent-bravo\u002F10.tip-handling",{"title":617,"path":713,"stem":714,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Fagilent-bravo\u002Fbasic-pipetting\u002F","06.liquid-handling-and-robots\u002F43.agilent-bravo\u002F20.basic-pipetting",{"title":364,"path":716,"stem":717,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Fagilent-bravo\u002Fliquid-classes\u002F","06.liquid-handling-and-robots\u002F43.agilent-bravo\u002F25.liquid-classes",{"title":648,"path":719,"stem":720,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Fagilent-bravo\u002Fusing-the-gripper\u002F","06.liquid-handling-and-robots\u002F43.agilent-bravo\u002F30.using-the-gripper",{"title":722,"type":6,"device":6,"path":723,"stem":724,"children":725,"page":41},"Tecan FluentControl","\u002Fliquid-handling-and-robots\u002Ftecan-fluentcontrol\u002F","06.liquid-handling-and-robots\u002F44.tecan-fluentcontrol",[726,730,734],{"title":727,"path":728,"stem":729,"type":24,"device":6},"Connect & Run a Method","\u002Fliquid-handling-and-robots\u002Ftecan-fluentcontrol\u002Fconnect-and-run\u002F","06.liquid-handling-and-robots\u002F44.tecan-fluentcontrol\u002F10.connect-and-run",{"title":731,"path":732,"stem":733,"type":24,"device":6},"Sending XML Commands","\u002Fliquid-handling-and-robots\u002Ftecan-fluentcontrol\u002Fsending-xml-commands\u002F","06.liquid-handling-and-robots\u002F44.tecan-fluentcontrol\u002F20.sending-xml-commands",{"title":735,"path":736,"stem":737,"type":24,"device":6},"Full Workflow Example","\u002Fliquid-handling-and-robots\u002Ftecan-fluentcontrol\u002Ffull-workflow-example\u002F","06.liquid-handling-and-robots\u002F44.tecan-fluentcontrol\u002F30.full-workflow-example",{"title":739,"type":6,"device":6,"path":740,"stem":741,"children":742,"page":41},"Tecan Freedom EVO","\u002Fliquid-handling-and-robots\u002Ftecan-freedom-evo\u002F","06.liquid-handling-and-robots\u002F45.tecan-freedom-evo",[743,747,750,753,757],{"title":744,"path":745,"stem":746,"type":24,"device":6},"Deck & Carriers","\u002Fliquid-handling-and-robots\u002Ftecan-freedom-evo\u002Fdeck-and-carriers\u002F","06.liquid-handling-and-robots\u002F45.tecan-freedom-evo\u002F10.deck-and-carriers",{"title":625,"path":748,"stem":749,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Ftecan-freedom-evo\u002Ftip-handling\u002F","06.liquid-handling-and-robots\u002F45.tecan-freedom-evo\u002F20.tip-handling",{"title":617,"path":751,"stem":752,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Ftecan-freedom-evo\u002Fbasic-pipetting\u002F","06.liquid-handling-and-robots\u002F45.tecan-freedom-evo\u002F30.basic-pipetting",{"title":754,"path":755,"stem":756,"type":24,"device":6},"Using the Gripper (RoMa)","\u002Fliquid-handling-and-robots\u002Ftecan-freedom-evo\u002Fusing-the-gripper\u002F","06.liquid-handling-and-robots\u002F45.tecan-freedom-evo\u002F40.using-the-gripper",{"title":364,"path":758,"stem":759,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Ftecan-freedom-evo\u002Fliquid-classes\u002F","06.liquid-handling-and-robots\u002F45.tecan-freedom-evo\u002F50.liquid-classes",{"title":245,"type":6,"device":6,"path":761,"stem":762,"children":763,"page":41},"\u002Flabware\u002F","07.labware",[764,767,771,775,779,783,787],{"title":194,"path":765,"stem":766,"type":14,"device":6},"\u002Flabware\u002Foverview\u002F","07.labware\u002F00.overview",{"title":768,"path":769,"stem":770,"type":200,"device":6},"Standard Labware","\u002Flabware\u002Fstandard-labware\u002F","07.labware\u002F10.standard-labware",{"title":772,"path":773,"stem":774,"type":200,"device":6},"Plates","\u002Flabware\u002Fplates\u002F","07.labware\u002F20.plates",{"title":776,"path":777,"stem":778,"type":200,"device":6},"Tips and Tip Racks","\u002Flabware\u002Ftips-and-racks\u002F","07.labware\u002F30.tips-and-racks",{"title":780,"path":781,"stem":782,"type":200,"device":6},"Tubes and Tube Racks","\u002Flabware\u002Ftubes-and-tube-racks\u002F","07.labware\u002F40.tubes-and-tube-racks",{"title":784,"path":785,"stem":786,"type":200,"device":6},"Troughs","\u002Flabware\u002Ftroughs\u002F","07.labware\u002F50.troughs",{"title":788,"path":789,"stem":790,"type":200,"device":6},"Carriers and Adapters","\u002Flabware\u002Fcarriers-and-adapters\u002F","07.labware\u002F60.carriers-and-adapters",{"title":792,"type":6,"device":6,"path":793,"stem":794,"children":795},"Connector Development (CDK)","\u002Fconnector-development\u002F","20.connector-development",[796,798,822,855,863,903],{"title":194,"path":793,"stem":797,"type":14,"device":6},"20.connector-development\u002Findex",{"title":799,"path":800,"stem":801,"children":802,"page":41},"Getting Started","\u002Fconnector-development\u002Fgetting-started\u002F","20.connector-development\u002F10.getting-started",[803,806,810,814,818],{"title":194,"path":804,"stem":805,"type":285,"device":6},"\u002Fconnector-development\u002Fgetting-started\u002Foverview\u002F","20.connector-development\u002F10.getting-started\u002F10.overview",{"title":807,"path":808,"stem":809,"type":24,"device":6},"What's new","\u002Fconnector-development\u002Fgetting-started\u002Fwhats-new\u002F","20.connector-development\u002F10.getting-started\u002F20.whats-new",{"title":811,"path":812,"stem":813,"type":24,"device":6},"Installation","\u002Fconnector-development\u002Fgetting-started\u002Finstallation\u002F","20.connector-development\u002F10.getting-started\u002F30.installation",{"title":815,"path":816,"stem":817,"type":24,"device":6},"Python Environment and Project Management","\u002Fconnector-development\u002Fgetting-started\u002Fpython-environments\u002F","20.connector-development\u002F10.getting-started\u002F35.python-environments",{"title":819,"path":820,"stem":821,"type":24,"device":6},"Contributing","\u002Fconnector-development\u002Fgetting-started\u002Fcontributing\u002F","20.connector-development\u002F10.getting-started\u002F40.contributing",{"title":823,"path":824,"stem":825,"children":826,"page":41},"Tutorial","\u002Fconnector-development\u002Ftutorial\u002F","20.connector-development\u002F20.tutorial",[827,831,835,839,843,847,851],{"title":828,"path":829,"stem":830,"type":46,"device":6},"Walkthrough","\u002Fconnector-development\u002Ftutorial\u002Fwalkthrough\u002F","20.connector-development\u002F20.tutorial\u002F00.walkthrough",{"title":832,"path":833,"stem":834,"type":46,"device":6},"SiLA Endpoints","\u002Fconnector-development\u002Ftutorial\u002Fsila-endpoints\u002F","20.connector-development\u002F20.tutorial\u002F10.sila-endpoints",{"title":836,"path":837,"stem":838,"type":46,"device":6},"Data Endpoints","\u002Fconnector-development\u002Ftutorial\u002Fdata-endpoints\u002F","20.connector-development\u002F20.tutorial\u002F20.data-endpoints",{"title":840,"path":841,"stem":842,"type":46,"device":6},"Controls","\u002Fconnector-development\u002Ftutorial\u002Fcontrols\u002F","20.connector-development\u002F20.tutorial\u002F30.controls",{"title":844,"path":845,"stem":846,"type":46,"device":6},"SiLA Data Types","\u002Fconnector-development\u002Ftutorial\u002Fdata-types\u002F","20.connector-development\u002F20.tutorial\u002F40.data-types",{"title":848,"path":849,"stem":850,"type":46,"device":6},"Feature","\u002Fconnector-development\u002Ftutorial\u002Fconnector-structure\u002F","20.connector-development\u002F20.tutorial\u002F70.connector-structure",{"title":852,"path":853,"stem":854,"type":46,"device":6},"Hardware Communication","\u002Fconnector-development\u002Ftutorial\u002Fhardware-communication\u002F","20.connector-development\u002F20.tutorial\u002F90.hardware-communication",{"title":272,"type":6,"device":6,"path":856,"stem":857,"children":858,"page":41},"\u002Fconnector-development\u002Fconcepts\u002F","20.connector-development\u002F30.concepts",[859],{"title":860,"path":861,"stem":862,"type":285,"device":6},"SiLA","\u002Fconnector-development\u002Fconcepts\u002Fsila\u002F","20.connector-development\u002F30.concepts\u002Fsila",{"title":864,"path":865,"stem":866,"children":867,"page":41},"Guides","\u002Fconnector-development\u002Fguides\u002F","20.connector-development\u002F40.guides",[868,872,876,880,884,888,892,895,899],{"title":869,"path":870,"stem":871,"type":24,"device":6},"Configuration","\u002Fconnector-development\u002Fguides\u002Fconfiguration\u002F","20.connector-development\u002F40.guides\u002F20.configuration",{"title":873,"path":874,"stem":875,"type":24,"device":6},"Logging","\u002Fconnector-development\u002Fguides\u002Flogging\u002F","20.connector-development\u002F40.guides\u002F21.logging",{"title":877,"path":878,"stem":879,"type":24,"device":6},"Deployment","\u002Fconnector-development\u002Fguides\u002Fdeployment\u002F","20.connector-development\u002F40.guides\u002F30.deployment",{"title":881,"path":882,"stem":883,"type":24,"device":6},"Security","\u002Fconnector-development\u002Fguides\u002Fsecurity\u002F","20.connector-development\u002F40.guides\u002F40.security",{"title":885,"path":886,"stem":887,"type":24,"device":6},"Subscriptions","\u002Fconnector-development\u002Fguides\u002Fsubscriptions\u002F","20.connector-development\u002F40.guides\u002F45.subscriptions",{"title":889,"path":890,"stem":891,"type":24,"device":6},"Execution Modes","\u002Fconnector-development\u002Fguides\u002Fexecution-modes\u002F","20.connector-development\u002F40.guides\u002F46.execution-modes",{"title":380,"path":893,"stem":894,"type":24,"device":6},"\u002Fconnector-development\u002Fguides\u002Ferror-handling\u002F","20.connector-development\u002F40.guides\u002F50.error-handling",{"title":896,"path":897,"stem":898,"type":24,"device":6},"Serial Troubleshooting","\u002Fconnector-development\u002Fguides\u002Fserial-troubleshooting\u002F","20.connector-development\u002F40.guides\u002F70.serial-troubleshooting",{"title":900,"path":901,"stem":902,"type":24,"device":6},"Testing","\u002Fconnector-development\u002Fguides\u002Ftesting\u002F","20.connector-development\u002F40.guides\u002F80.testing",{"title":904,"path":905,"stem":906,"children":907,"type":6,"device":6},"References","\u002Fconnector-development\u002Freference\u002F","20.connector-development\u002F50.reference\u002Findex",[908],{"title":904,"path":905,"stem":906,"type":200,"device":6},{"id":910,"title":132,"body":911,"description":2336,"device":6,"extension":2337,"links":6,"meta":2338,"navigation":1218,"path":2339,"seo":2340,"stem":134,"type":24,"__hash__":2341},"docs\u002F02.how-to\u002F07.automate\u002F40.cicd-for-workflows.md",{"type":912,"value":913,"toc":2319},"minimark",[914,940,945,952,971,1054,1084,1090,1094,1097,1155,1161,1178,1181,1188,1196,1380,1403,1410,1565,1572,1678,1681,1692,1995,2068,2072,2089,2101,2115,2119,2126,2269,2273,2276,2284,2291,2295,2315],[915,916,917,918,922,923,927,928,931,932,936,937,939],"p",{},"The ",[919,920,921],"a",{"href":207},"workflow template"," ships ready-to-use CI\u002FCD for both ",[924,925,926],"strong",{},"GitHub Actions"," and ",[924,929,930],{},"GitLab CI",": pipelines your Git host runs automatically to check and deploy workflows on every push or release. Both wire ",[933,934,935],"code",{},"scripts\u002Fdeploy.py"," (see ",[919,938,124],{"href":125},") into the same three-channel model.",[941,942,944],"h2",{"id":943},"the-three-channel-model","The three-channel model",[915,946,947,948,951],{},"A ",[924,949,950],{},"workflow record"," is one entry on the platform's Workflows page: the thing an operator picks to start a run. It holds the uploaded bundle, the entrypoint, the resolved dependency list, and the tags.",[915,953,954,955,958,959,962,963,966,967,970],{},"The platform itself has no channel or environment concept. It identifies a record by its display name, and that is what ",[933,956,957],{},"--channel"," works with: it prepends ",[933,960,961],{},"[DEV] ",", ",[933,964,965],{},"[STG] ",", or ",[933,968,969],{},"[PRD] "," to the name before deploying. Three channels therefore produce three differently named records of the same workflow in one tenant:",[972,973,974,993],"table",{},[975,976,977],"thead",{},[978,979,980,984,987,990],"tr",{},[981,982,983],"th",{},"Channel",[981,985,986],{},"Trigger",[981,988,989],{},"Display-name prefix",[981,991,992],{},"Intent",[994,995,996,1014,1034],"tbody",{},[978,997,998,1004,1007,1011],{},[999,1000,1001],"td",{},[924,1002,1003],{},"DEV",[999,1005,1006],{},"Operator-triggered (web UI or API)",[999,1008,1009],{},[933,1010,961],{},[999,1012,1013],{},"Manual one-off deploys while iterating on a feature branch.",[978,1015,1016,1021,1027,1031],{},[999,1017,1018],{},[924,1019,1020],{},"STG",[999,1022,1023,1024],{},"Auto on push to ",[933,1025,1026],{},"main",[999,1028,1029],{},[933,1030,965],{},[999,1032,1033],{},"Every workflow affected by the merge is redeployed to STG.",[978,1035,1036,1041,1047,1051],{},[999,1037,1038],{},[924,1039,1040],{},"PRD",[999,1042,1043,1044],{},"Auto on per-workflow release tag ",[933,1045,1046],{},"\u003Cslug>\u002Fv\u003CX.Y.Z>",[999,1048,1049],{},[933,1050,969],{},[999,1052,1053],{},"One workflow ships at a verified version.",[915,1055,1056,1057,1060,1061,1064,1065,1068,1069,1072,1073,962,1076,1079,1080,1083],{},"So ",[933,1058,1059],{},"w02-liquid-handling",", whose display name is ",[933,1062,1063],{},"Liquid Handling Demo"," (from ",[933,1066,1067],{},"[tool.unitelabs.workflow].display_name"," in its ",[933,1070,1071],{},"pyproject.toml","), ends up as three entries: ",[933,1074,1075],{},"[DEV] Liquid Handling Demo",[933,1077,1078],{},"[STG] Liquid Handling Demo",", and ",[933,1081,1082],{},"[PRD] Liquid Handling Demo",". Each carries its own bundle, version, and tags.",[915,1085,1086,1087,1089],{},"A deploy only updates the record whose name matches, so a DEV deploy cannot touch PRD. That is the whole isolation mechanism: you can run against real instruments on DEV while PRD keeps serving production. STG always reflects ",[933,1088,1026],{},", and PRD shows what production runs.",[941,1091,1093],{"id":1092},"required-secrets","Required secrets",[915,1095,1096],{},"Both platforms read the same four secrets:",[972,1098,1099,1109],{},[975,1100,1101],{},[978,1102,1103,1106],{},[981,1104,1105],{},"Variable",[981,1107,1108],{},"Where to find it",[994,1110,1111,1123,1135,1145],{},[978,1112,1113,1118],{},[999,1114,1115],{},[933,1116,1117],{},"BASE_URL",[999,1119,1120],{},[933,1121,1122],{},"https:\u002F\u002Fapi.\u003Cyour-tenant>.unitelabs.io\u002F",[978,1124,1125,1130],{},[999,1126,1127],{},[933,1128,1129],{},"AUTH_URL",[999,1131,1132],{},[933,1133,1134],{},"https:\u002F\u002Fauth.\u003Cyour-tenant>.unitelabs.io\u002Frealms\u002F\u003Ctenant>\u002Fprotocol\u002Fopenid-connect\u002F",[978,1136,1137,1142],{},[999,1138,1139],{},[933,1140,1141],{},"CLIENT_ID",[999,1143,1144],{},"OAuth2 client ID",[978,1146,1147,1152],{},[999,1148,1149],{},[933,1150,1151],{},"CLIENT_SECRET",[999,1153,1154],{},"OAuth2 client secret (mark as masked)",[915,1156,1157,1160],{},[924,1158,1159],{},"GitHub",": Settings → Secrets and variables → Actions → New repository secret.",[915,1162,1163,1166,1167,1169,1170,1173,1174,1177],{},[924,1164,1165],{},"GitLab",": Settings → CI\u002FCD → Variables. Mark ",[933,1168,1151],{}," as ",[924,1171,1172],{},"Masked"," so it never appears in logs; mark all four as ",[924,1175,1176],{},"Protected"," to restrict them to protected branches and tags.",[941,1179,926],{"id":1180},"github-actions",[915,1182,1183,1184,1187],{},"The template ships three files under ",[933,1185,1186],{},".github\u002Fworkflows\u002F",":",[1189,1190,1192,1195],"h3",{"id":1191},"deploy-devyml-manual",[933,1193,1194],{},"deploy-dev.yml"," — manual",[1197,1198,1203],"pre",{"className":1199,"code":1200,"language":1201,"meta":1202,"style":1202},"language-yaml shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-default","name: Deploy DEV\n\non:\n  workflow_dispatch:\n    inputs:\n      workflow_slug:\n        description: Workflow slug ([project].name from pyproject.toml)\n        required: true\n        type: string\n\npermissions:\n  contents: read\n\njobs:\n  deploy:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions\u002Fcheckout@v4\n      - uses: astral-sh\u002Fsetup-uv@v5\n      - name: Deploy to DEV\n        env:\n          BASE_URL: ${{ secrets.BASE_URL }}\n          AUTH_URL: ${{ secrets.AUTH_URL }}\n          CLIENT_ID: ${{ secrets.CLIENT_ID }}\n          CLIENT_SECRET: ${{ secrets.CLIENT_SECRET }}\n        run: |\n          SHORT_SHA=\"${GITHUB_SHA::7}\"\n          uv run scripts\u002Fdeploy.py \"${{ inputs.workflow_slug }}\" \\\n            --channel dev --tag \"$SHORT_SHA\"\n","yaml","",[933,1204,1205,1213,1220,1226,1232,1238,1244,1250,1256,1262,1267,1273,1279,1284,1290,1296,1302,1308,1314,1320,1326,1332,1338,1344,1350,1356,1362,1368,1374],{"__ignoreMap":1202},[1206,1207,1210],"span",{"class":1208,"line":1209},"line",1,[1206,1211,1212],{},"name: Deploy DEV\n",[1206,1214,1216],{"class":1208,"line":1215},2,[1206,1217,1219],{"emptyLinePlaceholder":1218},true,"\n",[1206,1221,1223],{"class":1208,"line":1222},3,[1206,1224,1225],{},"on:\n",[1206,1227,1229],{"class":1208,"line":1228},4,[1206,1230,1231],{},"  workflow_dispatch:\n",[1206,1233,1235],{"class":1208,"line":1234},5,[1206,1236,1237],{},"    inputs:\n",[1206,1239,1241],{"class":1208,"line":1240},6,[1206,1242,1243],{},"      workflow_slug:\n",[1206,1245,1247],{"class":1208,"line":1246},7,[1206,1248,1249],{},"        description: Workflow slug ([project].name from pyproject.toml)\n",[1206,1251,1253],{"class":1208,"line":1252},8,[1206,1254,1255],{},"        required: true\n",[1206,1257,1259],{"class":1208,"line":1258},9,[1206,1260,1261],{},"        type: string\n",[1206,1263,1265],{"class":1208,"line":1264},10,[1206,1266,1219],{"emptyLinePlaceholder":1218},[1206,1268,1270],{"class":1208,"line":1269},11,[1206,1271,1272],{},"permissions:\n",[1206,1274,1276],{"class":1208,"line":1275},12,[1206,1277,1278],{},"  contents: read\n",[1206,1280,1282],{"class":1208,"line":1281},13,[1206,1283,1219],{"emptyLinePlaceholder":1218},[1206,1285,1287],{"class":1208,"line":1286},14,[1206,1288,1289],{},"jobs:\n",[1206,1291,1293],{"class":1208,"line":1292},15,[1206,1294,1295],{},"  deploy:\n",[1206,1297,1299],{"class":1208,"line":1298},16,[1206,1300,1301],{},"    runs-on: ubuntu-latest\n",[1206,1303,1305],{"class":1208,"line":1304},17,[1206,1306,1307],{},"    steps:\n",[1206,1309,1311],{"class":1208,"line":1310},18,[1206,1312,1313],{},"      - uses: actions\u002Fcheckout@v4\n",[1206,1315,1317],{"class":1208,"line":1316},19,[1206,1318,1319],{},"      - uses: astral-sh\u002Fsetup-uv@v5\n",[1206,1321,1323],{"class":1208,"line":1322},20,[1206,1324,1325],{},"      - name: Deploy to DEV\n",[1206,1327,1329],{"class":1208,"line":1328},21,[1206,1330,1331],{},"        env:\n",[1206,1333,1335],{"class":1208,"line":1334},22,[1206,1336,1337],{},"          BASE_URL: ${{ secrets.BASE_URL }}\n",[1206,1339,1341],{"class":1208,"line":1340},23,[1206,1342,1343],{},"          AUTH_URL: ${{ secrets.AUTH_URL }}\n",[1206,1345,1347],{"class":1208,"line":1346},24,[1206,1348,1349],{},"          CLIENT_ID: ${{ secrets.CLIENT_ID }}\n",[1206,1351,1353],{"class":1208,"line":1352},25,[1206,1354,1355],{},"          CLIENT_SECRET: ${{ secrets.CLIENT_SECRET }}\n",[1206,1357,1359],{"class":1208,"line":1358},26,[1206,1360,1361],{},"        run: |\n",[1206,1363,1365],{"class":1208,"line":1364},27,[1206,1366,1367],{},"          SHORT_SHA=\"${GITHUB_SHA::7}\"\n",[1206,1369,1371],{"class":1208,"line":1370},28,[1206,1372,1373],{},"          uv run scripts\u002Fdeploy.py \"${{ inputs.workflow_slug }}\" \\\n",[1206,1375,1377],{"class":1208,"line":1376},29,[1206,1378,1379],{},"            --channel dev --tag \"$SHORT_SHA\"\n",[1381,1382,1385],"callout",{"color":1383,"icon":1384},"info","i-heroicons-information-circle",[915,1386,1387,1388,1391,1392,1395,1396,1399,1400,1402],{},"GitHub only renders the ",[924,1389,1390],{},"Run workflow"," button for ",[933,1393,1394],{},"workflow_dispatch"," jobs that exist on the repo's ",[924,1397,1398],{},"default branch",". Merge the workflow file to ",[933,1401,1026],{}," before expecting it to appear.",[1189,1404,1406,1409],{"id":1405},"deploy-stgyml-push-to-main-affected-workflows-only",[933,1407,1408],{},"deploy-stg.yml"," — push to main, affected workflows only",[1197,1411,1413],{"className":1199,"code":1412,"language":1201,"meta":1202,"style":1202},"name: Deploy STG\n\non:\n  push:\n    branches: [main]\n\npermissions:\n  contents: read\n\njobs:\n  deploy:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions\u002Fcheckout@v4\n        with:\n          fetch-depth: 0 # full history so --changed-from can diff\n      - uses: astral-sh\u002Fsetup-uv@v5\n      - name: Deploy affected workflows to STG\n        env:\n          BASE_URL: ${{ secrets.BASE_URL }}\n          AUTH_URL: ${{ secrets.AUTH_URL }}\n          CLIENT_ID: ${{ secrets.CLIENT_ID }}\n          CLIENT_SECRET: ${{ secrets.CLIENT_SECRET }}\n        run: |\n          # First push to a new branch reports a null `before` ref; fall back\n          # to HEAD~1 so we still compute a meaningful diff.\n          BEFORE=\"${{ github.event.before }}\"\n          if [ \"$BEFORE\" = \"0000000000000000000000000000000000000000\" ]; then\n            BEFORE=\"HEAD~1\"\n          fi\n          SHORT_SHA=\"${GITHUB_SHA::7}\"\n          uv run scripts\u002Fdeploy.py --changed-from \"$BEFORE\" \\\n            --channel stg --tag \"$SHORT_SHA\"\n",[933,1414,1415,1420,1424,1428,1433,1438,1442,1446,1450,1454,1458,1462,1466,1470,1474,1479,1484,1488,1493,1497,1501,1505,1509,1513,1517,1522,1527,1532,1537,1542,1548,1553,1559],{"__ignoreMap":1202},[1206,1416,1417],{"class":1208,"line":1209},[1206,1418,1419],{},"name: Deploy STG\n",[1206,1421,1422],{"class":1208,"line":1215},[1206,1423,1219],{"emptyLinePlaceholder":1218},[1206,1425,1426],{"class":1208,"line":1222},[1206,1427,1225],{},[1206,1429,1430],{"class":1208,"line":1228},[1206,1431,1432],{},"  push:\n",[1206,1434,1435],{"class":1208,"line":1234},[1206,1436,1437],{},"    branches: [main]\n",[1206,1439,1440],{"class":1208,"line":1240},[1206,1441,1219],{"emptyLinePlaceholder":1218},[1206,1443,1444],{"class":1208,"line":1246},[1206,1445,1272],{},[1206,1447,1448],{"class":1208,"line":1252},[1206,1449,1278],{},[1206,1451,1452],{"class":1208,"line":1258},[1206,1453,1219],{"emptyLinePlaceholder":1218},[1206,1455,1456],{"class":1208,"line":1264},[1206,1457,1289],{},[1206,1459,1460],{"class":1208,"line":1269},[1206,1461,1295],{},[1206,1463,1464],{"class":1208,"line":1275},[1206,1465,1301],{},[1206,1467,1468],{"class":1208,"line":1281},[1206,1469,1307],{},[1206,1471,1472],{"class":1208,"line":1286},[1206,1473,1313],{},[1206,1475,1476],{"class":1208,"line":1292},[1206,1477,1478],{},"        with:\n",[1206,1480,1481],{"class":1208,"line":1298},[1206,1482,1483],{},"          fetch-depth: 0 # full history so --changed-from can diff\n",[1206,1485,1486],{"class":1208,"line":1304},[1206,1487,1319],{},[1206,1489,1490],{"class":1208,"line":1310},[1206,1491,1492],{},"      - name: Deploy affected workflows to STG\n",[1206,1494,1495],{"class":1208,"line":1316},[1206,1496,1331],{},[1206,1498,1499],{"class":1208,"line":1322},[1206,1500,1337],{},[1206,1502,1503],{"class":1208,"line":1328},[1206,1504,1343],{},[1206,1506,1507],{"class":1208,"line":1334},[1206,1508,1349],{},[1206,1510,1511],{"class":1208,"line":1340},[1206,1512,1355],{},[1206,1514,1515],{"class":1208,"line":1346},[1206,1516,1361],{},[1206,1518,1519],{"class":1208,"line":1352},[1206,1520,1521],{},"          # First push to a new branch reports a null `before` ref; fall back\n",[1206,1523,1524],{"class":1208,"line":1358},[1206,1525,1526],{},"          # to HEAD~1 so we still compute a meaningful diff.\n",[1206,1528,1529],{"class":1208,"line":1364},[1206,1530,1531],{},"          BEFORE=\"${{ github.event.before }}\"\n",[1206,1533,1534],{"class":1208,"line":1370},[1206,1535,1536],{},"          if [ \"$BEFORE\" = \"0000000000000000000000000000000000000000\" ]; then\n",[1206,1538,1539],{"class":1208,"line":1376},[1206,1540,1541],{},"            BEFORE=\"HEAD~1\"\n",[1206,1543,1545],{"class":1208,"line":1544},30,[1206,1546,1547],{},"          fi\n",[1206,1549,1551],{"class":1208,"line":1550},31,[1206,1552,1367],{},[1206,1554,1556],{"class":1208,"line":1555},32,[1206,1557,1558],{},"          uv run scripts\u002Fdeploy.py --changed-from \"$BEFORE\" \\\n",[1206,1560,1562],{"class":1208,"line":1561},33,[1206,1563,1564],{},"            --channel stg --tag \"$SHORT_SHA\"\n",[1189,1566,1568,1571],{"id":1567},"deploy-prdyml-per-workflow-release-tag",[933,1569,1570],{},"deploy-prd.yml"," — per-workflow release tag",[1197,1573,1575],{"className":1199,"code":1574,"language":1201,"meta":1202,"style":1202},"name: Deploy PRD\n\non:\n  push:\n    tags:\n      - '*\u002Fv*.*.*'\n\npermissions:\n  contents: read\n\njobs:\n  deploy:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions\u002Fcheckout@v4\n      - uses: astral-sh\u002Fsetup-uv@v5\n      - name: Deploy tagged release to PRD\n        env:\n          BASE_URL: ${{ secrets.BASE_URL }}\n          AUTH_URL: ${{ secrets.AUTH_URL }}\n          CLIENT_ID: ${{ secrets.CLIENT_ID }}\n          CLIENT_SECRET: ${{ secrets.CLIENT_SECRET }}\n        run: |\n          uv run scripts\u002Fdeploy.py --git-tag \"$GITHUB_REF_NAME\" --channel prd\n",[933,1576,1577,1582,1586,1590,1594,1599,1604,1608,1612,1616,1620,1624,1628,1632,1636,1640,1644,1649,1653,1657,1661,1665,1669,1673],{"__ignoreMap":1202},[1206,1578,1579],{"class":1208,"line":1209},[1206,1580,1581],{},"name: Deploy PRD\n",[1206,1583,1584],{"class":1208,"line":1215},[1206,1585,1219],{"emptyLinePlaceholder":1218},[1206,1587,1588],{"class":1208,"line":1222},[1206,1589,1225],{},[1206,1591,1592],{"class":1208,"line":1228},[1206,1593,1432],{},[1206,1595,1596],{"class":1208,"line":1234},[1206,1597,1598],{},"    tags:\n",[1206,1600,1601],{"class":1208,"line":1240},[1206,1602,1603],{},"      - '*\u002Fv*.*.*'\n",[1206,1605,1606],{"class":1208,"line":1246},[1206,1607,1219],{"emptyLinePlaceholder":1218},[1206,1609,1610],{"class":1208,"line":1252},[1206,1611,1272],{},[1206,1613,1614],{"class":1208,"line":1258},[1206,1615,1278],{},[1206,1617,1618],{"class":1208,"line":1264},[1206,1619,1219],{"emptyLinePlaceholder":1218},[1206,1621,1622],{"class":1208,"line":1269},[1206,1623,1289],{},[1206,1625,1626],{"class":1208,"line":1275},[1206,1627,1295],{},[1206,1629,1630],{"class":1208,"line":1281},[1206,1631,1301],{},[1206,1633,1634],{"class":1208,"line":1286},[1206,1635,1307],{},[1206,1637,1638],{"class":1208,"line":1292},[1206,1639,1313],{},[1206,1641,1642],{"class":1208,"line":1298},[1206,1643,1319],{},[1206,1645,1646],{"class":1208,"line":1304},[1206,1647,1648],{},"      - name: Deploy tagged release to PRD\n",[1206,1650,1651],{"class":1208,"line":1310},[1206,1652,1331],{},[1206,1654,1655],{"class":1208,"line":1316},[1206,1656,1337],{},[1206,1658,1659],{"class":1208,"line":1322},[1206,1660,1343],{},[1206,1662,1663],{"class":1208,"line":1328},[1206,1664,1349],{},[1206,1666,1667],{"class":1208,"line":1334},[1206,1668,1355],{},[1206,1670,1671],{"class":1208,"line":1340},[1206,1672,1361],{},[1206,1674,1675],{"class":1208,"line":1346},[1206,1676,1677],{},"          uv run scripts\u002Fdeploy.py --git-tag \"$GITHUB_REF_NAME\" --channel prd\n",[941,1679,930],{"id":1680},"gitlab-ci",[915,1682,1683,1684,1687,1688,1691],{},"The template's ",[933,1685,1686],{},".gitlab-ci.yml"," defines a hidden ",[933,1689,1690],{},".deploy-base"," template and three deploy jobs that extend it.",[1197,1693,1695],{"className":1199,"code":1694,"language":1201,"meta":1202,"style":1202},"variables:\n  SECRET_DETECTION_ENABLED: 'true'\n  # WORKFLOW_SLUG renders as an input field on the \"Run pipeline\" web UI.\n  # Pipeline-level (not job-level) so the `description:` form works.\n  WORKFLOW_SLUG:\n    value: ''\n    description: 'Workflow slug for deploy-dev ([project].name from pyproject.toml)'\n\nstages:\n  - secret-detection\n  - lint\n  - deploy\n\n# scripts\u002Fdeploy.py needs only requests + python-dotenv + stdlib. We install\n# them directly to avoid pulling unitelabs-* SDK git sources (no SSH creds on\n# the runner). Image is `python:3.12` (NOT -slim) because deploy-stg's\n# --changed-from shells out to `git diff`, which slim lacks.\n.deploy-base:\n  stage: deploy\n  image: python:3.12\n  before_script:\n    - pip install --quiet requests python-dotenv\n\ndeploy-dev:\n  extends: .deploy-base\n  script:\n    - test -n \"$WORKFLOW_SLUG\" || { echo \"WORKFLOW_SLUG is required\"; exit 1; }\n    - python scripts\u002Fdeploy.py \"$WORKFLOW_SLUG\" --channel dev --tag \"$CI_COMMIT_SHORT_SHA\"\n  rules:\n    # Operator-triggered pipelines only (web UI or `glab ci run`).\n    - if: '$CI_PIPELINE_SOURCE == \"web\" || $CI_PIPELINE_SOURCE == \"api\"'\n      when: manual\n\ndeploy-stg:\n  extends: .deploy-base\n  # Full history so `git diff` against $CI_COMMIT_BEFORE_SHA works for any\n  # merge depth (default GitLab clone depth is 50).\n  variables:\n    GIT_DEPTH: '0'\n  script:\n    - |\n      BEFORE=\"$CI_COMMIT_BEFORE_SHA\"\n      if [ \"$BEFORE\" = \"0000000000000000000000000000000000000000\" ]; then\n        BEFORE=\"HEAD~1\"\n      fi\n      python scripts\u002Fdeploy.py --changed-from \"$BEFORE\" \\\n        --channel stg --tag \"$CI_COMMIT_SHORT_SHA\"\n  rules:\n    - if: '$CI_COMMIT_BRANCH == \"main\"'\n\ndeploy-prd:\n  extends: .deploy-base\n  script:\n    - python scripts\u002Fdeploy.py --git-tag \"$CI_COMMIT_TAG\" --channel prd\n  rules:\n    # Per-workflow release tags only: `\u003Cslug>\u002Fv\u003CX.Y.Z>`.\n    - if: '$CI_COMMIT_TAG =~ \u002F^[a-z][a-z0-9-]*\\\u002Fv\\d+\\.\\d+\\.\\d+$\u002F'\n",[933,1696,1697,1702,1707,1712,1717,1722,1727,1732,1736,1741,1746,1751,1756,1760,1765,1770,1775,1780,1785,1790,1795,1800,1805,1809,1814,1819,1824,1829,1834,1839,1844,1849,1854,1858,1864,1869,1875,1881,1887,1893,1898,1904,1910,1916,1922,1928,1934,1940,1945,1951,1956,1962,1967,1972,1978,1983,1989],{"__ignoreMap":1202},[1206,1698,1699],{"class":1208,"line":1209},[1206,1700,1701],{},"variables:\n",[1206,1703,1704],{"class":1208,"line":1215},[1206,1705,1706],{},"  SECRET_DETECTION_ENABLED: 'true'\n",[1206,1708,1709],{"class":1208,"line":1222},[1206,1710,1711],{},"  # WORKFLOW_SLUG renders as an input field on the \"Run pipeline\" web UI.\n",[1206,1713,1714],{"class":1208,"line":1228},[1206,1715,1716],{},"  # Pipeline-level (not job-level) so the `description:` form works.\n",[1206,1718,1719],{"class":1208,"line":1234},[1206,1720,1721],{},"  WORKFLOW_SLUG:\n",[1206,1723,1724],{"class":1208,"line":1240},[1206,1725,1726],{},"    value: ''\n",[1206,1728,1729],{"class":1208,"line":1246},[1206,1730,1731],{},"    description: 'Workflow slug for deploy-dev ([project].name from pyproject.toml)'\n",[1206,1733,1734],{"class":1208,"line":1252},[1206,1735,1219],{"emptyLinePlaceholder":1218},[1206,1737,1738],{"class":1208,"line":1258},[1206,1739,1740],{},"stages:\n",[1206,1742,1743],{"class":1208,"line":1264},[1206,1744,1745],{},"  - secret-detection\n",[1206,1747,1748],{"class":1208,"line":1269},[1206,1749,1750],{},"  - lint\n",[1206,1752,1753],{"class":1208,"line":1275},[1206,1754,1755],{},"  - deploy\n",[1206,1757,1758],{"class":1208,"line":1281},[1206,1759,1219],{"emptyLinePlaceholder":1218},[1206,1761,1762],{"class":1208,"line":1286},[1206,1763,1764],{},"# scripts\u002Fdeploy.py needs only requests + python-dotenv + stdlib. We install\n",[1206,1766,1767],{"class":1208,"line":1292},[1206,1768,1769],{},"# them directly to avoid pulling unitelabs-* SDK git sources (no SSH creds on\n",[1206,1771,1772],{"class":1208,"line":1298},[1206,1773,1774],{},"# the runner). Image is `python:3.12` (NOT -slim) because deploy-stg's\n",[1206,1776,1777],{"class":1208,"line":1304},[1206,1778,1779],{},"# --changed-from shells out to `git diff`, which slim lacks.\n",[1206,1781,1782],{"class":1208,"line":1310},[1206,1783,1784],{},".deploy-base:\n",[1206,1786,1787],{"class":1208,"line":1316},[1206,1788,1789],{},"  stage: deploy\n",[1206,1791,1792],{"class":1208,"line":1322},[1206,1793,1794],{},"  image: python:3.12\n",[1206,1796,1797],{"class":1208,"line":1328},[1206,1798,1799],{},"  before_script:\n",[1206,1801,1802],{"class":1208,"line":1334},[1206,1803,1804],{},"    - pip install --quiet requests python-dotenv\n",[1206,1806,1807],{"class":1208,"line":1340},[1206,1808,1219],{"emptyLinePlaceholder":1218},[1206,1810,1811],{"class":1208,"line":1346},[1206,1812,1813],{},"deploy-dev:\n",[1206,1815,1816],{"class":1208,"line":1352},[1206,1817,1818],{},"  extends: .deploy-base\n",[1206,1820,1821],{"class":1208,"line":1358},[1206,1822,1823],{},"  script:\n",[1206,1825,1826],{"class":1208,"line":1364},[1206,1827,1828],{},"    - test -n \"$WORKFLOW_SLUG\" || { echo \"WORKFLOW_SLUG is required\"; exit 1; }\n",[1206,1830,1831],{"class":1208,"line":1370},[1206,1832,1833],{},"    - python scripts\u002Fdeploy.py \"$WORKFLOW_SLUG\" --channel dev --tag \"$CI_COMMIT_SHORT_SHA\"\n",[1206,1835,1836],{"class":1208,"line":1376},[1206,1837,1838],{},"  rules:\n",[1206,1840,1841],{"class":1208,"line":1544},[1206,1842,1843],{},"    # Operator-triggered pipelines only (web UI or `glab ci run`).\n",[1206,1845,1846],{"class":1208,"line":1550},[1206,1847,1848],{},"    - if: '$CI_PIPELINE_SOURCE == \"web\" || $CI_PIPELINE_SOURCE == \"api\"'\n",[1206,1850,1851],{"class":1208,"line":1555},[1206,1852,1853],{},"      when: manual\n",[1206,1855,1856],{"class":1208,"line":1561},[1206,1857,1219],{"emptyLinePlaceholder":1218},[1206,1859,1861],{"class":1208,"line":1860},34,[1206,1862,1863],{},"deploy-stg:\n",[1206,1865,1867],{"class":1208,"line":1866},35,[1206,1868,1818],{},[1206,1870,1872],{"class":1208,"line":1871},36,[1206,1873,1874],{},"  # Full history so `git diff` against $CI_COMMIT_BEFORE_SHA works for any\n",[1206,1876,1878],{"class":1208,"line":1877},37,[1206,1879,1880],{},"  # merge depth (default GitLab clone depth is 50).\n",[1206,1882,1884],{"class":1208,"line":1883},38,[1206,1885,1886],{},"  variables:\n",[1206,1888,1890],{"class":1208,"line":1889},39,[1206,1891,1892],{},"    GIT_DEPTH: '0'\n",[1206,1894,1896],{"class":1208,"line":1895},40,[1206,1897,1823],{},[1206,1899,1901],{"class":1208,"line":1900},41,[1206,1902,1903],{},"    - |\n",[1206,1905,1907],{"class":1208,"line":1906},42,[1206,1908,1909],{},"      BEFORE=\"$CI_COMMIT_BEFORE_SHA\"\n",[1206,1911,1913],{"class":1208,"line":1912},43,[1206,1914,1915],{},"      if [ \"$BEFORE\" = \"0000000000000000000000000000000000000000\" ]; then\n",[1206,1917,1919],{"class":1208,"line":1918},44,[1206,1920,1921],{},"        BEFORE=\"HEAD~1\"\n",[1206,1923,1925],{"class":1208,"line":1924},45,[1206,1926,1927],{},"      fi\n",[1206,1929,1931],{"class":1208,"line":1930},46,[1206,1932,1933],{},"      python scripts\u002Fdeploy.py --changed-from \"$BEFORE\" \\\n",[1206,1935,1937],{"class":1208,"line":1936},47,[1206,1938,1939],{},"        --channel stg --tag \"$CI_COMMIT_SHORT_SHA\"\n",[1206,1941,1943],{"class":1208,"line":1942},48,[1206,1944,1838],{},[1206,1946,1948],{"class":1208,"line":1947},49,[1206,1949,1950],{},"    - if: '$CI_COMMIT_BRANCH == \"main\"'\n",[1206,1952,1954],{"class":1208,"line":1953},50,[1206,1955,1219],{"emptyLinePlaceholder":1218},[1206,1957,1959],{"class":1208,"line":1958},51,[1206,1960,1961],{},"deploy-prd:\n",[1206,1963,1965],{"class":1208,"line":1964},52,[1206,1966,1818],{},[1206,1968,1970],{"class":1208,"line":1969},53,[1206,1971,1823],{},[1206,1973,1975],{"class":1208,"line":1974},54,[1206,1976,1977],{},"    - python scripts\u002Fdeploy.py --git-tag \"$CI_COMMIT_TAG\" --channel prd\n",[1206,1979,1981],{"class":1208,"line":1980},55,[1206,1982,1838],{},[1206,1984,1986],{"class":1208,"line":1985},56,[1206,1987,1988],{},"    # Per-workflow release tags only: `\u003Cslug>\u002Fv\u003CX.Y.Z>`.\n",[1206,1990,1992],{"class":1208,"line":1991},57,[1206,1993,1994],{},"    - if: '$CI_COMMIT_TAG =~ \u002F^[a-z][a-z0-9-]*\\\u002Fv\\d+\\.\\d+\\.\\d+$\u002F'\n",[1381,1996,1999,2004],{"color":1997,"icon":1998},"warning","i-heroicons-exclamation-triangle",[915,2000,2001],{},[924,2002,2003],{},"Three pitfalls we hit when wiring this up:",[2005,2006,2007,2024,2047],"ul",{},[2008,2009,2010,2019,2020,2023],"li",{},[924,2011,2012,2015,2016],{},[933,2013,2014],{},"description:"," doesn't work on job-level ",[933,2017,2018],{},"variables:"," — only at the top-level block. Put ",[933,2021,2022],{},"WORKFLOW_SLUG"," at the pipeline level (as shown) so the \"Run pipeline\" UI renders an input field.",[2008,2025,2026,1079,2035,2038,2039,2042,2043,2046],{},[924,2027,2028,2031,2032],{},[933,2029,2030],{},"python:3.12-slim"," has no ",[933,2033,2034],{},"git",[933,2036,2037],{},"--changed-from"," shells out to ",[933,2040,2041],{},"git diff",". Use the regular ",[933,2044,2045],{},"python:3.12"," image.",[2008,2048,2049,2055,2056,2059,2060,2063,2064,2067],{},[924,2050,2051,2052],{},"The dev rule must include ",[933,2053,2054],{},"api",", not just ",[933,2057,2058],{},"web"," — ",[933,2061,2062],{},"glab ci run"," and other programmatic triggers report ",[933,2065,2066],{},"$CI_PIPELINE_SOURCE == \"api\"",".",[941,2069,2071],{"id":2070},"the-everything-affected-rule","The \"everything affected\" rule",[915,2073,2074,2077,2078,2081,2082,2085,2086,2088],{},[933,2075,2076],{},"deploy-stg"," deploys only workflows whose directory was touched in the merge — ",[924,2079,2080],{},"unless"," the diff includes ",[933,2083,2084],{},"shared\u002F"," or ",[933,2087,935],{},". Those two are special:",[2005,2090,2091,2096],{},[2008,2092,2093,2095],{},[933,2094,2084],{}," is copied into every workflow's bundle, so a change there reshapes every bundle.",[2008,2097,2098,2100],{},[933,2099,935],{}," rewrites every bundle's contents.",[915,2102,2103,2104,2107,2108,2111,2112,2114],{},"Touching either marks ",[924,2105,2106],{},"every workflow as affected"," and STG redeploys them all. The rule lives in Python (",[933,2109,2110],{},"affected_workflows()"," in ",[933,2113,935],{},") so it's testable and shared between local and CI runs — not duplicated across two CI dialects.",[941,2116,2118],{"id":2117},"end-to-end-release-walkthrough","End-to-end release walkthrough",[915,2120,2121,2122,2125],{},"Releasing ",[933,2123,2124],{},"w02-liquid-handling v1.2.0"," through CI:",[2127,2128,2129,2176,2190,2252],"ol",{},[2008,2130,2131,2134,2135],{},[924,2132,2133],{},"Iterate on DEV"," while developing on a feature branch:\n",[1197,2136,2140],{"className":2137,"code":2138,"language":2139,"meta":1202,"style":1202},"language-bash shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-default","# Local\nuv run scripts\u002Fdeploy.py w02-liquid-handling --channel dev\n# Or via CI: trigger deploy-dev with WORKFLOW_SLUG=w02-liquid-handling\n","bash",[933,2141,2142,2148,2171],{"__ignoreMap":1202},[1206,2143,2144],{"class":1208,"line":1209},[1206,2145,2147],{"class":2146},"sIsDC","# Local\n",[1206,2149,2150,2154,2158,2161,2164,2168],{"class":1208,"line":1215},[1206,2151,2153],{"class":2152},"sNqAu","uv",[1206,2155,2157],{"class":2156},"sCx38"," run",[1206,2159,2160],{"class":2156}," scripts\u002Fdeploy.py",[1206,2162,2163],{"class":2156}," w02-liquid-handling",[1206,2165,2167],{"class":2166},"sOiAX"," --channel",[1206,2169,2170],{"class":2156}," dev\n",[1206,2172,2173],{"class":1208,"line":1222},[1206,2174,2175],{"class":2146},"# Or via CI: trigger deploy-dev with WORKFLOW_SLUG=w02-liquid-handling\n",[2008,2177,2178,2181,2182,2059,2184,2186,2187,2189],{},[924,2179,2180],{},"Open an MR\u002FPR"," and merge to ",[933,2183,1026],{},[933,2185,2076],{}," fires automatically. If your diff touched ",[933,2188,2084],{},", all three workflows redeploy to STG; otherwise just the workflows you changed.",[2008,2191,2192,2195,2196,2198,2199],{},[924,2193,2194],{},"Bump the workflow's version"," in a follow-up commit on ",[933,2197,1026],{},":\n",[1197,2200,2202],{"className":2137,"code":2201,"language":2139,"meta":1202,"style":1202},"$EDITOR w02-liquid-handling\u002Fpyproject.toml   # bump [project].version → 1.2.0\ngit commit -am \"release: w02-liquid-handling v1.2.0\"\ngit tag w02-liquid-handling\u002Fv1.2.0\ngit push origin main --tags\n",[933,2203,2204,2213,2226,2236],{"__ignoreMap":1202},[1206,2205,2206,2210],{"class":1208,"line":1209},[1206,2207,2209],{"class":2208},"sc-9e","$EDITOR w02-liquid-handling\u002Fpyproject.toml   ",[1206,2211,2212],{"class":2146},"# bump [project].version → 1.2.0\n",[1206,2214,2215,2217,2220,2223],{"class":1208,"line":1215},[1206,2216,2034],{"class":2152},[1206,2218,2219],{"class":2156}," commit",[1206,2221,2222],{"class":2166}," -am",[1206,2224,2225],{"class":2156}," \"release: w02-liquid-handling v1.2.0\"\n",[1206,2227,2228,2230,2233],{"class":1208,"line":1222},[1206,2229,2034],{"class":2152},[1206,2231,2232],{"class":2156}," tag",[1206,2234,2235],{"class":2156}," w02-liquid-handling\u002Fv1.2.0\n",[1206,2237,2238,2240,2243,2246,2249],{"class":1208,"line":1228},[1206,2239,2034],{"class":2152},[1206,2241,2242],{"class":2156}," push",[1206,2244,2245],{"class":2156}," origin",[1206,2247,2248],{"class":2156}," main",[1206,2250,2251],{"class":2166}," --tags\n",[2008,2253,2254,2260,2261,2264,2265,2268],{},[924,2255,2256,2259],{},[933,2257,2258],{},"deploy-prd"," fires on the tag push."," ",[933,2262,2263],{},"scripts\u002Fdeploy.py --git-tag \u003Cslug>\u002Fv\u003CX.Y.Z>"," parses the tag, verifies the pyproject version matches ",[933,2266,2267],{},"1.2.0",", and refuses if they disagree.",[941,2270,2272],{"id":2271},"verify-a-deployment","Verify a deployment",[915,2274,2275],{},"Each CI job prints a line per deployed workflow:",[1197,2277,2282],{"className":2278,"code":2280,"language":2281},[2279],"language-text","Affected workflows since 'origin\u002Fmain': w02-liquid-handling\nAuthenticating...\n\n--- [STG] Liquid Handling Demo (v1.2.0) ---\nBuilding bundle...\nUpdating workflow id=70634682-5178-4881-b355-fbcb87448102\n  resolved deps: 4 packages (101 chars)\nDeployed: [STG] Liquid Handling Demo v1.2.0\n","text",[933,2283,2280],{"__ignoreMap":1202},[915,2285,2286,2287,2290],{},"Open the UniteLabs Workflows page and confirm the workflow appears with the expected ",[933,2288,2289],{},"[CHANNEL]"," prefix and version tag.",[941,2292,2294],{"id":2293},"next-steps","Next steps",[2005,2296,2297,2307],{},[2008,2298,2299,2303,2304,2306],{},[919,2300,2301],{"href":125},[924,2302,124],{}," — the full ",[933,2305,935],{}," reference, useful for local one-offs and for understanding what CI is actually running.",[2008,2308,2309,2314],{},[919,2310,2311],{"href":129},[924,2312,2313],{},"Trigger a workflow run"," — confirm a deployment end-to-end.",[2316,2317,2318],"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);}html pre.shiki code .sIsDC, html code.shiki .sIsDC{--shiki-light:#66707B;--shiki-default:#66707B;--shiki-dark:#8B949E}html pre.shiki code .sNqAu, html code.shiki .sNqAu{--shiki-light:#702C00;--shiki-default:#702C00;--shiki-dark:#FFA657}html pre.shiki code .sCx38, html code.shiki .sCx38{--shiki-light:#032563;--shiki-default:#032563;--shiki-dark:#A5D6FF}html pre.shiki code .sOiAX, html code.shiki .sOiAX{--shiki-light:#023B95;--shiki-default:#023B95;--shiki-dark:#79C0FF}html pre.shiki code .sc-9e, html code.shiki .sc-9e{--shiki-light:#0E1116;--shiki-default:#0E1116;--shiki-dark:#E6EDF3}",{"title":1202,"searchDepth":1209,"depth":1215,"links":2320},[2321,2322,2323,2331,2332,2333,2334,2335],{"id":943,"depth":1215,"text":944},{"id":1092,"depth":1215,"text":1093},{"id":1180,"depth":1215,"text":926,"children":2324},[2325,2327,2329],{"id":1191,"depth":1222,"text":2326},"deploy-dev.yml — manual",{"id":1405,"depth":1222,"text":2328},"deploy-stg.yml — push to main, affected workflows only",{"id":1567,"depth":1222,"text":2330},"deploy-prd.yml — per-workflow release tag",{"id":1680,"depth":1215,"text":930},{"id":2070,"depth":1215,"text":2071},{"id":2117,"depth":1215,"text":2118},{"id":2271,"depth":1215,"text":2272},{"id":2293,"depth":1215,"text":2294},"Automate workflow deploys to UniteLabs with three channels: DEV (manual), STG (push to main), PRD (per-workflow release tags), on GitHub Actions or GitLab CI.","md",{},"\u002Fhow-to\u002Fautomate\u002Fcicd-for-workflows",{"title":132,"description":2336},"B6HCz49Wp0kotFrI50Hp17JJ8JjNUe0BhxTwm7ClDHU",[2343,2345],{"title":128,"description":2344,"path":129},"Trigger a workflow run from the platform UI, the UniteLabs SDK, or the REST API.",{"title":136,"description":2346,"path":137},"Pause a workflow run so an operator can take a physical action, then resume automatically.",1791294169953]