Legacy to HCL Migration
Migrating from Legacy YAML to HCL Format
Section titled “Migrating from Legacy YAML to HCL Format”WIP
Migration Overview
Section titled “Migration Overview”WIP
Key Differences
Section titled “Key Differences”File Organization
Section titled “File Organization”Legacy Format:
track.yml- Track metadataconfig.yml- Sandbox configuration01-challenge/assignment.md- Challenge content01-challenge/check-workstation- Validation script
New HCL Format:
lab.hcl- Lab resource definitionsandbox.hcl- Infrastructure resourceschapters.hcl- Content organizationtasks.hcl- Interactive activitiesinstructions/chapter-1/page-1.md- Structured contentscripts/task-name/check.sh- Validation scripts
Resource Mapping
Section titled “Resource Mapping”| Legacy YAML | New HCL Format |
|---|---|
track.slug |
resource "lab" "{slug}" |
track.title |
lab.title |
config.containers |
resource "container" |
| Challenge directories | Pages and tasks |
assignment.md frontmatter |
Task metadata |
Migration Tools
Section titled “Migration Tools”WIP
Manual Migration Steps
Section titled “Manual Migration Steps”WIP
Best Practices
Section titled “Best Practices”WIP
Getting Help
Section titled “Getting Help”WIP