配置 Agent 安装

最近更新时间:2025-06-11 16:08:51

我的收藏

功能概述

北极星创建的配置文件支持推送到本地的对应路径下,创建对应的文件内容。
订阅对应服务端的文件配置后,polaris-config-agent 会自动感知服务端是否有变更,有变更后会同步更新本地文件。

操作步骤

CVM 场景

步骤1:下载 agent

步骤2:解压

解压下载的 agent.tar.gz 物料包:tar -zxvf polaris-config-agent.tar.gz 解压后生成的目录如下:
--
|-bin
|-config

步骤3:启动

到 bin 目录下执行启动脚本 sh start.sh
具体参数有2种方式注入:
1. 通过 start.sh 后添加启动参数。
-discover-addresses=${polaris_discover_addresses} -config-addresses=${polaris_config_addresses} -config-groups=${polaris_config_groups} -config-files=${polaris_config_files} -config-token=${polaris_config_token}
2. 通过配置文件,agent 启动会自动读取 config 目录下的 polaris-config-agent.yaml 配置文件,可在 config 目录下 cp polaris-config-agent.example.yaml 并在 polaris-config-agent.yaml 后在配置文件中填写具体的配置内容。
注意:
启动参数和配置文件都有内容的情况下,优先级为:启动参数 > 配置文件。

容器场景

步骤1:获取镜像地址

agent 镜像地址: ccr.ccs.tencentyun.com/tsf_100011913960/polaris-agent

步骤2:配置 sidecar 容器

将 polaris-config-agent 以 sidecar 的方式启动,agent 参数可通过配置环境变量、configmap 的方式注入,具体参数介绍如下:
参数介绍
参数
描述
支持环境变量注入
参数示例
环境变量注入示例
是否必须
discover-addresses
北极星服务发现地址
${polaris_discover_addresses}
-discover-addresses=127.0.0.1:8091,127.0.0.2:8093
-discover-addresses=${polaris_discover_addresses}
可选,如果不填,则 discover-address=config_ip:8091
config-addresses
配置中心访问地址
${polaris_config_addresses}
-config-addresses=127.0.0.1:8093,127.0.0.2:8093
-config-addresses=${polaris_config_addresses}
必须
config-token
配置中心访问token
${polaris_config_token}
-config-token=aaaa
-config-token=${polaris_config_token}
可选
config-groups
待获取的配置分组
${polaris_config_groups}
-config-groups=ns1#group1,ns2#group2
-config-groups=${polaris_config_groups}
config-groups 和 config-files 任意有一个或两个都有
config-files
待获取的配置文件
${polaris_config_files}
-config-files=ns1#group1#file1,ns2#group2#file2
-config-files=${polaris_config_files}
config-groups 和 config-files 任意有一个或两个都有