核心功能
ZEDEDA Skill 是面向 ZEDEDA 边缘计算管理平台的完整 API 客户端，封装了 11 个服务域共 442 个 REST 端点。通过统一的命令行接口 python3 -m scripts.zededa <service> <command>，用户可对边缘节点、应用实例、Kubernetes 集群、存储卷、网络配置等资源执行 CRUD 操作。
主要服务模块
- Node Service（90 端点）：边缘节点生命周期、硬件型号、项目与 PCR 模板管理
- App Service（80 端点）：应用包、实例、镜像、数据存储及卷管理
- User Service（67 端点）：IAM 体系，涵盖用户、角色、企业、会话管理
- Storage / Orchestration / Kubernetes：补丁策略、集群编排、GitOps 与 Helm 支持
- Diagnostics / Network / Job：设备诊断、网络配置、批量作业执行
技术特性
- Bearer Token 认证机制，支持
ZEDEDA_API_TOKEN环境变量注入 - 结构化日志与可配置日志级别（DEBUG→ERROR）
- 自定义异常类型（
ZededaAuthError等）与自动重试逻辑 - 支持 JSON body 文件输入（
--body-file）便于批量操作 - 纯 Python 实现，可直接作为库导入进行二次开发
显著优点
- 功能完整性：覆盖 ZEDEDA 官方 API 的绝大多数能力，避免多工具拼凑
- 运维友好：统一 CLI 风格降低学习成本，支持脚本化批量运维
- 可观测性：内置请求日志与错误分类，便于排查边缘节点异常
局限性与风险
- 供应商锁定：深度耦合 ZEDEDA 专有 API，迁移成本较高
- 网络依赖：所有操作需直连 ZEDEDA 云端，离线环境不可用
- 权限风险：API Token 具备广泛权限，泄露可导致边缘基础设施被控
- 调试复杂度：442 个端点的参数组合庞大，文档覆盖可能不完整
适合人群
- 运维 ZEDEDA 边缘节点的 DevOps/SRE 工程师
- 需要自动化边缘应用部署的 CI/CD 流水线构建者
- 基于 ZEDEDA 平台开发行业解决方案的系统集成商
常规风险
- Token 硬编码或日志泄露导致的未授权访问
- 误操作批量重启/删除边缘节点引发生产事故
- 边缘节点网络抖动时 API 超时与状态不一致