用途:指导为 Educates 交互式培训平台创建和配置工作坊,从零搭建到校验完整流程。
主要能力:收集工作坊标题、描述、名称(小写、允许连字符、最长25字符、建议 lab- 前缀);确定工作坊位置与所需会话应用(终端默认启用,另可选编辑器、Kubernetes 访问、Kubernetes 控制台、Docker、镜像仓库、虚拟集群);生成目录结构(README.md、exercises/、resources/workshop.yaml、workshop/content/);生成 workshop.yaml;编写 Markdown 教学页面;校验定义与指令。
必要用法:workshop.yaml 必须使用 spec.publish 与 spec.workshop.files 结构,包含 $(image_repository) 与 $(workshop_version) 变量,不使用已弃用的 spec.content.files。终端需 enabled: true 与 layout: split;默认 security.token.enabled: false,仅需 kubectl 或 Kubernetes 控制台时设为 true。exercises/ 目录须至少含一个文件(如 README.md),存在时终端与编辑器以 ~/exercises 为根目录。教学页面用 YAML frontmatter 的 title,不用一级标题,文件名用 nn-page-name.md,00- 为概览、99- 为总结。可点击操作用 terminal:execute 等围栏代码块,含特殊字符或多行命令时用 command: |-。用 {{< param session_namespace >}} 等数据变量参数化。
适用场景:需要为 Educates 平台编写交互式动手实验或培训课程时。
限制:资料未提供具体收费、价格、平台支持范围与效果数据;部分细节需参考其 resources/ 下的参考文档与 https://docs.educates.dev/。