Antrea Controller Docker镜像文档（arm64架构专用）

一、镜像概述和主要用途

概述

本Docker镜像为Antrea Controller的专用镜像，仅支持arm64架构。强烈建议用户优先使用多平台镜像 antrea/antrea-controller-ubuntu（Docker Hub链接），以获得更广泛的架构兼容性和更新支持。

主要用途

作为Antrea网络策略引擎的控制平面核心组件，本镜像用于在Kubernetes集群中部署Antrea Controller，负责网络策略的编排、节点通信协调、流量转发规则管理及集群网络状态维护，是Antrea实现Kubernetes网络策略和容器网络功能的关键组件。

二、核心功能和特性

基于Antrea Controller的标准功能，本镜像提供以下核心能力（与多平台版本一致）：

• 网络策略管理：解析并执行Kubernetes NetworkPolicy资源，实现Pod间流量控制。
• 控制平面协调：与Antrea Agent（运行在每个Kubernetes节点的组件）通信，同步网络策略规则和集群网络状态。
• 流量转发编排：基于Open vSwitch（OVS）技术，动态生成和下发流量转发规则。
• 集群网络监控：收集并上报集群网络状态、策略执行情况及流量统计数据。

三、使用场景和适用范围

适用场景

仅适用于需在arm64架构Kubernetes集群中部署Antrea网络策略引擎，且无法使用多平台镜像的特定场景。

限制说明

• 架构限制：仅支持arm64架构，x86_64等其他架构需使用多平台镜像 antrea/antrea-controller-ubuntu。
• 部署方式：通常需配合Antrea Agent组件及Kubernetes集群使用，单独运行无实际功能意义。

四、使用方法和配置说明

前提条件

• 运行环境：arm64架构服务器，Docker Engine 19.03+。
• 依赖：需接入Kubernetes集群，且集群已配置API Server访问权限（用于获取集群资源和状态）。

Docker部署示例

1. 基本运行命令

docker run -d \
  --name antrea-controller \
  --network host \
  -v /etc/antrea:/etc/antrea \  # 挂载Antrea配置文件目录（需提前准备）
  -v /var/run/kubernetes:/var/run/kubernetes \  # 挂载Kubernetes API访问凭证（如kubeconfig）
  -e KUBERNETES_SERVICE_HOST=<apiserver-host> \  # Kubernetes API Server地址
  -e KUBERNETES_SERVICE_PORT=<apiserver-port> \  # Kubernetes API Server端口
  -e LOG_LEVEL=info \  # 日志级别（可选：debug, info, warn, error）
  antrea/antrea-controller:latest  # 替换为实际镜像标签

2. 注意事项

• 实际部署中，Antrea Controller通常通过Kubernetes YAML manifests部署（而非直接使用docker run），上述命令仅为基础Docker运行示例。
• 配置文件（如antrea-controller.conf）需根据集群环境自定义，具体配置项参考Antrea官方文档。

配置参数说明

环境变量（常用）

配置文件

Antrea Controller的核心配置通过挂载的配置文件（如/etc/antrea/config.yaml）定义，包含网络策略模式、流量转发配置、监控参数等。具体配置项需参考Antrea官方文档中的Controller配置说明。

五、注意事项

1. 架构兼容性：本镜像仅支持arm64架构，在非arm64环境运行会导致启动失败。
2. 版本同步：使用时需确保镜像版本与集群中Antrea Agent版本一致，避免版本不兼容问题。
3. 官方推荐：除非明确需要arm64架构专用镜像，否则始终优先使用多平台镜像 antrea/antrea-controller-ubuntu，以获得更全面的支持和更新。

如需进一步信息，参见Antrea官方文档或Docker Hub镜像页面。