microsoft/azureiotedge-agent

Azure IoT Edge Agent 镜像文档

镜像概述和主要用途

本镜像为 Azure IoT Edge Agent 的官方容器镜像。Azure IoT Edge Agent 是构成 Azure IoT Edge 运行时的两个核心模块之一（另一个为 Azure IoT Edge Hub），作为边缘设备上的控制平面组件，负责管理边缘模块的全生命周期。

源代码仓库：https://github.com/Azure/iotedge/tree/main/edge-agent

核心功能和特性

• 模块生命周期管理：负责实例化部署到边缘设备的模块，并确保模块持续运行。
• 状态监控与报告：实时监控模块运行状态，并将状态信息反馈至 Azure IoT Hub。
• 远程日志收集：支持从边缘模块收集日志并远程传输。
• 指标采集与发送：生成并发送丰富的运行时指标，用于监控边缘设备健康状态。
• 配置管理：通过模块孪生（Module Twin）属性接收部署和配置数据，并应用于边缘模块。

使用场景和适用范围

Azure IoT Edge Agent 适用于所有部署了 Azure IoT Edge 运行时的边缘设备，作为控制平面核心组件，管理以下场景中的边缘模块：

• 工业物联网（IIoT）边缘设备的模块部署与监控
• 边缘计算场景下的应用模块生命周期管理
• 需远程管理边缘模块状态的场景

使用方法和配置说明

部署方式

Azure IoT Edge Agent 容器会在 IoT Edge 运行时初始化过程中自动部署（参见 快速入门教程），不应通过 docker run 命令直接启动。

配置方式

模块的部署和配置数据通过 IoT Edge Agent 模块孪生（Module Twin）的属性进行定义和更新。配置内容包括：

• 待部署模块的镜像地址、版本
• 模块启动参数
• 模块间网络连接规则
• 资源限制（CPU、内存等）

配置示例（模块孪生属性片段）：

json
{
  "properties.desired": {
    "modulesContent": {
      "$edgeAgent": {
        "properties.desired": {
          "schemaVersion": "1.1",
          "runtime": {
            "type": "docker",
            "settings": {
              "minDockerVersion": "v1.25",
              "loggingOptions": "",
              "registryCredentials": {}
            }
          },
          "systemModules": {
            "edgeAgent": {
              "type": "docker",
              "settings": {
                "image": "mcr.microsoft.com/azureiotedge-agent:1.4",
                "createOptions": ""
              }
            }
          }
        }
      }
    }
  }
}

支持与反馈

如在使用本镜像过程中遇到问题或有疑问，请通过 https://github.com/Azure/iotedge/issues 反馈。

许可条款

***声明

• 容器许可信息：Container License Information

MICROSOFT SOFTWARE LICENSE TERMS

MICROSOFT AZURE IOT EDGE RUNTIME CONTAINERS

本许可条款是您与 Microsoft Corporation（或其关联公司）之间的协议，适用于上述软件及任何 Microsoft 服务或软件更新（除非此类服务或更新附带新的或额外条款，在此情况下，该等不同条款将前瞻性适用，且不改变您或 Microsoft 关于更新前软件或服务的权利）。如果您遵守本许可条款，您将获得以下权利。使用本软件即表示您接受本条款。

1. 安装和使用权利

a) 一般规定：您可以在您的设备上安装和使用任意数量的软件副本。除非 Microsoft 通过其他协议允许，否则您不得在生产运行环境中使用本软件。
b) 第三方软件：本软件可能包含第三方应用程序，Microsoft（而非第三方）根据本协议向您授予该等应用程序的许可。任何第三方应用程序的附带通知仅供您参考。
c) Microsoft 服务协议：本软件的某些功能提供对在线服务的访问或依赖在线服务。该等服务（而非软件）的使用受《Microsoft 服务协议》（网址：[***]

2. 时效性软件

a) 期限：本协议自您接受之日起生效，在以下较早日期终止：(i) 软件商业版本首次发布后 30 天；或 (ii) Microsoft 终止本协议。Microsoft 可自行决定延长本协议期限。
b) 通知：您可能会通过软件定期收到关于此日期的提醒通知。
c) 数据访问：当软件停止运行时，您可能无法访问软件中使用的数据。

