中文 / English
QCloud插件对腾讯云原生资源(如CVM、CLB、NAT网关、安全组等)的生命周期管理接口进行业务封装,提供更贴近业务使用场景的API接口,这些接口可以分为两类:
-
基础资源接口,对原生QCloud的API参数进行简化,如腾讯云原生API创建CVM有很多参数需要输入,这些参数包括操作系统ID,机型ID、安全组ID等,用户需要查看对应的API文档才能确定这些ID值。而QCloud插件API可将这些参数的细节对用户进行屏蔽,用户只需填入操作系统版本(如centos7.2),机器对应的硬件配置(如2核4G),即可通过QCloud插件API在腾讯云上创建成功对应的CVM。
-
业务组合接口,提供基于腾讯云原生API的业务组合能力,如创建子网时默认会创建对应该子网的路由表;根据IP查询该IP对应的资源类型和所在地域;根据源IP、目标IP、目标端口和协议,自动创建对应的安全组入栈和出栈规则并绑定安全组到对应的资源等;创建数据库实例的同时,完成数据库初始化。
QCloud插件API包含的功能如下图所示,使用QCloud插件主要有两种场景:
- 通过wecube注册插件来使用插件的功能
- 独立部署使用,这种场景第三方应用使用http请求向插件发起请求。
开发环境搭建完成后,如果是linux用户,执行go build命令后,在当前目录下可以看到wecube-plugins-qcloud的二进制程序,执行如下命令启动该程序
./wecube-plugins-qcloud
程序启动后,可通过curl命令创建vpc来验证,命令如下其中your_SecretID和your_SecretKey需要替换为用户自己腾讯云的secretId和secretKey。
curl -X POST http://127.0.0.1:8081/v1/qcloud/vpc/create -H "cache-control: no-cache" -H "content-type: application/json" -d "{\"inputs\":[{\"provider_params\": \"Region=ap-shanghai;AvailableZone=ap-shanghai-1;SecretID={$your_SecretID};SecretKey={$your_SecretKey}\",\"name\": \"api_test_vpc\",\"cidr_block\": \"10.5.0.0/16\"}]}"
如果看到如下返回,表示创建vpc成功
{
"result_code": "0",
"result_message": "success",
"results": {
"outputs": [
{
"id": "vpc-k6051or0"
}
]
}
}
对于windows用户,如果使用curl命令测试,可参考windows环境安装curl命令
插件相关的日志保存在当前目录logs/wecube-plugins-qcloud.log中。
QCloud插件包编译为docker镜像后,执行如下命令运行插件,其中IMAGE_TAG需要替换为QCloud插件docker镜像的tag
docker run -d -p 8081:8081 --restart=unless-stopped -v /etc/localtime:/etc/localtime wecube-plugins-qcloud:{$IMAGE_TAG}
关于QCloud插件的API使用说明,请查看以下文档 QCloud插件API手册
QCloud插件是基于 Apache License 2.0 协议
- 如果您想得到最快的响应,请给我们提issue。
- 联系我们:fintech@webank.com