应用旁边的 Sidecar 需要通过注入规则的执行来完成安装。Sidecar 注入规则可定义 Sidecar 的注入范围和 Sidecar 参数(即哪些应用注入什么样的 Sidecar ),从而在不同场景下实现不同能力的 Sidecar 覆盖。
新建 Sidecar 注入规则
登录 服务网格控制台。
在左侧导航栏单击 Sidecar 管理,然后单击 Sidecar 注入规则 页签。
单击 新建注入规则。
在 基本信息 步骤填写以下参数后,单击 下一步。
参数
说明
规则名称
填写规则名称,最多不超过 128 个字符。
所属集群
选择注入规则生效的集群。
您也可以选中 全局生效,让该规则在所有集群生效。
在 注入范围 步骤配置 优先级和匹配条件后,单击 下一步。
优先级:配置注入规则的优先级。数字越大,优先级越高。
匹配条件:匹配条件根据选择的集群不同,配置信息也不同。支持多个规则的逻辑运算,当前只支持 与 运算,即当您配置多个条件时,所有条件同时匹配才能生效。
虚拟机集群
配置范围
字段名
逻辑
字段值
env 范围
输入字段名
支持等于、不等于、属于、不属于、正则五种逻辑。
配置字段名对应的字段值。
系统范围
应用名称
配置应用名称。例如:crpc-client。
nodeip
配置节点的 IP 地址。例如:192.168.1.112。
容器
配置范围
字段名
逻辑
字段值
env 范围
输入字段名
支持等于、不等于、属于、不属于、正则五种逻辑。
配置字段名对应的字段值。
系统范围
应用名称
配置应用名称。例如:crpc-client。
deployment 名称
配置 deployment 名称。例如:crpc-client-deploy。
sts 名称
配置 sts 名称。例如:crpc-client-sts。
label 范围
输入字段名
配置 label 字段值。例如:
app: dubbo-client-zxy app.kubernetes.io/instance: dubbo-client-zxy app.kubernetes.io/name: dubbo-client-zxy app.kubernetes.io/version: 1.0.0 cafe.sofastack.io/tenant: ALIPAYCN cafe.sofastack.io/workspace: middleware
annotation 范围
输入字段名
配置 annotation 字段值。例如:
prometheus.io/path: /metrics prometheus.io/port: "34903" prometheus.io/scrape: "true"
在 参数配置步骤配置以下参数后,单击 提交。
区域
参数
说明
必填设置
sidecar 版本
选择 Sidecar 的版本。
如何创建版本请参见 Sidecar 版本管理。
控制面板连接设置
acvip 地址
填写 ACVIP 服务器地址,您可以单击 自动填充,系统会将 DRM 推送的 ACVIP 地址填入。
高级配置
注册、订阅配置
设置注册和订阅配置:
注册配置
填写应用的注册参数:
注册中心:如果不需要改变应用原来的注册行为,则选中 高级配置中的 使用应用自身的注册配置;如果需要改变原有的注册行为,则需要配置一个或多个注册中心,从而实现多注册行为。
置空时,会使用内置的 SOFARegistry。
注册参数:注册时,将填写的注册参数作为 metadata 注册到注册中心。您填写的值为 Key,Value 将会从环境变量或 Pod 标签中获取。
您可以单击 添加更多注册参数,同时添加多个注册参数。
订阅配置
填写应用的订阅配置:
注册中心:如果不需要改变应用原来的订阅行为,则选中 高级配置中的 使用应用自身的订阅配置;如果需要改变原有的订阅行为,则需要填写一个或者多个注册中心,从而实现多订阅行为。
置空时,会使用内置的 SOFARegistry。
服务发现优先策略:若填写此项,则路由时会根据配置的 Key 优先进行路由的筛选。
您可以单击 添加更多优先策略,同时添加多个优先策略。
负载均衡算法
设置负载均衡算法,指定调用方找到可用的服务列表后,按照什么策略选择一个目标地址调用。支持 轮询、最小请求数 和 随机 三种算法。
轮询:按照顺序依次选择目标地址调用。
最小请求数:选择请求此处最少的目标地址调用。
随机:随机选择目标地址调用。
自定义配置
配置指定 Key 和 Value,该配置将作为环境变量添加在 Sidecar 上。
其他(可选)
默认超时时间
设置注入规则的超时时间。
Sidecar 超时时间会优先从请求中获取,如果获取不到,则采用默认值。
备注
添加规则的备注信息。
查看原始配置文件
配置完成后,单击 查看原始配置文件,可以预览 Sidecar 最后的 YAML 文件。
模板配置完成后,默认不开启,您需要单击 开启 按钮生效。
编辑注入规则
在注入规则列表单击目标注入规则右侧的 编辑。
说明如果规则处于开启状态,您需要先将生效状态改为关闭。
按照流程修改注入规则的相关参数。
您可以修改规则的注入范围和参数配置。
配置完成后,单击 提交。
删除注入规则
在注入规则列表单击目标注入规则右侧的 删除。
说明如果规则处于开启状态,您需要先将生效状态改为关闭。
单击 确定。