# 管理K8s集群的UniAgent和ICAgent插件 K8s（Kubernetes）集群管理功能支持对本区域您已购买CCE（云容器引擎）集群、自建K8S集群、其他区域CCE集群、其他云厂商K8s集群下主机的UniAgent和ICAgent插件的生命周期进行管理，例如进行批量安装、升级、卸载操作。 #### 前提条件 - 已购买CCE（云容器引擎）集群和节点，详细请参考[购买Standard/Turbo集群](https://support.huaweicloud.com/usermanual-cce/cce_10_0028.html)和[创建节点](https://support.huaweicloud.com/usermanual-cce/cce_10_0363.html)。 #### 管理接入AOM的集群 1. 登录[AOM 2.0控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)。 2. 在左侧导航栏选择"设置 \> 全局设置"，进入全局设置页面。 3. 在左侧导航栏中选择"采集设置 \> K8s集群管理"。 4. 进入K8s集群管理页面，您可以执行以下操作： - 在"CCE集群"页签管理接入AOM的CCE集群。 - 查看已接入AOM的CCE集群。您可以在搜索框中输入CCE集群名称或集群ID搜索集群，支持模糊匹配查询。 - 如果您需要采集容器的日志，并输出到AOM 1.0，可开启"采集容器标准输出到AOM1.0"开关（安装了5.12.133及以上版本的ICAgent插件，才支持此功能）。建议您直接采集容器日志，输出到LTS，不推荐采集到AOM1.0，详情请参见：[云容器引擎CCE应用日志接入LTS](https://support.huaweicloud.com/usermanual-lts/lts_04_0511.html)。 - 对CCE集群的UniAgent和ICAgent执行安装、升级、卸载等操作。详情请参见：[管理CCE集群的UniAgent]和[管理CCE集群的ICAgent插件]。 - 当集群列表中处于"运行中"状态的UniAgent有新版时，"UniAgent版本"列会提示"可升级"，您可根据需要升级UniAgent的版本，详情请参考[管理CCE集群的UniAgent]。 - 当集群列表中已装的ICAgent插件有新版时，"已装插件"列会提示"可升级"，您可根据需要升级ICAgent的版本，详情请参见：[管理CCE集群的ICAgent插件]。 - 在"自建K8s集群"页签管理K8s集群。 - 查看已创建的K8s集群。您可以在搜索框中输入K8s集群名称或集群ID搜索集群，支持模糊匹配查询。 - 单击搜索框后面的"+"，在弹出框中输入配置信息去创建K8s集群。 表1创建K8s集群参数说明 | 参数 | 说明 | 示例 | |:---|:---|:---| | 集群名称 | 自定义集群名称，长度范围为1到50个字符，只支持输入英文、数字、中文、中划线、下划线、小数点，且不能以下划线、小数点开头或以小数点结尾。 | k8s-test | | 集群ID | 自定义集群ID，长度范围为1到50个字符，只支持输入小写英文字母、数字、中划线，且不能以中划线开头或结尾。 | k8s-test123 | | 关联主机组 | 关联主机组时，支持创建新的主机组，或使用已有的主机组。 - 创建新的主机组：自动创建一个名称为k8s-{集群名称}、自定义标识为k8s-log-{ClusterID}的服务器主机组。 您需要将主机加入创建的主机组，且主机的定义标识符配置为k8s-log-{ClusterID}，详情请参见：[创建主机组（自定义标识）](https://support.huaweicloud.com/usermanual-aom2/agent_02_1033.html#agent_02_1033__zh-cn_topic_0000001988246261_zh-cn_topic_0000001118763740_section6798040548)。 - 使用已有主机组：选择已有的主机组。建议您选择自定义标识为k8s-log-{集群ID}的主机组，用于管理K8s集群下的服务器。 | 选择主机组 | - 单击K8s集群名称后面的![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002517698459.png)，选择"编辑"或"删除"去修改K8s集群信息或删除K8s集群。 - 对K8s集群的UniAgent和ICAgent执行安装、升级、卸载等操作。详情请参见：[管理自建K8s集群的UniAgent和ICAgent]。 - 当集群列表中处于"运行中"状态的UniAgent有新版时，"UniAgent版本"列会提示"可升级"，您可根据需要升级UniAgent的版本。详情请参见：[管理CCE集群的UniAgent]。 - 当集群列表中已装的ICAgent插件有新版时，"已装插件"列会提示"可升级"，您可根据需要升级ICAgent的版本。详情请参见：[管理CCE集群的ICAgent插件]。 #### 管理CCE集群的UniAgent 您可以对已接入AOM的CCE集群中的主机执行UniAgent的安装、升级和卸载操作。 1. 登录[AOM 2.0控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)。 2. 在左侧导航栏选择"设置 \> 全局设置"，进入全局设置页面。 3. 在全局设置页面左侧导航栏中选择"采集设置 \> K8s集群管理"页面。 4. 进入K8s集群管理页面，在集群列表单击"CCE集群"页签。 5. 在集群列表选择目标集群，并单击以下操作按钮，执行对应的操作： 表2UniAgent操作说明 | 操作按钮 | 操作说明 | |:---|:---| | 安装UniAgent | 1. 单击"安装UniAgent"，选择待安装的UniAgent版本。 2. 单击"确定"，即可对该集群的主机列表中所有主机同时安装指定版本的UniAgent，以及最新版本的ICAgent插件。 **在安装UniAgent时，系统将在主机/opt/cloud/lts目录下的custom_tag文件中以覆盖方式添加自定义标识k8s-log-{集群ID}，用于自动将集群下的主机归属到相同标识符的主机组。** | | 升级UniAgent | 1. 单击"升级UniAgent"，选择待升级的UniAgent版本。（如果当前安装的UniAgent版本是高于1.1.9的版本，则不支持回退到包括1.1.9及以前的旧版本。） 2. 单击"确定"，即可对该集群的主机列表中所有主机同时升级指定版本的UniAgent。 **在升级UniAgent时，系统将在主机/opt/cloud/lts目录下的custom_tag文件中以覆盖方式添加自定义标识k8s-log-{集群ID}，用于自动将集群下的主机归属到相同标识符的主机组。** | | 卸载UniAgent | 1. 单击"卸载UniAgent"，并单击"确定"，即可对该集群的主机列表中所有主机卸载UniAgent。如果主机安装了ICAgent插件，也会同时卸载ICAgent插件。 **通过K8s集群管理页面安装过的UniAgent才支持在此处进行卸载。** | #### 管理CCE集群的ICAgent插件 您可以对已接入AOM的CCE集群中的主机执行ICAgent插件的安装、升级和卸载操作。 1. 登录[AOM 2.0控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)。 2. 在左侧导航栏选择"设置 \> 全局设置"，进入全局设置页面。 3. 在全局设置页面左侧导航栏中选择"采集设置 \> K8s集群管理"页面。 4. 进入K8s集群管理页面，在集群列表单击"CCE集群"页签。 5. 在集群列表选择待执行ICAgent插件相关操作的集群，并单击"插件操作"。 **通过K8s集群管理页面安装过UniAgent，才支持插件操作** **，如果您的UniAgent不是通过K8s集群管理页面安装，请先单击"安装UniAgent"按钮，为CCE集群的主机安装UniAgent后，再在此处执行插件操作。** 6. 在"插件操作"弹出框中选择以下操作类型，执行对应的操作。 表3插件操作说明 | 操作类型 | 操作说明 | |:---|:---| | 安装 | 1. 选择操作类型为"安装"，选择插件为"ICAgent"。（当前仅支持安装ICAgent插件） 2. 单击"确认"，即可对集群的主机列表中满足条件的所有主机安装最新版本的ICAgent插件。 **在安装ICAgent插件时，系统将在主机/opt/cloud/lts目录下的custom_tag文件中以覆盖方式添加自定义标识k8s-log-{集群ID}，用于自动将集群下的主机归属到相同标识符的主机组。** | | 升级 | 1. 选择操作类型为"升级"，选择插件为"ICAgent"。（当前仅支持升级ICAgent插件） 2. 并单击"确认"，即可对集群的主机列表中满足条件的主机升级最新版本的ICAgent插件。 **在升级ICAgent插件时，系统将在主机/opt/cloud/lts目录下的custom_tag文件中以覆盖方式添加自定义标识k8s-log-{集群ID}，用于自动将集群下的主机归属到相同标识符的主机组。** | | 卸载 | 1. 选择操作类型为"卸载"，选择插件为"ICAgent"。（当前仅支持卸载ICAgent插件） 2. 单击"确认"，即可对集群的主机列表中满足条件的主机卸载已安装的ICAgent插件。 | #### 管理自建K8s集群的UniAgent和ICAgent 您可以对自建K8s集群中的某个主机节点执行UniAgent和ICAgent插件的安装、升级和卸载操作命令，即可对该集群下的所有主机安装、升级和卸载UniAgent和ICAgent插件。 **前提条件：** - 请确保已在自建K8s集群中待执行操作命令的主机执行了安装Helm v3的命令。 - 请确保Kubernetes集群已配置kubectl。 1. 登录[AOM 2.0控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)。 2. 在左侧导航栏中选择"设置 \> 全局设置"。 3. 在全局设置页面左侧导航栏中选择"采集设置 \> K8s集群管理"页面。 4. 进入K8s集群管理页面，在集群列表单击"自建K8s集群"页签。 5. 选择目标集群，并单击以下操作按钮，执行对应的操作： 表4操作说明 | 操作按钮 | 操作说明 | |:---|:---| | 安装UniAgent | 1. 单击"安装UniAgent"。 2. 在"安装UniAgent"页面配置如下信息： - 服务器所在Region：当前只支持"本Region内"。 - K8s集群：选择目标K8s集群。 - UniAgent版本：选择待安装的UniAgent版本。 - 同时安装ICAgent插件（推荐）：可根据实际需求勾选在安装UniAgent时同时安装ICAgent插件。 3. 单击"复制命令"，复制安装命令。 如果勾选了"同时安装ICAgent插件"，可先在[认证管理](https://support.huaweicloud.com/usermanual-aom2/mon_01_0057.html)页面获取Access Code的ID和值，然后通过手工替换安装命令中的Access Code的ID和值，也可以单击右侧的"复制命令"登录集群主机执行命令，根据提示输入Access Code的ID和值。 4. 使用远程登录工具登录K8s集群下的主机，并以root权限执行复制的安装命令，即可对该集群下的所有主机执行相同的安装操作。 **在安装UniAgent时，系统将在主机/opt/cloud/lts目录下的custom_tag文件中以覆盖方式添加自定义标识k8s-log-{集群ID}，用于自动将集群下的主机归属到相同标识符的主机组。** | | 升级UniAgent | 1. 单击"升级UniAgent"。 2. 在"升级UniAgent"页面配置如下信息： - 服务器所在Region：当前只支持"本Region内"。 - K8s集群：选择目标K8s集群。 - UniAgent版本：选择待升级的UniAgent版本。 - 同时升级ICAgent插件：可根据实际需求勾选在升级UniAgent时同时升级ICAgent插件。 3. 单击"复制命令"，复制升级命令。 4. 使用远程登录工具登录K8s集群下的主机，并以root权限执行复制的升级命令，即可对该集群下的所有主机执行相同的升级操作。 **在升级UniAgent时，系统将在主机/opt/cloud/lts目录下的custom_tag文件中以覆盖方式添加自定义标识k8s-log-{集群ID}，用于自动将集群下的主机归属到相同标识符的主机组。** | | 卸载UniAgent | 1. 单击"卸载UniAgent"。 2. 在"卸载UniAgent"页面配置如下信息： - 服务器所在Region：当前只支持"本Region内"。 - K8s集群：选择目标K8s集群。 - 同时卸载ICAgent插件：可根据实际需求勾选在卸载UniAgent时同时卸载ICAgent插件。 3. 单击"复制命令"，复制卸载命令。 4. 使用远程登录工具登录K8s集群下的主机，并以root权限执行复制的卸载命令，即可对该集群下的所有主机执行相同的卸载操作。 |