3. 预发布软件

本软件为预发布版本，可能无法正常运行，且可能与商业发布版本存在差异。

4. 反馈

如果您向 Microsoft 提供关于本软件的反馈，您即无偿授予 Microsoft 以任何方式和目的使用、分享和商业化您的反馈的权利。您不得提供受限于以下许可的反馈：因 Microsoft 在其软件或文档中包含您的反馈，而要求 Microsoft 向第三方许可其软件或文档。本权利在本协议终止后继续有效。

5. 数据收集

本软件可能收集关于您及您对软件使用情况的信息并发送给 Microsoft。Microsoft 可使用该等信息提供服务并改进 Microsoft 的产品和服务。您的选择退出权利（如有）在产品文档中说明。本软件的某些功能可能允许从访问或使用本软件的应用程序用户处收集数据。如果您使用这些功能在应用程序中启用数据收集，您必须遵守适用***（包括获取任何必要的用户同意），并维持醒目的隐私政策，准确告知用户您如何使用、收集和分享其数据。您可以在产品文档和 Microsoft 隐私声明（网址：[***] Microsoft 数据收集和使用的信息。您同意遵守 Microsoft 隐私声明的所有适用规定。

6. 许可范围

本软件为许可使用，而非出售。Microsoft 保留所有其他权利。除非适用不顾此限制赋予您更多权利，否则您不得（且无权）：
a) 规避软件中的任何技术限制（该等限制仅允许您以特定方式使用软件）；
b) 对软件进行反向工程、反编译或反汇编；
c) 移除、最小化、阻止或修改软件中任何 Microsoft 或其供应商的通知；
d) 未经 Microsoft 事先书面批准，向任何第三方披露软件的基准测试结果；
e) 将软件用于商业、非营利或创收活动；
f) 以违反的方式使用软件或创建、传播***软件；
g) 分享、发布、分发或出借软件，将软件作为独立托管解决方案供他人使用，或将软件或本协议转让给任何第三方。

7. 出口限制

您必须遵守适用于本软件的所有国内和国际出口******，包括对目的地、最终用户和最终用途的限制。有关出口限制的更多信息，请访问 [***]

8. 支持服务

Microsoft 无义务根据本协议为软件提供任何支持服务。任何提供的支持均按“现状”、“包含所有缺陷”提供，不附带任何形式的担保。

9. 更新

软件可能会定期检查更新，并为您下载和安装更新。您只能从 Microsoft 或授权来源获取更新。Microsoft 可能需要更新您的系统以向您提供更新。您同意在不另行通知的情况下接收这些自动更新。更新可能不包含或支持所有现有软件功能、服务或外围设备。

10. 完整协议

本协议及 Microsoft 可能为补充程序、更新或第三方应用程序提供的任何其他条款，构成软件的完整协议。

11. 适用***和争议解决地

如果您在美国或加拿大获取本软件，您居住的州或省（如为企业，则为主要营业地所在州或省）的管辖本协议的解释、违约索赔及所有其他索赔（包括消费者保护、不正当竞争和侵权索赔），无论冲突原则如何规定。如果您在其他国家获取本软件，则适用该国***。如果存在美国联邦管辖权，您和 Microsoft 同意就所有法院审理的争议接受华盛顿州金县联邦法院的专属管辖权和审判地。否则，您和 Microsoft 同意就所有法院审理的争议接受华盛顿州金县高等法院的专属管辖权和审判地。

12. 消费者权利；地区差异

