文档中心

容器服务

请输入

网络组件

apig-controller

apig-controller 组件为基于云原生 API 网关（APIG）提供全生命周期管理及七层流量路由的 Ingress 控制器组件。本文介绍如何安装和升级 apig-controller 组件以及相关的注意事项。

组件概述

apig-controller 是容器服务在云原生场景下提供的 APIG 核心组件。它深度集成云原生 API 网关（APIG）能力，负责监听集群中的 Ingress 及网关相关自定义资源，并将其动态转化为 APIG 的转发规则与配置。相比传统自建网关，该组件免去了单独运维网关节点的负担，为微服务架构提供高性能、高可靠的 API 流量管理与安全防护方案。

组件安装后，会在您的集群中运行对应的 Controller 工作负载，并注册如下 CRD 自定义资源：

资源名称	资源类型	资源说明
apig-controller	Deployment	组件的核心 Pod，负责监听集群内的 Ingress 路由配置，并自动管理云端底层的 API 网关实例
apiginstance	CRD	用来管理和监听云原生 API 网关（APIG）实例生命周期的 CRD 资源。详情请参见通过 kubectl 创建 APIG Ingress。

说明

上表中仅罗列出了该组件的主要资源，以及配置组件或对应功能时可能使用到的资源，方便您了解该组件的主要组成。其他的组件相关资源（例如 ConfigMap、Secret 等）不多做介绍，请以集群中的实际为准。

安装组件

登录容器服务控制台。

在左侧导航栏中，选择集群，单击目标集群名称，进入集群管理页面。

在左侧导航栏中，选择组件管理，并选择网络页签。

将鼠标移动到组件卡片上，单击部署，配置组件相关参数。

参数	描述
部署方式	组件的部署方式。当前该参数已固定，不可配置。
部署形态	仅已安装了 vci-virtual-kubelet 组件的集群显示该参数。部署组件的节点类型，有如下两种方式：云服务器部署：表示在集群中的云服务器节点（Node）上部署该组件。弹性容器部署：表示在集群中的弹性容器实例（VCI），即虚拟节点（VirtualNode）上部署该组件。在弹性容器实例上部署组件，会产生费用，详细的费用说明，请参见弹性容器实例产品计费。

单击确认，完成配置。

升级组件

组件会不定期发布新版本以提供新特性或修复已知问题。当组件卡片提示有可用更新时，建议您及时进行升级。为确保业务平稳过渡，升级前请尽量安排在业务低峰期执行操作。关于升级的操作步骤和注意事项，请参见升级组件。