/alibabacloud-ehpc-instant-job-skill

name: alibabacloud-ehpc-instant-job-skill
description: 阿里云E-HPC Instant计算平台作业管理工具包，支持E-HPC Instant（EHPC Instant/ehpcinstant）作业的创建/提交、查询、获取详情、查询日志、删除等操作。当用户需要创建作业、查询作业列表、获取作业详情、删除作业、查询作业日志时使用。

阿里云E-HPC Instant作业管理技能

技能概述

通过阿里云CLI（优先）或SDK工具，实现对E-HPC Instant计算平台作业及计算资源的全生命周期管理。

交互原则

• **用户友好**：使用"您"而非"你"，保持专业而友好的语调
• **透明操作**：所有关键配置信息必须向用户展示并获得确认
• **安全第一**：遵循最小权限原则，避免意外操作
• **错误处理**：提供清晰的错误信息和解决方案
• **格式规范**：使用简单、清晰、易读的输出格式

执行流程

• Step1: 配置预加载
• Step2: 前置条件校验
• Step3: 作业管理执行
• Step4: 作业任务执行结果输出

Step 1: 配置预加载

> **[MUST]** 必须首先尝试读取 `./jobconfig/pre-config.json` 文件，严禁跳过此检查步骤。 > - **文件存在且读取成功**：加载其中的参数值，向用户提示预配置已加载并展示关键参数摘要，然后进入 Step 2。 > - **文件不存在**：向用户提示未检测到预配置文件，将在 Step 2 中通过交互方式获取必要参数，然后进入 Step 2。 > - **文件存在但读取/解析失败**（如 JSON 格式错误、权限不足等）：向用户报告具体错误信息，询问是否继续（跳过预配置进入 Step 2）或中止执行。

Step 2: 前置条件校验

所有作业管理任务通用校验

1. **阿里云CLI配置**：验证CLI已安装并配置AccessKey

• **CLI版本要求 >= 3.3.3**：运行 `aliyun version` 验证版本 >= 3.3.3。若未安装或版本过低，参考 [references/aliyun-cli.md](./references/aliyun-cli.md) 中的安装说明进行安装或更新。
• [MUST] 运行 `aliyun configure set --auto-plugin-install true` 启用自动插件安装。
• [MUST] 运行 `aliyun plugin update` 确保已安装插件始终为最新版本。
• 若无配置，引导用户交互式安装和配置
• 参考：[references/aliyun-cli.md](./references/aliyun-cli.md)
• **[MUST] CLI User-Agent** — 每个 `aliyun` CLI 命令调用必须包含：`--user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill`
• **启用阿里云CLI AI模式**：运行以下初始化命令，附加本Skill执行的AI身份信息：

> ```bash > aliyun configure ai-mode enable > aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill" > aliyun plugin update > ``` > 阿里云CLI提供了AI模式。启用后，CLI会自动附加AI身份信息，使服务端能够识别并优化Agent调用链路。 > **[MUST] 在每个退出点禁用AI模式** — 在因任何原因交付最终响应之前，务必先禁用AI模式。这适用于所有退出路径：工作流成功、工作流失败、错误/异常、用户取消、会话结束，或任何不再执行CLI命令的场景。 > AI模式仅用于Agent Skill调用场景，技能停止运行后**必须**保持禁用状态。 > ```bash > aliyun configure ai-mode disable > ``` 2. **地域信息**：获取用户指定区域或使用默认区域`cn-shanghai` 3. **权限验证**：确保AccessKey具备E-HPC Instant相关权限

创建作业任务专项校验

1. **镜像准备**：容器/VM镜像已添加至E-HPC Instant平台

• 若无镜像，引导用户交互式添加
• 参考：[references/instant-image.md](./references/instant-image.md)

2. **网络配置**：vSwitch已创建并可用

• 若无vSwitch，引导用户交互式创建
• 参考：[references/vswitch.md](./references/vswitch.md)

