SuperAPI AI 工具集

wendy-contributing

部署与运维

查看项目

更新于 10-16 01:14

技能介绍

用途:本技能面向 WendyOS 自身的内部开发与贡献,涵盖构建 OS 镜像、理解 agent 架构以及运行 E2E 测试。WendyOS 是基于 Yocto 构建的边缘计算嵌入式 Linux 系统,支持 NVIDIA Jetson(生产环境,含 OTA 更新)、Raspberry Pi 4/5 与 ARM64 虚拟机(开发)。

主要能力:wendy-agent 是类似 dockerd/containerd 的容器守护进程,通过 50051 端口的 gRPC 管理容器生命周期;镜像通过 wendy run 推送而非从 Docker Hub 拉取,没有 docker pull 等价操作,应用从源码部署。Yocto 构建涉及三个 meta 层:meta-wendyos-jetson(edgeos-image)、meta-wendyos-virtual(edgeos-vm-image)、meta-wendyos-rpi(edgeos-rpi-image)。

使用方式:通用构建流程为 cd meta-wendyos-<target>、./bootstrap.sh、source ./repos/poky/oe-init-build-env build、bitbake <image-name>;macOS 使用 Docker 构建环境 cd docker && ./docker-util.sh shell。E2E 测试位于 wendy-agent/E2ETests,需先启动 VM 并部署测试应用,再以 E2E_USE_EXISTING_VM=true E2E_VM_PATH=/path/to/meta-wendyos-virtual swift test 运行;VM 已运行时务必设置该变量以跳过脚本检查,将耗时从约 5s/测试降至约 0.01s/测试。所有 wendy 命令建议加 --json 获得非交互式 JSON 输出。

适用场景与限制:适合贡献者调试容器运行时、mDNS 发现、设备身份等内部机制。GitHub 托管 runner 不支持嵌套虚拟化,需自托管 runner 或本地运行 E2E。mDNS 发现测试约 5s/个属协议固有;预期失败(如 VM 中 WiFi)不应使用 Issue.record()。更多细节见 references 下的 yocto-meta-layers.md、system-internals.md、raspberry-pi.md。