通过Agent调用阿里云CLI管控SelectDB实例

更新时间:
复制 MD 格式

配置阿里云CLI并安装SelectDB插件后,您只需用自然语言描述需求,即可由Agent调用阿里云CLI完成云数据库SelectDB实例的管控操作。本文以创建Serverless实例为例,为您介绍完整的操作流程。

背景信息

阿里云CLI(Alibaba Cloud CLI)是基于阿里云OpenAPI构建的命令行工具,安装SelectDB插件后,即可通过命令完成实例的查询、创建和删除等管控操作。

本文中的Agent指具备本地命令行执行能力的AI助手(例如Claude Code、Codex等),它能够根据自然语言指令在本地执行命令并读取返回结果。因此,您无需记忆具体的命令和参数,只需使用自然语言描述需求,即可由Agent调用阿里云CLI完成实例管控操作。

前提条件

  • 已安装阿里云CLI。本文以macOS环境为例,安装方法请参见安装/更新阿里云CLI。

  • 配置与管理身份凭证。由于阿里云账号(主账号)具有资源的所有权限,一旦泄露将面临重大风险,建议您使用RAM用户的AccessKey,并为该RAM用户授予AliyunSelectDBFullAccess权限。授权操作,请参见管理RAM用户的权限。

  • 已准备具备本地命令行执行能力的Agent客户端。

步骤一:配置阿里云CLI

  1. 执行以下命令,创建名为AkProfile的配置。

    aliyun configure --profile AkProfile

    在交互过程中,依次填入AccessKey ID、AccessKey Secret和地域ID等信息。返回如下信息,表示配置成功。

    Configuring profile 'AkProfile' in 'AK' authenticate mode...
    Access Key Id []: <yourAccessKeyID>
    Access Key Secret []: <yourAccessKeySecret>
    Default Region Id []: cn-hangzhou
    Default Output Format [json]: json (Only support json)
    Default Language [zh|en] en: zh
    Saving profile[AkProfile] ...Done.
    说明

    输出格式(Default Output Format)仅支持json。

  2. 执行以下命令,安装SelectDB插件。

    aliyun plugin install --name selectdb
  3. 执行以下命令,验证插件是否安装成功。

    aliyun selectdb --help

    返回SelectDB相关的命令列表,表示插件已安装成功。

步骤二:为Agent提供必要的前置信息

在使用Agent管控实例前,建议先引导Agent通过帮助命令自行学习SelectDB的命令用法。向Agent输入以下内容。

本地已安装 aliyun cli 工具,请使用 aliyun selectdb --help 来自行学习相关管控操作,后续将通过 cli 来操控 selectdb 实例
重要

如果不提供上述前置信息,而是直接要求Agent通过阿里云CLI管控实例,Agent将在缺少命令用法信息的情况下通过多次试错来补全命令,实测最坏情况下需要试错八次才能正确执行命令,耗时较长。先引导Agent通过aliyun selectdb --help自行学习命令用法,可以大幅减少试错次数,提升执行效率。

Agent执行帮助命令后,会总结出SelectDB的管控能力。常用的实例管理命令如下,均为aliyun selectdb的子命令。

命令

说明

describe-db-instances

查询指定地域下的实例列表。

describe-db-instance-attribute

查询指定实例的详细信息。

create-db-instance

创建实例。

delete-db-instance

删除实例。

说明

上表仅列出部分常用命令,完整的命令列表请以aliyun selectdb --help的实际返回为准。

步骤三:通过Agent创建Serverless实例

  1. 向Agent输入以下内容,发起创建实例的请求。

    接下来你帮我创建一个 selectdb serverless 实例,参数需要跟我确认一下
    重要

    请在输入内容中明确要求Agent与您确认参数,否则Agent可能自行设置实例参数,导致创建的实例不符合预期。

  2. 根据Agent的提示,依次确认实例参数。本文示例中确认的参数如下。

    参数

    示例取值

    说明

    地域

    cn-hangzhou

    实例所在的地域。建议选择与需要访问实例的云服务器相同的地域,否则二者无法通过专有网络互通。支持的地域,请参见服务接入点。

    付费类型

    按量付费(Postpaid)

    支持按量付费(Postpaid)和包年包月(Prepaid)。

    数据库引擎版本

    4.1

    支持4.0和4.1,建议选择4.1。

    实例规格

    selectdb.xlarge

    可选规格如下:

    • selectdb.xlarge:4核32 GB

    • selectdb.2xlarge:8核64 GB

    • selectdb.4xlarge:16核128 GB

    Serverless实例支持按需弹性伸缩,建议选择较小的规格。

    实例备注名称

    selectdb-serverless-test

    实例的备注名称,便于后续识别和管理实例。

    专有网络和交换机

    由Agent查询后指定

    如果您已有专有网络和交换机,可直接向Agent提供对应的ID;如果没有,可要求Agent查询当前地域下可用的专有网络和交换机。

  3. 参数确认完成后,Agent会调用create-db-instance命令创建实例,并返回实例ID和订单ID。返回示例如下。

    实例 ID:selectdb-bp1xg08n9****
    订单 ID:2940435177****
  4. 查询实例状态,确认实例是否创建完成。

    实例初始化通常需要几分钟。您可以要求Agent调用describe-db-instance-attribute命令查询实例状态,实例状态变为ACTIVATION表示实例已创建完成。

    您也可以登录云数据库SelectDB控制台,在实例列表页面查看实例状态。

后续步骤

实例创建完成后,您可以继续完成以下操作。以下操作同样支持通过Agent调用阿里云CLI完成。

  1. 新增集群。一个实例可包含多个集群,如需为不同业务分别设置弹性规则,可在实例中新增集群。具体操作,请参见云数据库SelectDB Serverless版使用。

  2. 设置白名单。具体操作,请参见设置白名单。

  3. 如需从公网访问实例,需申请公网地址。具体操作,请参见申请和释放公网地址。

  4. 连接实例。具体操作,请参见连接实例。