3. **存储配置**：NAS挂载路径已准备（如需要）

• 若需NAS，引导用户交互式配置
• 参考：[references/storage.md](./references/storage.md)

4. **计算资源配置**：Cores/Memory或InstanceType规格已指定

• 引导用户选择合适的资源配置
• 参考：[references/resource.md](./references/resource.md)

5. **执行命令**：作业执行命令行已指定

• 确保命令格式正确（特别是JSON数组格式）
• 参考：[references/job-command.md](./references/job-command.md)

Step 3: 作业管理执行

根据用户需求执行相应的作业管理操作

创建作业

1. Container容器作业

aliyun ehpcinstant CreateJob \
    --region cn-shanghai \
    --JobName 'container-job' \
    --Tasks '[{
        "TaskSpec": {
            "TaskExecutor": [{
                "Container": {
                    "Image": "registry.cn-shanghai.aliyuncs.com/registry/image:tag",
                    "Command": "[\"/bin/sh\", \"-c\", \"python /app/main.py\"]"
                }
            }],
            "Resource": {
                "Cores": 2,
                "Memory": 4,
                "Disks": [{"Type":"System","Size":40}]
            },
	    "VolumeMount": [
              {
                "MountPath": "/mnt",
                "VolumeDriver": "alicloud/nas",
                "MountOptions": "{\"server\":\"xxx.cn-shanghai.nas.aliyuncs.com\",\"vers\":\"3\",\"path\":\"/\",\"options\":\"nolock,tcp,noresvport\"}"
              }
            ],
        },
        "ExecutorPolicy": {"MaxCount": 1}
    }]' \
    --DeploymentPolicy '{"Network":{"Vswitch":["vsw-xxxx"]},"AllocationSpec":"Standard"}' \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

2. VM虚拟机作业

aliyun ehpcinstant CreateJob \
    --region cn-shanghai \
    --JobName 'longrunning-job' \
    --JobDescription 'Long-running VM job' \
    --Tasks '[{
        "TaskSpec": {
            "TaskExecutor": [{
                "VM": {
                    "Image": "m-xxxx",
                    "Script": "base64_encoded_script"
                }
            }],
            "Resource": {
                "Disks": [{"Type":"System","Size":50}],
                "InstanceTypes": ["ecs.c6.xlarge"],
                "Cores": 4,
                "Memory": 8
            },
	    "VolumeMount": [
              {
                "MountPath": "/mnt",
                "VolumeDriver": "alicloud/nas",
                "MountOptions": "{\"server\":\"xxx.cn-shanghai.nas.aliyuncs.com\",\"vers\":\"3\",\"path\":\"/\",\"options\":\"nolock,tcp,noresvport\"}"
              }
            ],
        },
        "ExecutorPolicy": {"MaxCount": 1}
    }]' \
    --DeploymentPolicy '{"Network":{"Vswitch":["vsw-xxxx"]},"AllocationSpec":"Standard"}' \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

查询作业列表

# 基本列表查询
aliyun ehpcinstant ListJobs --region cn-shanghai \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

# 分页查询（推荐用于大量作业）
aliyun ehpcinstant ListJobs --region cn-shanghai --PageSize 10 --PageNumber 1 \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

# 条件过滤（按状态、时间等）
aliyun ehpcinstant ListJobs --region cn-shanghai --Filter '{"Status":"Running"}' \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

获取作业详情

aliyun ehpcinstant GetJob --region cn-shanghai --JobId 'job-xxxx' \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

查询作业日志

aliyun ehpcinstant DescribeJobResults --region cn-shanghai --JobId 'job-sh145rw47pegztzdpu7s' --TaskName Task0 --ArrayIndex 0 \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

删除作业

# 删除单个作业
aliyun ehpcinstant DeleteJobs --region cn-shanghai --JobSpec '[{"JobId":"job-xxxx"}]' \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-