Import an existing lab

Import adopts an existing EVE lab into Git and clones a managed working copy. It does not rebuild the lab from YAML. It must never mutate source_lab.

This is not Pull from EVE (from_eve). Import is first adoption. from_eve refreshes an existing project from its managed lab.

Steps

  1. Connect. Sidebar → Import Lab.
  2. Choose the existing EVE lab path (the source).
  3. The extension writes Git files under IaC/<name>/ and records immutable source.lab.
  4. The managed copy is typically /IaC/<basename>.unl.

Labs with HTML workbooks (tasks of type: public) need agent 0.4.2-2 or later. Older agents fail import with cannot unmarshal string into Go struct field LabTask.id.

LOAD is different: Load Lab attaches without owning topology. You can start/stop/wipe/console/inspect. You cannot deploy, reconcile, destroy, or restore presentation.

After import

  • Treat source_lab as read-only forever.
  • Edit the Git project; apply changes to the managed lab with plan/deploy/reconcile.
  • eve-presentation.yml is restored after a full IMPORT deploy/recreate only. Ordinary reconcile does not replay visuals.

Next: Edit and validate.