一、前提条件
请参见 开始前的准备 中的步骤做好准备。
二、安装和配置命令行工具 TCCLI
注意:说明:
注意:目前计算环境仅支持命令行调用,请按照以下步骤安装命令行工具。
1. 请参见 安装 TCCLI 安装命令行工具。
2. 执行以下命令,验证 TCCLI 是否成功安装。
tccli batch help
返回结果如下,则成功安装。
NAME batchDESCRIPTION batch-2017-03-12USEAGE tccli batch <action> [–param…]OPTIONS help show the tccli batch help info –version specify a batch api versionAVAILABLE ACTION DescribeComputeEnv 用于查询计算环境的详细信息 CreateTaskTemplate 用于创建任务模板
3. 请按照 配置 TCCLI 配置命令行工具。
三、创建计算环境
你可获取并修改提供的示例,作为个人账号下可执行的 Batch 计算环境。请参见以下内容了解计算环境各项配置的含义:
你也可查阅 创建计算环境 等计算环境相关接口。
以下示例在广州六区快速创建包含10台 BS1.LARGE8(批量计算通用型 CPU 4核 内存 8GB)类型集群。
tccli batch CreateComputeEnv –version 2017-03-12 –ComputeEnv '{ "EnvName": "batch-env", // 计算环境名称 "EnvDescription": "batch env demo", // 计算环境描述 "EnvType": "MANAGED", // 计算环境类型,托管型 "EnvData": { // 具体配置(可参照 CVM 创建实例说明) "InstanceType": "BS1.LARGE8", // 计算环境内CVM 实例类型 "ImageId": "img-m4q71qnf", // 计算环境内CVM 镜像 ID(可替换成自定义镜像) "LoginSettings": { "Password": "B1[habcd" // 计算环境内CVM 登录密码 }, "InternetAccessible": { "PublicIpAssigned": "TRUE", // 计算环境内CVM 是否需要公网IP "InternetMaxBandwidthOut": 10 // 计算环境内CVM 带宽上限 }, "SystemDisk": { "DiskType": "CLOUD_BASIC", // 计算环境内CVM 磁盘类型(目前是普通云硬盘) "DiskSize": 50 // 计算环境内CVM 磁盘大小 } }, "DesiredComputeNodeCount": 10 // 计算节点期望个数}'–Placement'{ "Zone": "ap-guangzhou-6" // 可用区(当前广州六区可能需替换)}'
四、请求示例
tccli batch CreateComputeEnv –version 2017-03-12 –ComputeEnv '{"EnvName":"batch-env","EnvDescription":"batch env demo","EnvType":"MANAGED","EnvData":{"InstanceType":"BS1.LARGE8","ImageId":"img-m4q71qnf","LoginSettings":{"Password":"B1[habcd"},"InternetAccessible":{"PublicIpAssigned":"TRUE","InternetMaxBandwidthOut":50},"SystemDisk":{"DiskType":"CLOUD_BASIC","DiskSize":50}},"DesiredComputeNodeCount":1}' –Placement '{"Zone": "ap-guangzhou-6"}'
五、返回示例
返回值如下所示,其中 EnvId 为 Batch 计算环境的唯一标识。
后续将介绍如何通过 Batch 的命令行接口来查看计算环境以及计算环境内的实例信息,会使用到 EnvId,请记录返回的 EnvId。
{ "EnvId": "env-jlatqfkn", "RequestId": "297ed003-7373-4950-9721-242d3d40b3ca"}
创建的主机可以通过 云服务器控制台 来查看,也可以通过 Batch 的 计算环境接口 来查看和管理。
六、查看计算环境列表
你可以通过 Batch 的命令行接口来查看创建的所有计算环境列表。
七、请求示例
执行以下命令,查看计算环境列表。
tccli batch DescribeComputeEnvs –version 2017-03-12
八、返回示例
返回结果如下,其中包含了所要查询的计算环境信息(部分已省略)。
{ "TotalCount": 1, "ComputeEnvSet": [ { "EnvId": "env-jlatqfkn", "ComputeNodeMetrics": { … }, "EnvType": "MANAGED", "DesiredComputeNodeCount": 2, "EnvName": "test compute env", "Placement": { … }, "CreateTime": "2019-10-08T08:55:12Z" } ], "RequestId": "7a1f9338-0118-46bf-b59f-60ace9f154f5"}
九、请求示例
执行以下命令,查看指定计算环境以及包含的节点列表。
tccli batch DescribeComputeEnv –version 2017-03-12 –EnvId env-jlatqfkn
十、返回示例
返回结果如下,其中包含了计算环境整体,以及每个节点的详细信息(部分已省略)。
{ "EnvId": "env-jlatqfkn", "ComputeNodeMetrics": { … }, "EnvType": "MANAGED", "DesiredComputeNodeCount": 2, "ComputeNodeSet": [ … ], "RequestId": "407de39c-1c3d-489e-9a35-5257ae561e87", "Placement": { … }, "EnvName": "test compute env", "CreateTime": "2019-10-08T08:55:12Z"}
十一、请求示例
执行以下命令,销毁计算环境,调用后计算环境会自动销毁集群内所有的云服务器。
tccli batch DeleteComputeEnv –version 2017-03-12 –EnvId env-jlatqfkn
十二、返回示例
{ "RequestId": "029becda-2a4e-4989-aa77-6fbb5a873555"}