Swarm API参考  集群API列表  添加已有实例

如何将已有ECS实例添加到ACK集群

概述： 当您需要将已有的ECS实例作为Worker节点加入到阿里云容器服务ACK（Kubernetes）集群中时，可以通过调用API来实现这一操作。此过程涉及准备ECS实例信息、执行API调用以及验证添加结果。特别注意，在添加过程中系统盘会被重置，因此务必提前备份数据。

详细步骤

步骤1：准备必要信息

• ECS实例密码：确保您拥有要添加的ECS实例的root登录密码。
• 实例ID列表：收集所有要添加到集群的ECS实例ID。
• 镜像ID（可选）：如果需要自定义ECS使用的操作系统镜像，请确认其满足官方要求，如Ubuntu或CentOS，且Linux内核版本≥3.18。
• 释放EIP配置（可选）：决定是否在集群配置完成后自动释放ECS实例的EIP资源。

步骤2：构造请求体

根据提供的信息，构造一个JSON格式的请求体，示例如下：

{
    "password": "您的ECS实例root登录密码",
    "instances": ["i-xxxxxx", "i-yyyyyy"], // 要添加的实例ID列表
    "ecs_image_id": "自定义镜像ID（如有）",
    "release_eip_flag": false // 或true，根据需求设定
}

步骤3：调用API

使用curl命令或者通过编程方式（如Python的requests库），向ACK集群发送POST请求以添加ECS实例。请替换{cluster_id}为您的实际集群ID，并将上述构造的JSON内容保存为文件（如attach.json），然后执行如下命令：

curl -X POST "https://cs.aliyuncs.com/clusters/{cluster_id}/attach" \
     -H "Content-Type: application/json" \
     --data-binary "@/path/to/attach.json" \
     -u "YourAccessKeyId:YourAccessKeySecret"

注意：请使用自己的阿里云Access Key ID和Access Key Secret替换相应部分。

步骤4：验证结果

• 成功响应会返回每个实例的处理状态及任务ID，如：

{
    "list": [
        {
            "code": "200",
            "instanceId": "i-2zee3oiwcyoz7kwdo8bt",
            "message": "successful"
        },
        ...
    ],
    "task_id": "T-5a544aff80282e39ea000039"
}

• 使用返回的task_id可以进一步查询任务执行情况，确保所有实例都成功添加至集群。

注意事项

• 数据备份：由于添加过程可能重置系统盘，务必提前对ECS实例的数据进行完整备份。
• 镜像兼容性：自定义镜像需满足特定条件，确保与ACK集群兼容。
• 权限设置：执行API调用的账号需具备相应的RAM权限，具体权限点为cs:AttachInstances。

示例

假设已经准备好所有信息并构造了请求体，通过上述命令调用API后，您将收到类似上述的成功响应，表明ECS实例已被成功添加至指定的ACK集群中。