Antrea Agent Docker镜像（arm64架构）技术文档

一、镜像概述和主要用途

本Docker镜像专为Antrea Agent设计，且仅支持arm64架构。Antrea Agent是Kubernetes网络插件Antrea的核心组件，负责在集群节点上执行网络策略、处理数据包转发及节点网络管理等任务。

重要提示：官方推荐优先使用多平台镜像 antrea/antrea-agent-ubuntu（支持包括arm64在内的多种架构），本镜像仅作为arm64架构环境下的特定选择。

二、核心功能和特性

2.1 核心功能

• 网络策略执行：在节点级别实施Kubernetes NetworkPolicy规则，确保Pod间通信安全。
• 数据包处理：负责节点内及跨节点Pod的数据包转发、封装与解封装（基于OVS/DPU技术）。
• 节点网络管理：维护节点网络接口、路由表及OVS网桥配置，保障集群网络连通性。
• 状态上报：向Antrea Controller上报节点网络状态、策略执行情况等关键信息。

2.2 特性

• arm64架构优化：针对arm64处理器架构编译，确保在ARM服务器/边缘设备上的兼容性和性能。
• 轻量化设计：基于精简基础镜像构建，减少资源占用。
• 与Antrea生态兼容：遵循Antrea组件版本规范，可与Antrea Controller及其他组件协同工作。

三、使用场景和适用范围

3.1 适用场景

• 基于arm64架构的Kubernetes集群部署Antrea网络插件时，作为节点Agent组件运行。
• 边缘计算或ARM服务器环境中，需通过Antrea实现Kubernetes网络策略和Pod网络管理的场景。

3.2 限制说明

• 架构限制：仅支持arm64架构，不兼容x86_64等其他架构。
• 官方推荐：优先使用多平台镜像 antrea/antrea-agent-ubuntu（支持多架构自动匹配），本镜像仅在无多平台镜像可用时作为替代方案。

四、使用方法和配置说明

4.1 镜像获取

通过Docker Hub拉取镜像：

docker pull antrea/antrea-agent:latest  # 需确保标签对应arm64架构版本，具体版本号参考官方仓库

4.2 容器运行示例（docker run）

Antrea Agent通常通过Kubernetes DaemonSet部署，直接使用docker run需手动配置节点环境。以下为基础运行示例（仅供参考，生产环境建议通过Antrea官方YAML部署）：

docker run -d \
  --name antrea-agent \
  --net=host \
  --privileged \
  --restart=always \
  -v /var/run/antrea:/var/run/antrea \
  -v /var/lib/antrea:/var/lib/antrea \
  -v /etc/cni/net.d:/etc/cni/net.d \
  -v /lib/modules:/lib/modules \
  -e NODE_NAME=node-1 \  # 节点名称，需替换为实际节点名
  -e ANTREA_CONFIG=/var/lib/antrea/config/antrea-agent.conf \  # 配置文件路径
  antrea/antrea-agent:latest

参数说明：

• --net=host：使用主机网络模式，确保Agent能直接管理节点网络。
• --privileged：赋予特权模式，需操作主机网络设备及内核模块。
• 挂载目录说明：
  • /var/run/antrea：Antrea Agent运行时 socket 及状态文件。
  • /var/lib/antrea：持久化存储（配置文件、日志等）。
  • /etc/cni/net.d：CNI配置目录，用于注入Antrea CNI插件配置。
  • /lib/modules：挂载主机内核模块，支持OVS功能。

4.3 配置参数与环境变量

Antrea Agent的配置主要通过配置文件（通常为antrea-agent.conf）或环境变量实现，核心配置项如下：

4.3.1 关键环境变量

4.3.2 配置文件

配置文件通常包含网络策略模式、OVS网桥配置、Controller通信地址等参数，示例片段：

[agent]
node-name = "node-1.example.com"
ovs-bridge-name = "br-int"
tunnel-type = "geneve"

[controller]
service-ip = "10.96.0.10"
service-port = 443

4.4 注意事项

1. 架构兼容性：仅在arm64架构节点上运行，x86_64环境将无法启动。
2. 依赖环境：需提前安装内核模块（如openvswitch、vxlan），并确保节点已加入Kubernetes集群。
3. 官方推荐：优先使用多平台镜像 antrea/antrea-agent-ubuntu，其支持自动架构匹配，减少环境适配成本。
4. 版本匹配：镜像版本需与集群中Antrea Controller版本保持一致，避免兼容性问题。

五、参考链接

• 多平台镜像：antrea/antrea-agent-ubuntu
• Antrea官方文档：Antrea GitHub