本协议描述了某些权利。您可能拥有其他权利（包括消费者权利），具体取决于您所在的州、省或国家的。除您与 Microsoft 的关系外，您可能还对向您提供软件的一方享有权利。如果您所在州、省或国家的不允许，本协议不改变该等其他权利。例如，如果您在以下地区获取软件，或适用国家强制性，则以下规定适用于您：
a) 澳大利亚：根据《澳大利亚消费者法》，您享有法定担保，本协议无意影响该等权利。
b) 加拿大：如果您在加拿大获取本软件，可通过关闭自动更新功能、断开设备与互联网的连接（但重新连接互联网时，软件将恢复检查并安装更新）或卸载软件来停止接收更新。产品文档（如有）也可能指定如何为特定设备或软件关闭更新。
c) 德国和奥地利：
i. 担保：经适当许可的软件将基本按照随附软件的 Microsoft 材料中描述的方式运行。但是，Microsoft 不对许可软件提供合同担保。
ii. 责任限制：对于故意行为、重大过失、基于《产品责任法》的索赔以及死亡或人身伤害，Microsoft 根据成文法承担责任。
在上述第 ii 款的前提下，仅当 Microsoft 违反那些为保证本协议适当履行所必需的、违反将危及本协议目的且一方可始终信赖其履行的重要合同义务（所谓“核心义务”）时，Microsoft 才对轻微过失承担责任。在其他轻微过失情况下，Microsoft 不对轻微过失承担责任。

13. 担保免责声明

本软件按“现状”许可。您自行承担使用风险。Microsoft 不提供任何明示担保、保证或条件。在适用***允许的范围内，Microsoft 排除所有默示担保，包括对适销性、特定用途适用性和不侵权的默示担保。

14. 损害赔偿限制和排除

尽管有前述担保免责声明，如果您有任何获得损害赔偿的依据，您仅可从 Microsoft 及其供应商处获得最高 5.00 的直接损害赔偿。您不得获得任何其他损害赔偿，包括后果性损害、利润损失、特殊损害、间接损害或附带损害。
本限制适用于：(a) 与软件、服务、第三方互联网网站上的内容（包括代码）或第三方应用程序相关的任何事项；及 (b) 在适用允许的范围内，因违约、担保、保证或条件索赔，严格责任、过失或其他侵权索赔，或任何其他索赔而产生的损害赔偿。
即使 Microsoft 知道或应当知道可能发生损害，本限制仍然适用。上述限制或排除可能不适用于您，因为您所在的州、省或国家可能不允许排除或限制附带损害、后果性损害或其他损害。

请注意：由于本软件在加拿大分发，本协议中的某些条款以下提供法文版本。

Remarque: Ce logiciel étant distribué au Canada, certaines des clauses dans ce contrat sont fournies ci-dessous en français.

EXONÉRATION DE GARANTIE. Le logiciel visé par une licence est offert « tel quel ». Toute utilisation de ce logiciel est à votre seule risque et péril. Microsoft n’accorde aucune autre garantie expresse. Vous pouvez bénéficier de droits additionnels en vertu du droit local sur la protection des consommateurs, que ce contrat ne peut modifier. La ou elles sont permises par le droit locale, les garanties implicites de qualité marchande, d’adéquation à un usage particulier et d’absence de contrefaçon sont exclues.

LIMITATION DES DOMMAGES-INTÉRÊTS ET EXCLUSION DE RESPONSABILITÉ POUR LES DOMMAGES. Vous pouvez obtenir de Microsoft et de ses fournisseurs une indemnisation en cas de dommages directs uniquement à hauteur de 5,00 $ US. Vous ne pouvez prétendre à aucune indemnisation pour les autres dommages, y compris les dommages spéciaux, indirects ou accessoires et pertes de bénéfices.
Cette limitation concerne:
• tout ce qui est relié au logiciel, aux services ou au contenu (y compris le code) figurant sur des sites Internet tiers ou dans des programmes tiers; et
• les réclamations au titre de violation de contrat ou de garantie, ou au titre de responsabilité stricte, de négligence ou d’une autre faute dans la limite autorisée par la loi en vigueur.
Elle s’applique également, même si Microsoft connaissait ou devrait connaître l’éventualité d’un tel dommage. Si votre pays n’autorise pas l’exclusion ou la limitation de responsabilité pour les dommages indirects, accessoires ou de quelque nature que ce soit, il se peut que la limitation ou l’exclusion ci-dessus ne s’appliquera pas à votre égard.

EFFET JURIDIQUE. Le présent contrat décrit certains droits juridiques. Vous pourriez avoir d’autres droits prévus par les lois de votre pays. Le présent contrat ne modifie pas les droits que vous confèrent les lois de votre pays si celles-ci ne le permettent pas.