添加已有节点到边缘Kubernetes托管集群,该API返回唯一的可执行脚本,用户获取脚本后,在已有节点上执行即可完成该节点的接入。

请求信息

请求行 RequestLine

POST /clusters/{cluster_id}/attachscript HTTP/1.1
表 1. 请求行参数 URI Param
名称 类型 是否必须 描述
cluster_id string 集群 ID

特有请求头 RequestHead

无,请参考公共请求头部。

请求体 RequestBody

{
  "options": "{
    /"flannelIface/": "flannel绑定网卡",
    /"enableIptables/": "是否启用iptables",
    /"manageRuntime/": "是否使用接入工具管理runtime",
    /"nodeNameStrategy/": "节点的命名机制",
    /"nodeName/": "节点名称",
    /"nodeNamePrefix/": "节点名称前缀",
    /"enabledAddons/": [
            /"kube-proxy/",
            /"flannel/",
            /"coredns/"
    ]
     }"
}
表 2. 请求体解析
名称 类型 是否必须 描述
options json 节点的接入配置。
enabledAddons array 需要安装的组件列表;默认为空,不安装;普通节点需要配置为["kube-proxy","flannel", "coredns"]
enableIptables bool 是否开启iptables,默认值true。
flannelIface String flannel使用的网卡名;默认值是eth0。
manageRuntime bool 是否由edgeadm安装并检测Runtime。
nodeName string 设置节点名。

只有在--nodename-strategy=customized时生效。

nodeNamePrefix string 节点名称前缀。

  • 如果前缀为空,则默认使用hostname
  • 如果不为空,则取值为prefix+UUID
nodeNameStrategy bool
节点生成策略。目前支持四种策略:

  • hostname:主机名
  • random:随机字符串
  • randomWithPrefix:指定前缀+随机字符串
  • customized:自定义

默认值为hostname。

返回信息

返回行 ResponseLine

HTTP/1.1 202 OK

特有返回头 ResponseHead

无,请参考公共返回头部。

返回体 ResponseB

 "wget http://aliacs-k8s-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/public/pkg/run/attach/1.12.6-aliyunedge.1/edgeadm -O edgeadm; chmod u+x edgeadm; ./edgeadm join --openapi-token=XXX --node-spec="{/"flannelIface/":/"eth0/",/"enableIptables/":true,/"assumeYes/":true,/"manageRuntime/":true,/"nodeNameStrategy/":/"hostname/",/"enabledAddons/":[/"kube-proxy/",/"flannel/",/"coredns/"]}""

示例

请求示例

POST /clusters/Cccfd68c47445466XXXX/attachscript HTTP/1.1
<公共请求头>
{
     "options": "{
      /"flannelIface/": /"eth0/",
      /"enableIptables/": true,
      /"manageRuntime/": true,
      /"nodeNameStrategy/": /"hostname/",
      /"enabledAddons/": [
            /"kube-proxy/",
            /"flannel/",
            /"coredns/"
      ]
     }"
}

返回示例

HTTP/1.1 202 Accepted
<公共响应头>
 "wget http://aliacs-k8s-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/public/pkg/run/attach/1.12.6-aliyunedge.1/edgeadm -O edgeadm; chmod u+x edgeadm; ./edgeadm join --openapi-token=XXX --node-spec="{/"flannelIface/":/"eth0/",/"enableIptables/":true,/"assumeYes/":true,/"manageRuntime/":true,/"nodeNameStrategy/":/"hostname/",/"enabledAddons/":[/"kube-proxy/",/"flannel/",/"coredns/"]}""