-
URI URI格式 POST /v3/{project_id}/instances/{instance_id}/extensions 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。
-
请求示例 创建数据库db1的插件pg_stat_statements。 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/f569f1358436479dbcba8603c32cc4aein03/extensions
{
"database_name" : "db1",
"extension_name" : "pg_stat_statements"
}
-
响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 extensions Array of objects 参数解释： 插件列表信息。 详情请参见表3。 total_count Integer 参数解释： 总插件数。 取值范围： 不涉及。 表3 extensions元素结构说明 名称 参数类型 说明 name String 参数解释： 插件名称。 取值范围： 不涉及。 database_name String 参数解释： 数据库名称。 取值范围： 不涉及。 version String 参数解释： 插件版本。 取值范围： 不涉及。 version_update String 参数解释： 可更新的插件版本。如果和version字段值不一致，说明插件可更新。 取值范围： 不涉及。 shared_preload_libraries String 参数解释： 依赖预加载库。 取值范围： 不涉及。 created Boolean 参数解释： 插件是否已创建。 取值范围： 不涉及。 description String 参数解释： 插件描述。 取值范围： 不涉及。 正常响应样例 {
"extensions" : [ {
"name" : "pg_cron",
"database_name" : "db1",
"version" : "1.0",
"version_update" : "1.0",
"shared_preload_libraries" : "pg_cron",
"created" : false,
"description" : "pg_cron access method - signature file based index"
}, {
"name" : "dblink",
"database_name" : "db1",
"version" : "1.2",
"version_update" : "1.2",
"shared_preload_libraries" : "",
"created" : false,
"description" : "connect to other PostgreSQL databases from within a database"
} ],
"total_count" : 2
} 异常响应 请参见异常请求结果。
-
URI URI格式 GET /v3/{project_id}/instances/{instance_id}/extensions?database_name={database_name}&offset={offset}&limit={limit} 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 database_name 是 参数解释： 数据库名称。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 offset 否 参数解释： 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。 约束限制： 不涉及。 取值范围： 必须为数字，不能为负数。 默认取值： 默认为0，偏移0条数据，表示从第一条数据开始查询。 limit 否 参数解释： 查询记录数。 约束限制： 不涉及。 取值范围： 1~100 默认取值： 100
-
URI GET https://{Endpoint}/v3/{project_id}/instances/kernel-plugins 表1 参数说明 参数 是否必选 参数类型 描述 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。
-
约束与限制 集群弹性引擎支持对集群中按需计费和包周期的Lite Cluster资源池节点进行扩容和缩容。 集群弹性引擎不支持对整柜购买的Lite Cluster资源池进行弹性伸缩。 集群弹性引擎插件使用用户全局委托的权限操作资源池，如果全局委托中涉及资源池操作相关的黑名单策略，需要先删除黑名单。 在ModelArts控制台的“权限管理”页面获取当前“授权对象”对应的“授权内容”，即当前用户所授予的委托名称。 图1 授权内容 前往
IAM 控制台的委托页面，找到上一步骤获取的委托名称，单击操作列的“修改”。 图2 IAM委托 单击“授权记录”，切换至授权记录页签。 单击ModelArts CommonOperations操作列的“删除”，在对话框中单击“确定”，删除ModelArts CommonOperations权限。 图3 删除ModelArts CommonOperations权限
-
配置节点池弹性伸缩策略 安装集群弹性引擎插件后，需要为节点池配置弹性伸缩策略。 弹性伸缩仅支持扩容按需计费节点。 每个资源池支持最多添加10个弹性弹性伸缩策略。 每个节点池支持最多添加5个弹性伸缩策略。 不能添加相同的弹性伸缩策略。 在资源池详情页，切换到“节点池管理”页签。 单击操作列的“弹性伸缩”。 在弹性伸缩弹框中配置节点池伸缩策略。 自定义扩容规则：单击“添加规则”，在弹出的添加规则窗口中设置参数。 规则类型：可选择“周期触发”。 触发时间：可选择每天、每周、每月或每年的具体时间点。 增加节点数（个数）：弹性伸缩时节点池下的节点增加数量。 节点池资源下限（个）：节点池中的总节点数缩小至配置的资源下限后将不再自动缩容。 节点池资源上限（个）：节点池中的总节点数达到配置的资源上限后将不再自动扩容。 冷却时间（分钟）：触发弹性扩容后，再次启动缩容评估的冷却时间。 设置完成后，单击“确定”。
-
响应示例 {
"addons": [
{
"status": "FAILED",
"id": "a2cdf0e2-8495-4db5-82f7-a23b97b57787",
"name": "sermantInjector",
"version": "1.3.1.0",
"cce_id": "02f9a523-cefe-11ee-afc1-0255ac100045",
"cse_id": "b4e49ad5-5142-437d-8a6b-1de66b1af0db",
"job_id": "JOB195d62a9-6446-4ac4-a42e-034a48d6a10b",
"environment_id": "7e2af5b5-4223-40b7-b89b-ee9059827248"
}
]
}
-
响应消息 表3 响应参数 参数 参数类型 描述 addons Arrays of objects 插件列表，请参考表4。 表4 addons 参数 参数类型 描述 cce_id String 插件所绑定的CCE集群ID。 cse_id String 插件所绑定的
CS E微服务引擎ID。 environment_id String 插件所在的环境ID。 id String 插件ID job_id String 插件执行的最后一个任务的ID。 name String 插件名称。 sermantInjector：Sermant Injector插件。用于自动挂载Sermant Agent，通过Sermant Agent接入未开启安全认证的ServiceComb引擎。无需修改应用代码即可接入引擎并使用应用注册发现、全链路灰度发布、优雅上下线、标签路由等功能，但是不支持使用微服务治理功能。 status String 插件状态。 INITIALIZING，初始化。 UPGRADING，升级中。 FAILED，失败。 SUCCEEDED，成功。 DELETING，删除中。 version String 插件版本。
-
请求消息 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式），默认取值为“application/json;charset=utf8”。 X-Auth-Token 是 String 调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值。Token获取方式，请参考认证鉴权。
-
获取驱动链接-公网地址 登录CCE控制台。 创建节点，在节点规格处选择要创建的GPU节点，选中后下方显示的信息中可以看到节点的GPU显卡型号。 登录到nvidia网站。 如图2所示，在“NVIDIA驱动程序下载”框内选择对应的驱动信息。其中“操作系统”必须选Linux 64-bit。 图2 参数选择 驱动信息确认完毕，单击“搜索”按钮，会跳转到驱动信息展示页面，该页面会显示驱动的版本信息如图3，单击“下载”到下载页面。 图3 驱动信息 获取驱动软件链接方式分两种： 方式一：如图4，在浏览器的链接中找到url=/tesla/470.103.01/NVIDIA-Linux-x86_64-470.103.01.run的路径，补齐全路径为https://us.download.nvidia.com/tesla/470.103.01/NVIDIA-Linux-x86_64-470.103.01.run，该方式节点需要绑定EIP 。 方式二：如图4，单击“下载”按钮下载驱动，然后上传到OBS，获取软件的链接，该方式节点不需要绑定EIP。 图4 获取链接
-
安装插件 登录UCS控制台，单击集群名称进入集群，在左侧导航栏中选择“插件中心”。 在“可安装插件”中找到gpu-device-plugin，单击“安装”。 在安装插件页面，填写插件配置。 插件规格：可配置“默认”或“自定义”规格，请根据实际情况选择。 容器：选择“自定义”规格时支持设置。 Nvidia驱动：您可使用CCE提供的驱动地址或手动填写自定义Nvidia驱动的地址，集群下全部GPU节点将使用相同的驱动。 GPU虚拟化功能仅支持470.57.02、510.47.03、535.54.03、535.216.03版本的GPU驱动。 建议您使用CCE提供的驱动地址，以满足驱动版本的要求。 如果下载链接为公网地址，例如地址为nvidia官网地址https://us.download.nvidia.com/tesla/470.103.01/NVIDIA-Linux-x86_64-470.103.01.run，则各GPU节点均需要绑定EIP。获取驱动链接方法请参考获取驱动链接-公网地址。 若下载链接为OBS上的链接，无需绑定EIP 。获取驱动链接方法请参考获取驱动链接-OBS地址。 请确保Nvidia驱动版本与GPU节点适配。 更改驱动版本后，需要重启节点才能生效。 重启节点前需要排空节点中的Pod，再进行升级重启的操作。请注意预留GPU资源以满足节点排空过程中的Pod调度需求，防止资源不足导致Pod调度失败影响业务运行。 对于linux 5.x内核系统，如华为云欧拉操作系统 2.0或ubuntu 22.04，建议使用470及以上版本驱动。 图1 安装gpu-device-plugin GPU虚拟化：选择开启GPU虚拟化，支持GPU单卡的算力、显存分割与隔离。 若集群中未安装volcano插件，将不支持开启GPU虚拟化，您可单击“一键安装”进行安装。如需配置volcano插件参数，请单击“自定义安装”，详情请参见volcano。 若集群中已安装volcano插件，但插件版本不支持使用GPU虚拟化，您可单击“一键升级”进行升级。如需配置volcano插件参数，请单击“自定义升级”，详情请参见volcano。 单击“安装”，安装gpu-device-plugin插件的任务即可提交成功。
-
约束与限制 下载的驱动必须是后缀为“.run”的文件。 仅支持Nvidia Tesla驱动，不支持GRID驱动。 安装或重装插件时，需要保证驱动下载链接正确且可正常访问，插件对链接有效性不做额外校验。 gpu-device-plugin插件仅提供驱动的下载及安装脚本执行功能，插件的状态仅代表插件本身功能正常，与驱动是否安装成功无关。 gpu型号只支持T4、V100。 本地集群只支持华为云欧拉操作系统 2.0 x86系统架构类型。 纳管gpu节点前，请确保节点依赖libsecurec已安装。
-
安装baas-restapi插件 登录
区块链 服务管理控制台。 在页面左侧选择“插件管理”。 在“插件仓库”页签下，在baas-restapi插件的卡片上，单击“安装”。 根据界面提示配置参数，具体如表2所示。 表2 配置参数 参数 说明 示例 插件 插件名称。 baas-restapi 版本 插件版本号。 3.0.45 实例 请选择区块链实例。 bcs-6zbgus 开启分布式身份接口 支持分布式身份和可验证凭证的生成、申请、签发等管理能力。 您可根据实际需求选择是否开启分布式身份接口。 - 开启可信数据交换接口 支持数据的发布、授权、分享、解密等能力。 您可根据实际需求选择是否开启可信数据交换接口。 开启分布式身份接口才会显示此参数。 - 开启数字水印接口 在发布数据集、共享数据集时可以嵌入发布者的信息，在提取明文数据时可以嵌入使用者的信息。可支持嵌入明水印和暗水印，提取暗水印。目前水印服务只支持10M以内的.xlsx格式文件。 开启分布式身份接口才会显示此参数。 数字水印功能只支持“华北-北京四”区域。 - 链码安装通道 选择链码安装通道。 开启分布式身份接口才会显示此参数。 channel 单击“提交”。 在安装插件的过程，请勿对实例进行其他操作，以免影响实例的正常运行。
-
插件实例 登录区块链服务管理控制台。 在页面左侧选择“插件管理”。 单击“插件实例”页签，可查看插件实例卡片信息。 您也可以根据实际需求，在插件实例卡片中执行以下操作： baas-restapi插件实例 单击插件实例名称，查看插件的详细信息。 在详细信息中，单击“实例数（正常/全部）”后面的“伸缩”，可伸缩实例数，实例数量范围为1~5。 在详细信息中，单击“编辑”，可打开和关闭分布式身份接口，可信数据交换接口和数字水印接口（只支持“华北-北京四”区域）保存后会重启实例，业务将有短时间的中断，请稍后刷新查看。 单击插件实例卡片上的“升级”，可升级插件。 单击插件实例卡片上的“卸载”，可卸载插件。
