# anolis-lab-courses

**Repository Path**: cha-echo/anolis-lab-courses

## Basic Information

- **Project Name**: anolis-lab-courses
- **Description**: 龙蜥实验室-课程
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 25
- **Created**: 2022-07-21
- **Last Updated**: 2022-08-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# anolis-lab-courses
 
龙蜥实验室为社区用户提供全方位的产品体验方式，主要有两种形式：
1. 资源服务：通过为社区用户免费提供机器资源的方式去体验 Anolis OS ，用户可以随时创建一台独立的机器进行实际体验。
2. 龙蜥课程以及解决方案：通过在线操作练习的方式去体验和学习龙蜥的生态；包括基础设施，云原生，操作系统等课程和解决方案等等。

`anolis-lab-courses` 是存放龙蜥社区课程的仓库，社区参与者可以通过此仓库接入课程资源。


## 接入方式
社区参与者可以通过提交 PR 的方式（gitee 仓库：[anolis-lab-courses ](https://gitee.com/anolis/anolis-lab-courses)）接入龙蜥实验室课程和解决方案等内容资源，PR 提交后会由龙蜥实验室的 maintainer 进行审核，审核通过后课程会自动同步到[龙蜥实验室网站](https://lab.openanolis.cn/#/apply/home)上。

## 接入说明

### 目录结构

anolis-lab-courses 课程仓库的目录结构定义：
1. `anolis-courses` 目录存放的是课程资源。
2. `anolis-solutions` 目录里存放的是解决方案的内容。

具体目录结构参考下面示例：

```bash

├── README.md
├── LICENSE
├── anolis-courses
│    ├── git-dev
│    │    ├── index.yaml
│    │    ├── assets
│    │    │   ├── poster.png
│    │    │   └── cover.png
│    │    ├── committing-code
│    │    │		├── assets
│    │    │   │		├── centos_to_anolis_migrations.avi
│    │    │   │		└── cover.png
│    │    │   ├── index.yaml
│    │    │   ├── start.md
│    │    │   ├── finish.md
│    │    │   ├── step1.md
│    │    │   ├── step2.md
│    │    │   └── step3.md
│    │    ├── working-remotely
│    │    │		├── assets
│    │    │   │		├── centos_to_anolis_migrations.avi
│    │    │   │		└── cover.png
│    │    │   ├── index.yaml
│    │    │   ├── start.md
│    │    │   ├── finish.md
│    │    │   ├── step1.md
│    │    │   ├── step2.md
│    │    │   ├── step3.md
│    │    │   └── step4.md   
├── anolis-solution
│    ├── centos2anolis
│    │    ├── index.yaml
│    │    ├── assets
│    │    │   ├── poster.png
│    │    │   └── cover.png
│    │    ├── centos7_to_anolisos7
│    │    │		├── assets
│    │    │   │		├── centos_to_anolis_migrations.avi
│    │    │   │		└── cover.png
│    │    │   ├── index.yaml
│    │    │   ├── start.md
│    │    │   ├── finish.md
│    │    │   ├── step1.md
│    │    │   ├── step2.md
│    │    │   ├── step3.md
│    │    │   ├── step4.md
│    │    │   └── step5.md
│    │    ├── centos8_to_anolisos8
│    │    │		├── assets
│    │    │   │		├── centos_to_anolis_migrations.avi
│    │    │   │		└── cover.png
│    │    │   ├── index.yaml
│    │    │   ├── start.md
│    │    │   ├── finish.md
│    │    │   ├── step1.md
│    │    │   ├── step2.md
│    │    │   └── step3.md  
```
### 格式定义

#### 1. 课程和章节配置

- 课程及解决方案index.yaml 中的 type 字段选项有：course，solution ；分别对应页面上的课程和解决方案
-  章节中：details 与 video 可以选填，两者必须填一个，根据情况展示。
- 机器审请规则：根据 chapter/scen 中的 image, live_time, machine 等字段去资源服务中审请相应机器。
   - 超出 live_time 时长，则自动释放机器。
- poster、cover 等非必填，若不填则使用默认配图。
- level 选项: advanced（高级）、intermediate（中级）、beginner（初级）

```yaml
# course/solution index.yaml
name: Centos 迁移 Anolis OS
desc: 学习如何从 Centos 迁移到 Anolis OS 。
type: solution  # course
poster: "./assets/poster.png"    # 不填则使用默认
cover: "./assets/cover.png"      # 不填则使用默认
total_time: "60 min"
level: "medium"                  # beginner、intermediate、advanced
chapters:
  - name: "Centos 7 迁移到 Anolis OS 7"
    desc: "学习如何从 Centos 7 迁移到 Anolis OS 7"
    content: "centos7_to_anolisos7"
    live_time: "30 min"
  - name: "Centos 8 迁移到 Anolis OS 8"
    desc: "学习如何从 Centos 8 迁移到 Anolis OS 8"
    content: "centos8_to_anolisos8"
    live_time: "30 min"   

# chapter/scen index.yaml
name: Centos 7 迁移到 Anolis OS 7
desc: 学习如何从 Centos 7 迁移到 Anolis OS 7
cover: "./assets/cover.png"      # 不填则使用默认
video: ../../assets/centos_to_anolis_migrations.avi
image: "Anolis OS 8.4 ANCK 64 位"
live_time: "30 min"   
machine: x86_64-2c4g   # cpu架构-机器规格，该字段为空，默认 x86_64-2c4g
max_clients: 5   # 最大并发使用数，不填则默认不限制
details:
  steps:
    start: start.md
    finish: finish.md
    - name: 审请 Centos 7 的机器
      content: step1.md
    - name: 登陆机器
      content: step2.md
    - name: 下载迁移脚本
      content: step3.md
    - name: 执行迁移脚本
      content: step4.md
    - name: 验证迁移结果
      content: step5.md      

  
```

#### 2. Step定义

step 采用 markdown 格式定义，课程中的每个步骤可以根据课程情况进行拆分成若干步骤。

命令双击自动录入占位符：`[[ this is the command ]]`

## 敬请期待

现在我们已经上线了一批课程资源，更多的课程也在设计接入中，敬请期待~

1. 目前课程的设计和开发主要由龙蜥社区各领域参与者主导，社区参与者也可以提交自己擅长的课程。
1. 对于课程的接入，我们后续会提供更简化的方式；另外也会有课程接入的实验环境进行测试。