您可以将 NSX 管理代理与 Antrea-NSX 适配器结合使用，以从基于 Antrea 的 TKG Service 集群访问 NSX Manager。当 主管 管理网络与工作负载网络之间存在隔离时，需要使用 NSX 管理代理。该代理将应用于部署 NSX 管理代理服务后创建的所有 TKGS 集群。

用例

NSX 管理代理旨在与 Antrea-NSX 适配器结合使用。

如果部署 主管 时管理网络和工作负载网络之间分离（通常如此），要从配置了 Antrea-NSX 适配器的 TKGS 集群访问 NSX 管理平面，必须使用 NSX 管理代理。当系统检测到此代理时，主管 会自动将代理传递到 Antrea-NSX 适配器配置。如果未安装代理，则存在管理网络隔离时，Antrea-NSX 适配器将无法启动。

部署 NSX 管理代理服务后，可以安装 Antrea-NSX 适配器。请参见为 TKG Service 集群启用 Antrea-NSX 适配器。

必备条件

NSX 管理代理作为 主管服务 安装。要安装代理服务，请遵循以下必备条件：
  • vSphere 8 U3 (8.0.3) 或更高版本
  • NSX 4.1 或更高版本
  • 主管 启用了 NSX 网络连接
  • 对 vCenter Server 具有“管理主管服务”特权
  • 熟悉主管服务

下载所需的 YAML 文件

下载所需的 YAML 文件，包括服务定义和数据值。
  1. 转到 主管服务 分发站点：https://www.vmware.com/go/supervisor-service。
  2. 滚动到 NSX 管理代理部分，然后下载以下文件：
    1. NSX 管理代理服务定义文件：nsx-management-proxy.yml
    2. NSX 管理代理服务配置文件：nsx-management-proxy-data-values.yml

将 NSX 管理代理注册为服务

完成以下步骤以将 NSX 管理代理注册为 主管服务。
  1. 使用 vSphere Client，导航到工作负载管理 > 服务。
  2. 选择添加新服务 > 添加。
  3. 单击上载。
  4. 浏览到下载的 nsx-management-proxy.yml 文件并选择该文件。
  5. 验证是否已成功上载 NSX 管理代理服务定义。
  6. 单击完成。
  7. 验证服务选项卡中是否列出了 NSX 管理代理服务的注册卡视图。

配置 NSX 管理代理服务

在安装 NSX Manager 代理服务之前，请使用适用于您环境的配置值更新其数据值文件。
  1. 使用文本编辑器，打开 nsx-management-proxy-data-values.yml 文件。
  2. 编辑属性以匹配下表中所述的环境。
  3. 保存更改。
    名称 值
    nsxManagers

    NSX Manager IP 地址列表（必需）。

    您必须使用实际 IP 地址，而不是虚拟 IP 地址 (VIP)。如果使用的是 NSX 管理集群，则必须在列表中包括所有 3 个实际 IP 地址。
    loadBalancerIP

    主管负载均衡器 IP 池中的 IP（可选）。

    此字段的 IP 地址从工作负载网络的“输入”CIDR 获得。创建工作负载网络时，无论是最初在主管启用期间，还是稍后在创建 vSphere 命名空间并覆盖网络设置时，都有一个接受 IP CIDR 块“输入”配置设置，该块用于在该主管实例上创建的所有 vSphere 命名空间中，通过服务类型负载均衡器和 Ingress 发布的服务分配 IP 地址。

    如果未指定“loadBalancerIP”字段，系统将自动分配“输入”CIDR 范围内的一个可用 IP 地址。

    如果指定了“loadBalancerIP”，则必须在“输入”CIDR 范围内，并且不得与已分配的 IP 地址冲突。

    可以使用命令“kubectl get services -o wide -A”在 vSphere 命名空间中查看分配的“输入”IP。IP 位于 kubectl 输出的“EXTERNAL-IP”列中。

安装 NSX 管理代理服务

完成以下步骤以安装 NSX 管理代理服务。
  1. 导航到工作负载管理 > > 服务屏幕。
  2. 在 NSX 管理代理服务卡视图中，选择操作 > 在主管上安装。
  3. 选择可用选项卡。
  4. 将编辑的 nsx-management-proxy-data-values.yml 中的内容复制/粘贴到“YAML 服务配置”输入字段。
  5. 单击确定，继续进行 Harbor 安装。
  6. 监控并确认安装。

    通过查看 NSX 管理代理服务卡视图上的 主管 字段，监控安装情况。您应该会在 主管 增量旁边看到数字。服务将处于“正在配置”状态，直到达到所需状态为止。达到所需状态后，服务的状态将更改为“已配置”。

  7. 验证 NSX 管理代理是否具有 vSphere 命名空间。

    安装 NSX 管理代理后，将为服务实例创建 vSphere 命名空间。

  8. 获取代理负载均衡器 IP 地址。

    您可以从 NSX 管理代理 vSphere 命名空间 的网络选项卡中查看代理负载均衡器 IP 地址。

对 NSX 管理代理服务进行故障排除

如果您收到以下错误，则表示环境不兼容。请确保环境符合必备条件部分中列出的版本。 
Creation of Supervisor Service with ID nsx-management-proxy.nsx.vmware.com is not allowed. 
Only service IDs defined in the allow-list file /etc/vmware/wcp/supervisor-services-allow-list.txt are allowed.