Upgrade from Tracks

Differences between Tracks and Labs

• Content changes

  • Notes vs Pages

  • Challenges vs Pages and Activities

• YAML vs HCL

  • Single way to define all lab content, rather than mix of conventions and (file) formats

    • yaml, markdown, frontmatter, forced folder structure, scripts

  • Flexible file/folder structure

• Lifecycle scripts

• Implicit vs Explicit dependencies

  • Sandbox changes

  • Resources and References

  • Dependency Graph

  • Health Checks

• Native version control

  • Versioning, Branches and Tags

  • Workflow changes

Migrating a Track to a Lab

Step 1: Migration instructional content

instruqt lab convert --from-track <track-slug-or-directory>

>> Print the mapping from challenges to pages and activities

Step 2: Identify required sandbox components

List of containers, VMs, Cloud Accounts

List of setup scripts

Map out dependencies between components

Step 3: Implement Lab Sandbox

• Configure Containers, VMs, Cloud Accounts

• Replace scripted dependencies with health checks and resource references

Step 4: Push changes and test Lab

Getting started