关于 azure-iot-edge
为使用 Azure IoT Edge 的团队提供运维、架构、安全、配置和部署指引,结合本地参考内容与联网获取的 Microsoft 文档。
主要功能
- 01排查设备与运行时问题
- 02规划边缘架构与连接
- 03配置安全与设备预配
- 04监控指标和模块健康状况
- 05大规模部署与更新设备
适用场景
- 01诊断 IoT Edge 设备错误
- 02设计网关与离线运行方案
- 03配置证书和设备预配
- 04规划部署与运行时更新
MCP 相关
该技能可通过 mcp_microsoftdocs:microsoft_docs_fetch 获取文档,也说明了 fetch_webpage 备用方式。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-iot-edge安装后在 Claude Code 中输入/azure-iot-edge确认已加载。
详细介绍
Azure IoT Edge 技能
此技能提供 Azure IoT Edge 方面的专业指导,涵盖故障排除、最佳实践、决策制定、架构与设计模式、限制与配额、安全性、配置、集成与编码模式,以及部署。它结合了本地快速参考内容和远程文档获取功能。
如何使用此技能
Agent 注意:使用下方的类别索引查找相关章节。对于包含行范围的类别(例如,
L35-L120),使用read_file读取指定行。对于包含文件链接的类别(例如,[security.md](security.md)),使用read_file读取链接的参考文件
Agent 注意:如果
metadata.generated_at距今超过 3 个月,请建议用户从仓库拉取最新版本。如果无法使用mcp_microsoftdocs工具,请建议用户安装它:安装指南
此技能需要网络访问权限以获取文档内容:
- 首选:使用
mcp_microsoftdocs:microsoft_docs_fetch,并将查询字符串设为from=learn-agent-skill。返回 Markdown。 - 备用:使用
fetch_webpage,并将查询字符串设为from=learn-agent-skill&accept=text/markdown。返回 Markdown。
类别索引
| 类别 | 行 | 说明 |
|---|---|---|
| 故障排除 | L37-L47 | 诊断和修复 IoT Edge 设备/运行时问题、监视和指标问题、Azure 门户故障,以及 EFLOW/Windows 网络和常见错误。 |
| 最佳实践 | L48-L55 | IoT Edge 的监视和生产指导:使用 Azure Monitor 工作簿、跟踪模块孪生运行状况、实施可观测性,以及应用适用于生产环境的最佳实践。 |
| 决策制定 | L56-L62 | 针对不同部署场景,选择 IoT Edge/EFLOW 平台、预配方法、网络设置和嵌套虚拟化选项的指导。 |
| 架构与设计模式 | L63-L69 | IoT Edge 拓扑的设计模式:网关场景、离线/间歇连接策略,以及为复杂部署配置多级(嵌套)Edge 层次结构 |
| 限制与配额 | L70-L74 | Azure IoT Edge 资源限制和配额,包括模块、部署、消息和设备限制,以及与可扩展性和性能相关的限制。 |
| 安全性 | L75-L88 | 保护 IoT Edge:证书和 X.509 预配、dTPM/EFLOW 安全性、机密计算模块、EST 服务设置、下游身份验证,以及 Private Link/终结点流量保护。 |
| 配置 | L89-L120 | 配置 IoT Edge 设备和 EFLOW:网络、网关、代理、存储、GPU、预配(DPS、密钥、X.509)、模块选项、指标,以及主机/VM 集成。 |
| 集成与编码模式 | L121-L130 | 使用 IoT Edge 指标、日志和直接方法,将自定义模块与 IoT Hub 集成,以及通过 PowerShell 管理 EFLOW 上的 IoT Edge,以进行监视和远程操作。 |
| 部署 | L131-L143 | 大规模部署和更新 IoT Edge:CI/CD 管道、门户/CLI 部署、Kubernetes/VM 安装、运行时更新,以及设备和设备组支持的平台。 |
故障排除
| 主题 | URL |
|---|---|
| 排查 Azure IoT Edge 监控和指标问题 | https://learn.microsoft.com/en-us/azure/iot-edge/how-to-troubleshoot-monitoring-and-faq |
| 诊断和排查 Azure IoT Edge 设备问题 | https://learn.microsoft.com/en-us/azure/iot-edge/troubleshoot |
| 解决常见的 Azure IoT Edge 错误和问题 | https://learn.microsoft.com/en-us/azure/iot-edge/troubleshoot-common-errors |
| 通过 Azure 门户排查 IoT Edge 设备问题 | https://learn.microsoft.com/en-us/azure/iot-edge/troubleshoot-in-portal |
| 排查 Windows 设备上的 Azure IoT Edge for Linux 问题 | https://learn.microsoft.com/en-us/azure/iot-edge/troubleshoot-iot-edge-for-linux-on-windows |
| 解决 Windows 版 Azure IoT Edge for Linux 的常见问题 | https://learn.microsoft.com/en-us/azure/iot-edge/troubleshoot-iot-edge-for-linux-on-windows-common-errors |
| 排查 EFLOW 虚拟机的网络问题 | https://learn.microsoft.com/en-us/azure/iot-edge/troubleshoot-iot-edge-for-linux-on-windows-networking |
最佳实践
| 主题 | URL |
|---|---|
| 使用精选的 Azure Monitor 工作簿监控 IoT Edge | https://learn.microsoft.com/en-us/azure/iot-edge/how-to-explore-curated-visualizations |
| 监控 IoT Edge 模块孪生的运行状况 | https://learn.microsoft.com/en-us/azure/iot-edge/how-to-monitor-module-twins |
| 为 Azure IoT Edge 系统实现可观测性 | https://learn.microsoft.com/en-us/azure/iot-edge/how-to-observability |
| 应用 Azure IoT Edge 生产就绪最佳实践 | https://learn.microsoft.com/en-us/azure/iot-edge/production-checklist |
决策
架构与设计模式
| 主题 | URL |
|---|---|
| 为设备选择 Azure IoT Edge 网关模式 | https://learn.microsoft.com/en-us/azure/iot-edge/iot-edge-as-gateway |
| 设计 Azure IoT Edge 离线运行模式 | https://learn.microsoft.com/en-us/azure/iot-edge/offline-capabilities |
| 设计和配置嵌套 Azure IoT Edge 层次结构 | https://learn.microsoft.com/en-us/azure/iot-edge/tutorial-nested-iot-edge |
限制与配额
| 主题 | URL |
|---|---|
| 查看 Azure IoT Edge 限制和约束 | https://learn.microsoft.com/en-us/azure/iot-edge/iot-edge-limits-and-restrictions |
安全
配置
集成与编码模式
| 主题 | URL |
|---|---|
| 访问和使用 Azure IoT Edge 内置指标 | https://learn.microsoft.com/en-us/azure/iot-edge/how-to-access-built-in-metrics |
| 添加来自 IoT Edge 模块的自定义指标 | https://learn.microsoft.com/en-us/azure/iot-edge/how-to-add-custom-metrics |
| 使用 IoT Edge 代理直接方法进行远程管理 | https://learn.microsoft.com/en-us/azure/iot-edge/how-to-edgeagent-direct-method |
| 通过直接方法检索和上传 Azure IoT Edge 日志 | https://learn.microsoft.com/en-us/azure/iot-edge/how-to-retrieve-iot-edge-logs |
| 开发与 IoT Hub 集成的 Azure IoT Edge 模块 | https://learn.microsoft.com/en-us/azure/iot-edge/module-development |
| 使用 EFLOW PowerShell 函数管理 IoT Edge | https://learn.microsoft.com/en-us/azure/iot-edge/reference-iot-edge-for-linux-on-windows-functions |
部署
评论
支持 Markdown