管理K8s集群的UniAgent和ICAgent插件

前提条件

• 已购买CCE（云容器引擎）集群和节点，详细请参考购买Standard/Turbo集群和创建节点。

管理接入AOM的集群

1. 登录AOM 2.0控制台。
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。
     • 对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}，详情请参见：创建主机组（自定义标识）。 使用已有主机组：选择已有的主机组。建议您选择自定义标识为k8s-log-{集群ID}的主机组，用于管理K8s集群下的服务器。	选择主机组

     • 单击K8s集群名称后面的，选择“编辑”或“删除”去修改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控制台。
2. 在左侧导航栏选择“设置 > 全局设置”，进入全局设置页面。
3. 在全局设置页面左侧导航栏中选择“采集设置 > K8s集群管理”页面。
4. 进入K8s集群管理页面，在集群列表单击“CCE集群”页签。
5. 在集群列表选择目标集群，并单击以下操作按钮，执行对应的操作：

   表2 UniAgent操作说明

   操作按钮	操作说明
   安装UniAgent	单击“安装UniAgent”，选择待安装的UniAgent版本。 单击“确定”，即可对该集群的主机列表中所有主机同时安装指定版本的UniAgent，以及最新版本的ICAgent插件。 在安装UniAgent时，系统将在主机/opt/cloud/lts目录下的custom_tag文件中以覆盖方式添加自定义标识k8s-log-{集群ID}，用于自动将集群下的主机归属到相同标识符的主机组。
   升级UniAgent	单击“升级UniAgent”，选择待升级的UniAgent版本。（如果当前安装的UniAgent版本是高于1.1.9的版本，则不支持回退到包括1.1.9及以前的旧版本。） 单击“确定”，即可对该集群的主机列表中所有主机同时升级指定版本的UniAgent。 在升级UniAgent时，系统将在主机/opt/cloud/lts目录下的custom_tag文件中以覆盖方式添加自定义标识k8s-log-{集群ID}，用于自动将集群下的主机归属到相同标识符的主机组。
   卸载UniAgent	单击“卸载UniAgent”，并单击“确定”，即可对该集群的主机列表中所有主机卸载UniAgent。如果主机安装了ICAgent插件，也会同时卸载ICAgent插件。 通过K8s集群管理页面安装过的UniAgent才支持在此处进行卸载。

管理CCE集群的ICAgent插件

您可以对已接入AOM的CCE集群中的主机执行ICAgent插件的安装、升级和卸载操作。

1. 登录AOM 2.0控制台。
2. 在左侧导航栏选择“设置 > 全局设置”，进入全局设置页面。
3. 在全局设置页面左侧导航栏中选择“采集设置 > K8s集群管理”页面。
4. 进入K8s集群管理页面，在集群列表单击“CCE集群”页签。
5. 在集群列表选择待执行ICAgent插件相关操作的集群，并单击“插件操作”。

   通过K8s集群管理页面安装过UniAgent，才支持插件操作，如果您的UniAgent不是通过K8s集群管理页面安装，请先单击“安装UniAgent”按钮，为CCE集群的主机安装UniAgent后，再在此处执行插件操作。

6. 在“插件操作”弹出框中选择以下操作类型，执行对应的操作。

   表3 插件操作说明

   操作类型	操作说明
   安装	选择操作类型为“安装”，选择插件为“ICAgent”。（当前仅支持安装ICAgent插件） 单击“确认”，即可对集群的主机列表中满足条件的所有主机安装最新版本的ICAgent插件。 在安装ICAgent插件时，系统将在主机/opt/cloud/lts目录下的custom_tag文件中以覆盖方式添加自定义标识k8s-log-{集群ID}，用于自动将集群下的主机归属到相同标识符的主机组。
   升级	选择操作类型为“升级”，选择插件为“ICAgent”。（当前仅支持升级ICAgent插件） 并单击“确认”，即可对集群的主机列表中满足条件的主机升级最新版本的ICAgent插件。 在升级ICAgent插件时，系统将在主机/opt/cloud/lts目录下的custom_tag文件中以覆盖方式添加自定义标识k8s-log-{集群ID}，用于自动将集群下的主机归属到相同标识符的主机组。
   卸载	选择操作类型为“卸载”，选择插件为“ICAgent”。（当前仅支持卸载ICAgent插件） 单击“确认”，即可对集群的主机列表中满足条件的主机卸载已安装的ICAgent插件。

管理自建K8s集群的UniAgent和ICAgent

您可以对自建K8s集群中的某个主机节点执行UniAgent和ICAgent插件的安装、升级和卸载操作命令，即可对该集群下的所有主机安装、升级和卸载UniAgent和ICAgent插件。

前提条件：

• 请确保已在自建K8s集群中待执行操作命令的主机执行了安装Helm v3的命令。
• 请确保Kubernetes集群已配置kubectl。

1. 登录AOM 2.0控制台。
2. 在左侧导航栏中选择“设置 > 全局设置”。
3. 在全局设置页面左侧导航栏中选择“采集设置 > K8s集群管理”页面。
4. 进入K8s集群管理页面，在集群列表单击“自建K8s集群”页签。
5. 选择目标集群，并单击以下操作按钮，执行对应的操作：

   表4 操作说明

   操作按钮	操作说明
   安装UniAgent	单击“安装UniAgent”。 在“安装UniAgent”页面配置如下信息： 服务器所在Region：当前只支持“本Region内”。 K8s集群：选择目标K8s集群。 UniAgent版本：选择待安装的UniAgent版本。 同时安装ICAgent插件（推荐）：可根据实际需求勾选在安装UniAgent时同时安装ICAgent插件。 单击“复制命令”，复制安装命令。 如果勾选了“同时安装ICAgent插件”，可先在认证管理页面获取AccessCode的ID和值，然后通过手工替换安装命令中的AccessCode的ID和值，也可以单击右侧的“复制命令”登录集群主机执行命令，根据提示输入AccessCode的ID和值。 使用远程登录工具登录K8s集群下的主机，并以root权限执行复制的安装命令，即可对该集群下的所有主机执行相同的安装操作。 在安装UniAgent时，系统将在主机/opt/cloud/lts目录下的custom_tag文件中以覆盖方式添加自定义标识k8s-log-{集群ID}，用于自动将集群下的主机归属到相同标识符的主机组。
   升级UniAgent	单击“升级UniAgent”。 在“升级UniAgent”页面配置如下信息： 服务器所在Region：当前只支持“本Region内”。 K8s集群：选择目标K8s集群。 UniAgent版本：选择待升级的UniAgent版本。 同时升级ICAgent插件：可根据实际需求勾选在升级UniAgent时同时升级ICAgent插件。 单击“复制命令”，复制升级命令。 使用远程登录工具登录K8s集群下的主机，并以root权限执行复制的升级命令，即可对该集群下的所有主机执行相同的升级操作。 在升级UniAgent时，系统将在主机/opt/cloud/lts目录下的custom_tag文件中以覆盖方式添加自定义标识k8s-log-{集群ID}，用于自动将集群下的主机归属到相同标识符的主机组。
   卸载UniAgent	单击“卸载UniAgent”。 在“卸载UniAgent”页面配置如下信息： 服务器所在Region：当前只支持“本Region内”。 K8s集群：选择目标K8s集群。 UniAgent版本：选择待卸载的UniAgent版本。 同时卸载ICAgent插件：可根据实际需求勾选在卸载UniAgent时同时卸载ICAgent插件。 单击“复制命令”，复制卸载命令。 使用远程登录工具登录K8s集群下的主机，并以root权限执行复制的卸载命令，即可对该集群下的所有主机执行相同的卸载操作。