注意：目前仅为 beta 版，无公开文档，随时可能改变用法

本仓库演示使用云开发预览模式快捷运行 notebook。点击云原生开发按钮，不会打开 WebIDE，而是执行 .cnb.yml 中配置的命令启动 jupyter lab 后，直接打开工具预览页面。

• 点击“一键预览”启动后直接进入 juypter notebook 界面。仓库中提供了两个样例，可以直接点击预览和运行 notebook

  • demo.ipynb 运行最简单的 python 代码和命令行
  • pytorch_vision_alexnet.ipynb 运行经典的 ai 模型 AlexNet 识别图片。参考自 pytorch 官方样例文档
  • 可以创建自己的 notebook 并运行 python 代码调用 ai 模型。
  • 目前安装的是 jupyterlab==4.4.9 ，工具更详细用法可参考 jupyter 官方文档

• 如果需要自定义开发环境，如预装 python 开源库等，参考 .ide/Dockerfile 中配置自行定义。

• 注意 notebook 变动后，文件不会自动提交到代码仓库。如需保存文件，可以在页面中打开 Terminal 命令行 bash，并使用通用 git 命令提交和 push

• 运行效果如图:

预览功能关键配置说明见下面代码。本仓库完整配置见 .cnb.yml 文件

# .cnb.yml
$:
  vscode:
    - docker:
        build: .ide/Dockerfile
      services:
        # 如需使用 docker 命令，可增加 docker 的 service
        # 如果在仅预览模式的 launch 启动命令中需要用到 docker 命令，则需将 docker 添加在第一个
        # - docker
        - name: vscode
          options:
            # 启用预览模式
            onlyPreview: true
            # 启动仅预览业务的 shell 命令，端口必须启动在 8686 。 本样例中为启动jupyter lab 后台服务器的命令, 见 .ide/Dockerfile 文件
            launch: /usr/local/bin/preview
            # 保活时间，单位毫秒，不设置默认 10 分钟没有心跳（检测不到开发环境内的 http 连接）即关闭开发环境
            keepAliveTimeout: 3600000
            # 是否守护进程模式，默认为 false，非守护进程模式
            # true：以守护进程模式启动，即 launch 启动预览业务服务时，会直接运行在后台
            # false：非守护进程模式启动，执行 launch 启动预览业务服务时，可以看到日志，且需要等待 launch 启动完成并主动退出，才会继续执行后续流程
            # 推荐设置为 false，由用户自己实现业务启动成功后退出进程并后台运行，这样可以看到业务启动日志，方便定位问题
            daemon: true
      # 开发环境启动后会执行的任务
      stages:
        - name: ls
          script: ls -al

如果想进入原始的远程开发 IDE 模式写代码，可以点击按钮 “执行” -> “启动远程开发”

预览模式基于远程开发，并在后台自动启动配置中的 launch: 命令，页面自动跳转访问启动后的 8686 端口。其他 Web 类有页面的开源工具，理论上都支持，可以自行尝试