antrea/antrea-mc-controller

Antrea Multicluster Controller Docker镜像文档

镜像概述和主要用途

本镜像为Antrea Multicluster Controller的Docker镜像，专为amd64架构设计，用于Kubernetes（K8s）多集群环境中的网络与安全策略管理。作为Antrea多集群解决方案的核心组件，该控制器需以Deployment形式部署在集群集（ClusterSet）的每个成员集群中，负责协调跨集群网络服务与安全策略的执行。

核心功能和特性

• 多集群服务API支持：实现Kubernetes Multi-cluster Service API，支持创建跨集群可访问的多集群服务（Multi-cluster Services），允许集群集内的服务跨集群通信。

• 多集群网络策略扩展：扩展Antrea原生NetworkPolicy至多集群场景，支持针对跨集群流量的网络策略规则配置，精细化控制跨集群网络访问。

• 集群网络策略复制：支持ClusterNetworkPolicy复制功能，集群集管理员创建的ClusterNetworkPolicy可自动复制并在集群集的所有成员集群中强制执行，实现统一的跨集群安全策略管理。

• 架构特定：仅支持amd64架构，需在兼容的K8s节点上运行。

使用场景和适用范围

适用场景

• 多集群Kubernetes环境中需要跨集群服务发现与通信的场景。
• 需对跨集群流量进行统一安全策略管控的场景。
• 要求集中管理并分发网络策略至多个成员集群的场景。

适用范围

• 运行在amd64架构节点上的Kubernetes集群。
• 已部署Antrea网络插件的Kubernetes集群。
• 构成集群集（ClusterSet）的多个Kubernetes集群，且每个成员集群需部署本控制器。

使用方法和配置说明

部署前提

1. 目标Kubernetes集群已部署Antrea网络插件（参考https://github.com/antrea-io/antrea/blob/main/docs/installation.md%EF%BC%89%E3%80%82
2. 集群集（ClusterSet）已创建，且各成员集群网络互通。
3. 集群节点为amd64架构。

部署示例（Kubernetes Deployment）

以下为在K8s集群中部署Antrea Multicluster Controller的Deployment配置示例：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: antrea-multicluster-controller
  namespace: kube-system  # 建议部署在kube-system或antrea命名空间
  labels:
    app: antrea-multicluster-controller
spec:
  replicas: 1  # 单副本部署，确保集群内唯一
  selector:
    matchLabels:
      app: antrea-multicluster-controller
  template:
    metadata:
      labels:
        app: antrea-multicluster-controller
    spec:
      containers:
      - name: antrea-multicluster-controller
        image: antrea/multicluster-controller:latest  # 替换为具体版本标签
        imagePullPolicy: IfNotPresent
        args:
          - --cluster-name=<CLUSTER_NAME>  # 当前集群在集群集中的名称
          - --cluster-set=<CLUSTER_SET_NAME>  # 集群集名称
          # 其他配置参数参考官方文档，如API服务器地址、认证配置等
        resources:
          requests:
            cpu: 100m
            memory: 128Mi
          limits:
            cpu: 500m
            memory: 512Mi
        securityContext:
          privileged: false  # 根据实际需求调整安全上下文
      nodeSelector:
        kubernetes.io/arch: amd64  # 确保调度至amd64架构节点

配置说明

• 部署参数：主要通过Deployment的args字段配置控制器运行参数，关键参数包括集群名称（--cluster-name）、集群集名称（--cluster-set）等，完整参数列表请参考https://github.com/antrea-io/antrea%E3%80%82

• 资源配置：根据集群规模调整resources字段的CPU和内存请求及限制，默认建议配置为100m CPU/128Mi内存（请求）和500m CPU/512Mi内存（限制）。

• 架构兼容性：通过nodeSelector指定kubernetes.io/arch: amd64，确保控制器调度至amd64架构节点。

参考信息

更多详细信息请参考Antrea源码仓库：https://github.com/antrea-io/antrea