IT评测·应用市场-qidao123.com

标题: README.exe 是的，你看错是EXE [打印本页]
作者: 用户云卷云舒    时间: 2022-6-18 14:14
标题: README.exe 是的，你看错是EXE
SmartIDE让你的README变成可执行文档，再也不用编写无用的文档，再也不必操心环境问题。 作为开发者，拿到一个新的代码库的时候一般都会先去看README文件，通过这个文件可以知道这套代码所需要安装的环境，工具和操作方式。这件事情本来应该是一件很愉悦的事情，因为每一套新代码其实都是开发者的新玩具，拿到新玩具的心情那肯定是不错的。但是，当你阅读玩具说明书之后，发现这份说明书完全不配套的时候，那心里一定是一万匹草泥马在奔腾。当然，这也很容易理解，开发者不爱写文档，特别是那些没有用的文档。至少，README对写的人来说其实没啥用，因为写的人都已经清楚了文档中的内容，至于看的人感受如何，那就呵呵吧。
这个问题的根源在于README只能看，不能运行！如果我们能够让README活起来，从 README.md 变成 README.exe，那是不是就可以解决这个问题了呢？答案是肯定的！因为写的人自己也可以用这份文档来启动项目。这样，写文档的人有了动力，看（运行）文档的人也会很爽。
这就是SmartIDE的核心功能: IDE as Code能力。
神奇的IDE配置文件

SmartIDE最初始的设计灵感就是如何能够让README活起来？为了做到这一点，我们设计了一个 IDE配置文件 (默认文件名 .ide.yaml）文件格式。这个文件中完整描述了运行当前代码所需要的环境配置，包括 基础环境SDK，应用服务器，应用端口，配置文件，网络依赖以及所使用的IDE工具。有了这个文件，开发者就可以真正实现一键启动开发调试，而不会再听到：“在我这里工作呀，是你的环境问题！” 这种骇人听闻的抱怨。
有了这个文件，任何人都可以使用一个简单的指令来一键搭建一模一样的开发环境，指令如下：
Copy
  1. smartide start https://github.com/idcf-boat-house/boathouse-calculator
复制代码
这个指令会自动识别代码库中的 IDE配置文件，根据文件中对开发环境的描述完成获取开发者镜像、启动开发容器、克隆代码、运行初始化脚本等一系列动作，最终一个 完整可运行的环境 呈现在开发者的面前，下面这段视频展示了整个运行过程：
SmartIDE 快速启动演示（VSCode WebIDE） - 开发从未如此简单_哔哩哔哩_bilibiliIDE配置文件详解

以上示例中所使用的 .ide.yaml 文件如下
Copy
  1. version: smartide/v0.3
  2. orchestrator:
  3.   type: docker-compose
  4.   version: 3
  5. workspace:
  6.   dev-container: # 开发者容器设置
  7.     service-name: boathouse-calculator
  8.    
  9.     ports: # 申明端口
  10.       tools-webide-vscode: 6800
  11.       tools-ssh: 6822
  12.       apps-application: 3001
  13.    
  14.     ide-type: vscode  #sdk-only | vscode | opensumi | jb-projector
  15.     volumes: # 本地配置映射，支持映射git-config和ssh密钥信息进入容器
  16.       git-config: true
  17.       ssh-key: true
  18.     command: # 环境启动脚本
  19.       - npm config set registry https://registry.npmmirror.com
  20.       - npm install
  21.   services:
  22.     boathouse-calculator:
  23.       image: registry.cn-hangzhou.aliyuncs.com/smartide/smartide-node-v2-vscode:all-version
  24.       restart: always
  25.       environment:
  26.         ROOT_PASSWORD: root123
  27.         LOCAL_USER_PASSWORD: root123      
  28.       volumes:
  29.       - .:/home/project
  30.       ports:
  31.         - 3001:3001
  32.         - 6822:22
  33.         - 6800:3000
  34.       networks:
  35.         - smartide-network
  37.   networks:
  38.     smartide-network:
  39.       external: true
复制代码
这个文件内容非常通俗易懂，是个程序员应该都能看明白，不过我还是简单说明一下：
IDE as Code 重新定义IDE

这种做法称为 IDE as Code 也就是 “集成开发环境即代码”，将你的开发环境配置变成一个 IDE配置文件 的配置文件放置在代码库中，然后根据这个配置文件生成对应的自动化脚本，完成“集成开发环境” 的创建。因此，SmartIDE中的IDE不仅仅是一个开发工具，而是 包含了环境的IDE。
IDE as Code 的做法源自DevOps的核心实践 Infrastructure as Code ，也就是 “基础设施即代码” 简称 IaC。其核心思想是将环境配置代码化，常见的k8s的yaml文件其实就是典型的基础设施即代码实现。在运维领域常用的工具比如chef/puppet/ansible，还有 HashiCorp 的 Terraform 也都是 IaC 的经典实现。IaC 的主要价值和目标就是将环境搭建过程标准化，让任何人在任何环境中都可以获得 一致、稳定、可靠 的环境搭建体验。SmartIDE所创造的 IDE配置文件 延续IaC了的使用场景，并将其基本思路应用到了开发测试环境中，这其实就是 SmartIDE 的产品核心能力。
基于 IDE as Code 的实现，SmartIDE在产品实现过程中一直秉承一个原则：能够让用户通过配置文件实现的东西，就不要通过代码实现。这个核心原则给予了SmartIDE非常强的灵活性，比如以下这段视频中所演示的 若依管理系统 项目
 这个项目包括比较复杂的环境配置，包括：
若依项目的官方文档用了整整2页的篇幅描述开发环境的搭建 (参考链接：环境部署 | RuoYi） 。使用了 SmartIDE 以后，开发者可以一个统一的指令 smartide start 来启动这个复杂的项目，不再需要去阅读这个文档。无论项目的代码是简单亦或复杂，smartide start 指令都可以进行适配，因为其背后的复杂配置已经全部通过 IDE配置文件 和代码保存在一起了。使用 IDE as Code 的另外一个好处是，由于配置和代码保存在一起，进行代码变更的开发者可以同步更新环境配置，并且一起提交进行评审，也就是说：你的环境也和代码一样是可评审，可审计的。
IDE文件配置就是README活文档。
当然，SmartIDE能做的绝不仅仅如此，我们已经发布了 SmartIDE Server 版，允许开发者在网页上即可完成开发环境的搭建和完整的开发调试过程。Server与CLI一样使用这个 IDE配置文件 来识别和搭建环境，与cli保持一致的体验。这一切的目的都是让开发者的日常工作变得简单，让开发者体验 #开发从未如此简单 的快乐。
如果你对云原生开发环境感兴趣，请扫描以下二维码加入我们的 SmartIDE社区早鸟计划
谢谢您对SmartIDE的关注，让我们一起成为云原生时代的 Smart开发者, 享受 开发从未如此简单 的快乐。

来源：https://www.cnblogs.com/ups216/p/16319051.html
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！



欢迎光临 IT评测·应用市场-qidao123.com (https://dis.qidao123.com/) Powered by Discuz! X3.4