ASM通过插件市场预置了开箱即用的扩展能力,您可以按需选择使用。本文介绍如何使用插件市场来扩展网格能力。

前提条件

已创建ASM实例,且版本≥v1.12.4.0-g7d140f10-aliyun。具体操作,请参见创建ASM实例升级ASM实例

启用插件

  1. 登录ASM控制台
  2. 在左侧导航栏,选择服务网格 > 网格管理
  3. 网格管理页面,找到待配置的实例,单击实例的名称或在操作列中单击管理
  4. 在网格详情页面左侧导航栏,选择插件扩展中心 > 插件市场
  5. 插件市场页面,单击未启用的插件卡片。
  6. 插件详情页面,单击使用指引页签,了解插件的具体功能和插件配置YAML的相关说明。
  7. 插件详情页面,单击插件配置,进行相关配置,然后打开生效开关
    配置项说明
    插件生效范围ASM支持的插件生效范围如下,请选择其中一种进行配置。
    • 全局生效:无需其它配置,插件能力将在所有的工作负载中生效(包括Kubernetes集群中的ASM网关和所有的Sidecar)。
    • 工作负载生效:让插件生效于指定标签选择的工作负载,或整个命名空间中的工作负载。
    • 网关生效:让插件生效于ASM网关,当插件提供的拓展能力仅作用于网关时可以选择此生效范围进行配置。
    添加工作负载到生效范围仅当选中工作负载生效时,才能配置此参数。

    单击添加工作负载到生效范围,在添加工作负载到生效范围对话框,选择待绑定工作负载的命名空间工作负载类型(Service或Deployment),在左侧选择负载区域选中目标工作负载,添加到右侧已选择区域,然后单击确定

    插件详情页面的已生效的Sidecar区域可以查看已添加到插件生效范围中的工作负载信息。

    添加命名空间到生效范围

    仅当选中工作负载生效时,才能配置此参数。

    单击添加命名空间到生效范围,在添加命名空间到生效范围对话框,在未生效命名空间区域单击目标命名空间标签,命名空间标签将自动移动至已生效命名空间区域,然后单击确定

    插件详情页面的已生效的Sidecar区域可以查看已添加到插件生效范围中的命名空间信息。

    添加网关生效范围

    仅当选中网关生效时,才能配置此参数。

    单击添加网关生效范围,在添加网关生效范围对话框,在左侧选择网关区域单击目标网关,添加到右侧已选择区域,然后单击确定

    插件详情页面的已生效的网关区域可以查看已添加到插件生效范围中的ASM网关。

    插件配置插件配置YAML指定了启用插件扩展能力时需要指定的一些变量,请根据插件的具体使用场景进行配置。关于YAML的配置字段说明,请单击使用指引页签进行查看。
    生效开关只有打开生效开关,插件配置才可以生效。

相关操作

插件启用后,您还可以在插件详情页面的插件配置页签执行以下操作。

操作名称操作步骤
变更生效范围类型插件生效范围区域,单击目标插件生效范围,在变更生效范围类型对话框,单击确定
添加工作负载到生效范围

仅当选中工作负载生效时,才能配置此参数。

单击添加工作负载到生效范围,在添加工作负载到生效范围对话框,选择待绑定工作负载的命名空间工作负载类型(Service或Deployment),在左侧选择负载区域选中目标工作负载,添加到右侧已选择区域,然后单击确定

插件详情页面的已生效的Sidecar区域可以查看已添加到插件生效范围中的工作负载信息。

添加命名空间到生效范围

仅当选中工作负载生效时,才能配置此参数。

单击添加命名空间到生效范围,在添加命名空间到生效范围对话框,在未生效命名空间区域单击目标命名空间标签,命名空间标签将自动移动至已生效命名空间区域,然后单击确定

插件详情页面的已生效的Sidecar区域可以查看已添加到插件生效范围中的命名空间信息。

添加网关生效范围

仅当选中网关生效时,才能配置此参数。

单击添加网关生效范围,在添加网关生效范围对话框,在左侧选择网关区域单击目标网关,添加到右侧已选择区域,然后单击确定

插件详情页面的已生效的网关区域可以查看已添加到插件生效范围中的ASM网关。

编辑插件配置YAML插件配置区域单击更新,编辑YAML,然后在YAML框右上角单击保存,插件配置YAML更改将会立即生效。
解绑工作负载生效范围已生效的Sidecar区域,单击目标工作负载右侧操作列下的解绑,然后在移除生效范围对话框,单击确定
移除已生效的网关已生效的Sidecar区域,单击目标网关标签中的删除网关图标,然后在移除生效范围对话框,单击确定
停用插件在页面最下方关闭生效开关,然后在停用插件对话框,单击确定
重要 停用插件后,将影响系统稳定性或业务逻辑,可能导致非预期的结果,请谨慎操作。