Katacoda - 创建课程

Posted 2021-11-05 王万林 Ben

创建课程

也可以自行设计并上传课程，以供其它用户学习。

新建组织与仓库

在kadacoda.com新建好组织，配置好Git仓库（主流的如GitHub、Gitee等都可以）与Webhook。（本篇具体步骤略）

创建完成后，就可以在您的 Git仓库上找到名为 katacoda-scenarios 的代码仓库。

Courses与Scenarios

Courses与Scenarios ，由一组 Markdown、bash 脚本和一个 JSON 文件组成，这些文件保存了所有配置。

Katacoda 官方提供了 CLI 工具，帮助您创建Courses与Scenarios。

安装 CLI

通过 npm 命令安装npm i katacoda-cli --global。

命令遵循语法的是 $ katacoda <COMMAND>

安装完成后，可以通过运行命令 $ katacoda --help 查看帮助信息。

创建 Scenarios 目录

例如，要创建新的方案，可以通过运行命令 katacoda scenarios:create，CLI 将会提示一些信息，帮助您创建方案：

• Friendly URL: 此处可输入 test-scenario，该属性将确定 scenarios 文件夹的名称，以及用来访问他的 URL。因此，该属性不能包括空格，需要是小写字母等。例如，如果您的用户名是 test-username 并且您的方案称为 test-scenario（如建议的那样），用于在平台中指向该方案的URL将为 https://katacoda.com/test-username/scenarios/test-scenario/
• Title: 方案的标题，将会显示在简介上
• Description: 方案的描述，将会显示在简介上
• Difficulty level: 难度级别，将会显示在简介上
• Estimated time: 估计完成的时间，将会显示在简介上
• Number of steps: 方案的步骤数。CLI 将会为您的所有步骤创建文件
• Image: 确定适用于您的方案的基本软件。例如，如果您需要 docker，java，go 等作为前提条件。更多相关信息，请阅读 https://katacoda.com/docs/scenarios/environments
• Layout: 它将确定方案界面元素的配置。例如，如果您只想显示终端，或编辑器+终端等形式，更多相关信息，请阅读 https://katacoda.com/docs/scenarios/layouts

输入这些信息，CLI 将帮您创建一个文件夹，其中引入了 friendly URL 的名称，并将在该文件夹内创建方案所需的文件。

编辑 Scenarios

Scenarios 目录创建好之后，可以看到目录的结构：

.
├── finish.md
├── index.json
├── intro.md
├── step1.md
├── step2.md
└── step3.md

• index.json ：文件中定义了标题、描述、步骤顺序、UI 布局以及所需环境，内容与您使用 CLI 工具创建时输入的是一致的，如果想对输入的内容进行修改，也可以在这里修改
• intro.md：介绍页，用来介绍您这个 Scenarios
• finish.md ：结束页
• step1-setpN.md：步骤介绍，数目与您使用 CLI 工具创建 Scenarios 时输入的数目相同

上传

将创建的 Scenarios 推送到创建的 git 项目中。

$ git add .
$ git commit -m "Courses/Scenarios by thesre."
$ git push origin master

随后在Katacoda.com的Your Profile页面就可以看到已上传的课程。

总结

专业的事交给专业的平台做，在当今地球村是非常重要的。在本篇，练习环境的准备，可以交给专业的Katacoda来为您准备。

参考资料

• Course：课程，可包含一系列的 scenarios。

  • 官方教程入口：https://katacoda.com/scenario-examples/scenarios/create-course
  • 汉化教程入口：https://www.katacoda.com/guoxudong/courses/katacoda-example/create-course

• Scenarios：场景、方案。

  • 官方教程入口：https://www.katacoda.com/scenario-examples/scenarios/create-scenario-101
  • 汉化教程入口：https://www.katacoda.com/guoxudong/courses/katacoda-example/katacoda-create-scenarios

https://developer.aliyun.com/article/752183