python-azure-iot-edge-modules

Python Azure IoT Edge 模块

使用此技能设计、实现并验证基于 Python 的 IoT Edge 模块，用于遥测处理、本地推理、协议转换以及边缘到云集成。

何时使用

适用于以下请求：

• "quiero crear un modulo Python para IoT Edge"
• "como despliego modulos edge con manifest"
• "necesito filtrar/agregar telemetria antes de subirla"
• "como manejo desconexiones y reintentos en edge"

必读文档审查

在推荐运行时行为或部署决策之前，请审查：

• https://learn.microsoft.com/azure/iot-edge/
• https://learn.microsoft.com/es-es/azure/iot-edge/

最低检查项：

• 运行时架构与模块生命周期。
• 支持的主机操作系统和版本。
• 部署模型与配置流程。
• 当前发布/版本指南。

如果无法获取文档，请基于明确假设继续，并清晰标注这些假设。

Python 官方参考与最佳实践（必需）

在提出 Python 实现细节之前，请查阅官方 Python 来源：

• https://www.python.org/
• https://docs.python.org/3/
• https://docs.python.org/3/reference/
• https://docs.python.org/3/library/
• references/python-official-best-practices.md

优先使用官方文档而非社区片段，除非有特定兼容性原因需要偏离。

目标

• 交付以生产为重点的模块架构与实现计划。
• 确保网络多变情况下的可靠边缘消息传递。
• 提供部署、可观测性和验证产物。

模块用例

• 协议适配器（serial/Modbus/OPC-UA 到 IoT 消息格式）。
• 遥测增强与规范化。
• 本地异常检测或推理。
• 命令编排与本地执行器控制。

交付工作流

1) 契约与接口

定义：

• 模块输入与输出。
• 消息架构与版本控制策略。
• 正常与关键遥测的路由和优先级。
• 用于动态配置的期望属性。

2) 运行时与打包

指定：

• Python 运行时版本目标。
• 容器镜像策略（基础镜像、精简体积、CVE 卫生）。
• 资源画像（CPU/内存边界）。
• 启动与健康检查。

3) 可靠性设计

实现并验证：

• 带指数退避和抖动的重试。
• 上游故障时的优雅降级。
• 在需要时采用本地排队策略。
• 对重放消息进行幂等处理。

4) 安全控制

要求：

• 代码或清单中不得出现明文密钥。
• 模块行为遵循最小权限。
• 安全传输与受信任证书链处理。
• 命令处理和状态变更的可追溯性。

5) 部署与运维

定义：

• 特定环境的部署清单。
• 发布策略（试点、分阶段、广泛）。
• 回滚标准。
• SLO 与告警条件。

复用其他技能

在相关时，结合使用：

• azure-smart-city-iot-solution-builder 用于平台级架构。
• appinsights-instrumentation 用于遥测插桩方法。
• azure-resource-visualizer 用于架构图和依赖关系映射。

同时使用 references/python-official-best-practices.md 作为模块设计和实现指导的基线质量标准。

必需输出

始终提供：

1. 模块设计简报（目的、输入、输出）。
2. 部署模型（镜像、清单、环境设置）。
3. 可靠性与错误处理策略。
4. 安全与运维检查清单。
5. 测试矩阵（功能、混沌、性能、回滚）。

输出模板

使用 references/python-edge-module-template.md 来组织实现提案和评审。

1. 背景与假设
2. 模块架构
3. 部署与配置
4. 可靠性、安全性、可观测性
5. 验证与发布计划

防护栏

• 未经试点阶段，不要推荐直接在生产环境上线。
• 不要将机密信息嵌入 Dockerfile、源代码或清单中。
• 不要省略健康探测、重启行为和回滚标准。