Alibabacloud Ehpc Instant Job Skill

阿里云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 中的安装说明进行安装或更新。
• [MUST] 运行 aliyun configure set --auto-plugin-install true 启用自动插件安装。
• [MUST] 运行 aliyun plugin update 确保已安装插件始终为最新版本。
• 若无配置，引导用户交互式安装和配置
• 参考：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

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

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

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

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

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

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

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

• 确保命令格式正确（特别是JSON数组格式）
• 参考：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-instant-job-skill

# 批量删除（安全方式）
aliyun ehpcinstant DeleteJobs --region cn-shanghai --JobSpec '[{"JobId":"job-xxxx"},{"JobId":"job-yyyy"}]' \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

[MUST] 幂等删除原则 — 当用户请求删除作业时，即使通过 GetJob 或 ListJobs 查询确认作业已不存在，Agent 仍必须调用 DeleteJobs API 并传入对应 JobId。DeleteJobs API 具备幂等性：作业存在时执行删除，作业不存在时返回标准 NotFound 响应。严禁 Agent 以"作业已不存在"为由自行跳过 API 调用 — 必须让服务端确认最终状态。

Step 4: 结果输出与后续建议

• 格式化输出执行结果
• 提供后续操作建议（如监控、日志查看等）
• 记录关键信息供后续参考

作业管理参考执行脚本

路径：/home/admin/.openclaw/workspace/skills/ehpcinstant-job-skill/scripts/

CLI脚本：

• create_container_job.sh - 创建容器作业
• create_vm_job_batch.sh - 创建VM作业
• create_vm_job_longrunning.sh - 创建长期运行的VM作业
• list_jobs.sh - 列出作业（支持分页）
• get_job.sh - 获取作业详情
• delete_jobs.sh - 删除作业

SDK脚本：

• 对应的Python SDK版本脚本，位于scripts/sdk/目录
• create_container_job.py - 创建容器作业
• create_vm_job_batch.py - 创建VM作业
• create_vm_job_longrunning.py - 创建长期运行的VM作业
• list_jobs.py - 列出作业（支持分页）
• get_job.py - 获取作业详情
• delete_jobs.py - 删除作业

注意事项

1. CLI命令准确性：E-HPC Instant使用aliyun ehpcinstant命令，不是aliyun ehpc！ 2. 区域一致性：所有资源必须在同一区域，跨区域操作会失败 3. 配额限制：注意账户配额限制，避免操作失败 4. 成本意识：作业运行会产生费用，及时清理不需要的资源 5. 权限最小化：为AccessKey配置最小必要权限，提高安全性

故障排查与最佳实践

常见问题解决方案

最佳实践指南

1. 命名规范：

• 作业名称：应用-算例-时间戳（如：prod-training-20260411）
• 资源名称：包含用途、环境、区域信息

2. 资源配置优化：

• 根据应用特性选择合适的实例规格
• 避免过度配置造成资源浪费

3. 成本控制：

• 及时清理已完成的作业
• 使用适当的作业超时设置
• 监控资源使用情况

4. 可靠性保障：

• 实现作业状态监控和重试机制
• 配置适当的错误处理和告警
• 定期备份重要配置和数据

5. 安全性增强：

• 使用私有镜像仓库
• 配置最小权限的AccessKey
• 启用网络访问控制和加密

参考资料与扩展

完整API参考

如仍有作业管理执行参数不确定，可参考如下链接:

• references/ehpcinstant.md - E-HPC Instant完整CLI命令手册
• CLI帮助命令：aliyun ehpcinstant <ApiName> --help

专项配置指南

• references/aliyun-cli.md - 阿里云CLI配置指南
• references/instant-image.md - 镜像管理指南
• references/vswitch.md - 网络vSwitch管理指南
• references/storage.md - NAS存储管理指南
• references/resource.md - 计算资源配置指南
• references/job-command.md - 作业命令配置指南

官方文档

• 阿里云E-HPC Instant产品文档：https://help.aliyun.com/product/ehpcinstant.html
• E-HPC Instant API文档：https://api.aliyun.com/document/EhpcInstant/2023-07-01/overview
• 阿里云CLI官方文档：https://help.aliyun.com/document_detail/121529.html

安全策略与风险控制

操作风险等级分类

[MUST] 禁止跳过 API 调用 — Agent 在执行删除等操作时，不得基于查询结果（如 GetJob 返回 NotFound）自行判定"无需操作"而跳过实际的 API 调用。查询与变更之间存在时间窗口，服务端状态可能已变化。Agent 必须始终执行用户请求的目标 API（如 DeleteJobs），由服务端返回权威的最终结果。

安全检查清单

• ✅ 区域一致性：确保所有资源在同一区域
• ✅ 配额检查：验证资源配额是否充足
• ✅ 依赖验证：确认依赖资源（镜像、网络、存储）存在且可用
• ✅ 权限验证：确保AccessKey具备必要权限
• ✅ 成本提醒：对于可能产生较高费用的操作给予提醒

敏感操作确认流程

1. 信息汇总：展示所有关键配置参数 2. 影响说明：说明操作的影响范围和潜在风险 3. 用户确认：等待用户明确确认（"是"、"确认"、"继续"等） 4. 执行操作：执行确认后的操作 5. 结果反馈：提供详细的操作结果和后续建议

阿里云CLI配置指南

版本要求

阿里云 CLI >= 3.3.3。运行 aliyun version 查看当前版本。

安装阿里云CLI

Linux/macOS（推荐：分步安装）

# 1. 下载安装包
curl -fsSL -o /tmp/aliyun-cli.tgz https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-amd64.tgz

# 2. 校验文件完整性（确保下载未被篡改）
#    获取官方 SHA256 校验和
curl -fsSL -o /tmp/aliyun-cli.tgz.sha256 https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-amd64.tgz.sha256
#    执行校验
cd /tmp && shasum -a 256 -c aliyun-cli.tgz.sha256

# 3. 解压并安装
tar xzf /tmp/aliyun-cli.tgz -C /tmp
sudo mv /tmp/aliyun /usr/local/bin/

# 4. 验证安装
aliyun version

macOS (Homebrew)

brew install aliyun-cli
aliyun version

Windows (PowerShell)

Invoke-WebRequest -Uri "https://aliyuncli.alicdn.com/aliyun-cli-windows-latest-amd64.zip" -OutFile "$env:TEMP\aliyun-cli.zip"
Expand-Archive -Path "$env:TEMP\aliyun-cli.zip" -DestinationPath "$env:TEMP\aliyun-cli" -Force
Move-Item "$env:TEMP\aliyun-cli\aliyun.exe" "$env:LOCALAPPDATA\Microsoft\WindowsApps\" -Force
aliyun version

配置AccessKey

aliyun configure
# 按提示输入：
# Access Key ID: [您的AccessKey ID]
# Access Key Secret: [您的AccessKey Secret]
# Default Region Id: cn-shanghai
# Default Output Format: json

配置 AI-Mode

阿里云 CLI 提供了 AI 模式。启用后，CLI 会自动附加Skill身份信息，使服务端能够识别并优化技能调用链路。

# Enable AI-Mode
aliyun configure ai-mode enable

# Set AI-Mode user-agent identifier
aliyun configure ai-mode set-user-agent --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

# View AI-Mode configuration
aliyun configure ai-mode show

# Aliyun CLI Plugin Update
aliyun plugin update

# Disable AI-Mode
aliyun configure ai-mode disable

验证配置

aliyun configure list
aliyun ehpcinstant ListJobs --region cn-shanghai \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

常见问题

• 认证失败：检查 ~/.aliyun/config.json 文件中的 AccessKey 配置
• 区域错误：确保使用正确的区域（如 cn-shanghai）
• 权限不足：确保 AccessKey 具有 E-HPC Instant 相关权限

SDK 凭证配置说明

本目录下的 Python SDK 脚本使用 默认凭证链（AcsClient(region_id='cn-shanghai')），SDK 会按以下优先级自动查找凭证：

凭证解析顺序

1. 环境变量 — 设置以下环境变量即可：

   export ALIBABA_CLOUD_ACCESS_KEY_ID=<your-access-key-id>
   export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<your-access-key-secret>

如需使用 STS 临时凭证，额外设置：

   export ALIBABA_CLOUD_SECURITY_TOKEN=<your-security-token>

2. 配置文件 — 通过 aliyun configure 命令生成的 ~/.aliyun/config.json：

   aliyun configure
   # 按提示输入 Access Key ID、Access Key Secret、默认区域（cn-shanghai）

配置完成后 SDK 会自动读取该文件中的凭证信息。

3. ECS RAM 角色 — 在 ECS 实例上运行时，SDK 自动通过实例元数据获取关联 RAM 角色的临时凭证，无需任何配置。

推荐方式

注意事项

• 所有脚本默认使用 cn-shanghai 区域，如需修改请调整 AcsClient(region_id='...') 参数
• 禁止在代码中硬编码 AccessKey，应始终使用上述凭证链机制
• 确保 AccessKey 对应的 RAM 用户/角色具备 E-HPC Instant 相关权限（参考 references/ram-policies.md）

阿里云E-HPC Instant CLI完整命令参考手册

概述

阿里云E-HPC Instant（弹性高性能计算即时版）提供按需、弹性的高性能计算服务。本手册详细介绍使用阿里云 CLI 进行 E-HPC Instant 计算平台的完整命令参考。

前置条件

1. 安装阿里云CLI：确保已安装并配置阿里云 CLI 2. 权限配置：AccessKey 需要具备 E-HPC Instant 相关权限 3. 区域选择：确认操作的区域（如 cn-shanghai） 4. User-Agent标识：所有命令均应附加 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill 参数，用于服务端识别调用来源。如已通过 aliyun configure ai-mode set-user-agent 配置，则会自动附加，无需手动添加。

1. 作业管理（Job Management）

创建作业（CreateJob）

容器作业（Container Job）

# 基本容器作业
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}]
            }
        },
        "ExecutorPolicy": {"MaxCount": 1}
    }]'

# 容器作业带网络及存储NAS配置
aliyun ehpcinstant CreateJob \
    --region cn-shanghai \
    --JobName "container-job-with-network" \
    --DeploymentPolicy '{"Network":{"Vswitch":["vsw-xxxxxx"]},"AllocationSpec":"Standard"}' \
    --Tasks '[{
        "TaskSpec": {
            "TaskExecutor": [{
                "Container": {
                    "Image": "registry.cn-shanghai.aliyuncs.com/registry/image:tag",
                    "Command": "[\"/bin/sh\", \"-c\", \"echo hello\"]",
                }
            }],
            "Resource": {
                "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}
    }]'

虚拟机作业（VM Job）

# 基本VM作业
aliyun ehpcinstant CreateJob \
    --region cn-shanghai \
    --JobName "vm-job" \
    --JobDescription "Long-running VM job" \
    --Tasks '[{
        "TaskSpec": {
            "TaskExecutor": [{
                "VM": {
                    "Image": "m-xxxxxx",
                    "Script": "IyEvYmluL2Jhc2gKZWNobyAiSGVsbG8gZnJvbSBWTSBqb2IhIgo="
                }
            }],
            "Resource": {
                "Disks": [{"Type":"System","Size":50}],
                "InstanceTypes": ["ecs.c6.xlarge"],
                "Cores": 4,
                "Memory": 8
            }
        },
        "ExecutorPolicy": {"MaxCount": 1}
    }]' \
    --DeploymentPolicy '{"Network":{"Vswitch":["vsw-xxxxxx"]},"AllocationSpec":"Standard"}'

参数说明

• JobName: 作业名称（2-64字符，支持字母、数字、中文、连字符、下划线）
• Tasks: 任务列表（目前只支持一个任务）
• DeploymentPolicy: 资源部署策略（网络配置、分配规格）
• JobDescription: 作业描述（可选）
• JobScheduler: 作业调度器类型（HPC/K8S，默认HPC）

查询作业列表（ListJobs）

# 基本查询
aliyun ehpcinstant ListJobs --region cn-shanghai

# 分页查询
aliyun ehpcinstant ListJobs \
    --PageSize 10 \
    --PageNumber 1 \
    --region cn-shanghai

# 条件过滤
aliyun ehpcinstant ListJobs \
    --Filter '{"Status":"Running"}' \
    --region cn-shanghai

# 排序查询
aliyun ehpcinstant ListJobs \
    --SortBy "CreateTime DESC" \
    --region cn-shanghai

获取作业详情（GetJob）

# 查询特定作业详情
aliyun ehpcinstant GetJob \
    --JobId "job-xxxxxx" \
    --region cn-shanghai

删除作业（DeleteJobs）

# 删除单个作业
aliyun ehpcinstant DeleteJobs \
    --JobSpec '[{"JobId":"job-xxxxxx"}]' \
    --region cn-shanghai

# 批量删除作业
aliyun ehpcinstant DeleteJobs \
    --JobSpec '[{"JobId":"job-xxxxxx"},{"JobId":"job-yyyyyy"}]' \
    --region cn-shanghai

# 删除执行器（按执行器ID）
aliyun ehpcinstant DeleteJobs \
    --ExecutorIds '["job-xxxxxx-Task0-0"]' \
    --region cn-shanghai

查询作业日志（DescribeJobResults）

# 查询作业日志
aliyun ehpcinstant DescribeJobResults \
    --JobId "job-xxxxxx" \
    --TaskName "Task0" \
    --ArrayIndex 0 \
    --region cn-shanghai

# 限制日志大小
aliyun ehpcinstant DescribeJobResults \
    --JobId "job-xxxxxx" \
    --LimitBytes "1048576" \
    --region cn-shanghai

# 指定时间范围
aliyun ehpcinstant DescribeJobResults \
    --JobId "job-xxxxxx" \
    --StartTime "2026-04-11T10:00:00Z" \
    --region cn-shanghai

2. 镜像管理（Image Management）

添加自定义镜像（AddImage）

容器镜像

# 添加容器镜像
aliyun ehpcinstant AddImage \
    --region cn-shanghai \
    --Name "custom-container-image" \
    --Description "Custom container image for E-HPC" \
    --ImageType "Container" \
    --ContainerImageSpec '{"RegistryUrl":"registry.cn-shanghai.aliyuncs.com/registry/image:tag"}'

虚拟机镜像

# 添加VM镜像
aliyun ehpcinstant AddImage \
    --region cn-shanghai \
    --Name "custom-vm-image" \
    --Description "Custom VM image for E-HPC" \
    --ImageType "VM" \
    --VMImageSpec '{"ImageId":"m-xxxxxx"}'

查询镜像列表（ListImages）

# 查询所有镜像
aliyun ehpcinstant ListImages --region cn-shanghai

# 查询容器镜像
aliyun ehpcinstant ListImages \
    --ImageType "Container" \
    --region cn-shanghai

# 查询自定义镜像
aliyun ehpcinstant ListImages \
    --ImageCategory "Custom" \
    --region cn-shanghai

# 分页查询
aliyun ehpcinstant ListImages \
    --PageSize 20 \
    --PageNumber 1 \
    --region cn-shanghai

# 合并版本查询（最新版本）
aliyun ehpcinstant ListImages \
    --Mode "Merge" \
    --region cn-shanghai

获取镜像详情（GetImage）

# 查询镜像详情
aliyun ehpcinstant GetImage \
    --ImageId "img-xxxxxx" \
    --region cn-shanghai

删除镜像（RemoveImage）

# 删除自定义镜像
aliyun ehpcinstant RemoveImage \
    --ImageId "img-xxxxxx" \
    --region cn-shanghai

3. 资源池管理（Pool Management）

创建资源池（CreatePool）

# 创建基本资源池
aliyun ehpcinstant CreatePool \
    --region cn-shanghai \
    --PoolName "compute-pool" \
    --PoolDescription "Resource pool for compute jobs" \
    --PoolSpec '{"InstanceTypes":["ecs.c6.xlarge"],"MaxCapacity":10}'

查询资源池列表（ListPools）

# 查询资源池列表
aliyun ehpcinstant ListPools --region cn-shanghai

获取资源池详情（GetPool）

# 查询资源池详情
aliyun ehpcinstant GetPool \
    --PoolId "pool-xxxxxx" \
    --region cn-shanghai

更新资源池（UpdatePool）

# 更新资源池配置
aliyun ehpcinstant UpdatePool \
    --PoolId "pool-xxxxxx" \
    --PoolSpec '{"InstanceTypes":["ecs.c6.2xlarge"],"MaxCapacity":20}' \
    --region cn-shanghai

删除资源池（DeletePool）

# 删除资源池
aliyun ehpcinstant DeletePool \
    --PoolId "pool-xxxxxx" \
    --region cn-shanghai

4. 执行计划管理（Action Plan Management）

创建执行计划（CreateActionPlan）

# 创建执行计划
aliyun ehpcinstant CreateActionPlan \
    --region cn-shanghai \
    --PlanName "scheduled-plan" \
    --PlanDescription "Scheduled execution plan" \
    --PlanSpec '{"Schedule":"0 0 * * *","JobTemplate":{...}}'

查询执行计划列表（ListActionPlans）

# 查询执行计划列表
aliyun ehpcinstant ListActionPlans --region cn-shanghai

获取执行计划详情（GetActionPlan）

# 查询执行计划详情
aliyun ehpcinstant GetActionPlan \
    --PlanId "plan-xxxxxx" \
    --region cn-shanghai

查询执行计划活动（ListActionPlanActivities）

# 查询执行计划活动状态
aliyun ehpcinstant ListActionPlanActivities \
    --PlanId "plan-xxxxxx" \
    --region cn-shanghai

更新执行计划（UpdateActionPlan）

# 更新执行计划
aliyun ehpcinstant UpdateActionPlan \
    --PlanId "plan-xxxxxx" \
    --PlanSpec '{"Schedule":"0 1 * * *","JobTemplate":{...}}' \
    --region cn-shanghai

删除执行计划（DeleteActionPlan）

# 删除执行计划
aliyun ehpcinstant DeleteActionPlan \
    --PlanId "plan-xxxxxx" \
    --region cn-shanghai

5. 监控和指标（Monitoring & Metrics）

查询作业监控数据（DescribeJobMetricData）

# 查询作业监控指标
aliyun ehpcinstant DescribeJobMetricData \
    --JobId "job-xxxxxx" \
    --ArrayIndex 0 \
    --MetricName "CPUUtilization" \
    --StartTime "2026-04-11T10:00:00Z" \
    --EndTime "2026-04-11T11:00:00Z" \
    --region cn-shanghai

查询作业最新指标（DescribeJobMetricLast）

# 查询作业最新监控指标
aliyun ehpcinstant DescribeJobMetricLast \
    --JobId "job-xxxxxx" \
    --ArrayIndex 0 \
    --region cn-shanghai

6. 执行器管理（Executor Management）

查询全局执行器信息（ListExecutors）

# 查询所有执行器
aliyun ehpcinstant ListExecutors --region cn-shanghai

查询作业执行器信息（ListJobExecutors）

# 查询特定作业的执行器
aliyun ehpcinstant ListJobExecutors \
    --JobId "job-xxxxxx" \
    --region cn-shanghai

查询执行器事件（ListExecutorEvents）

# 查询执行器运行事件
aliyun ehpcinstant ListExecutorEvents \
    --ExecutorIds '["job-xxxxxx-Task0-0"]' \
    --region cn-shanghai

7. 标签管理（Tag Management）

绑定标签（TagResources）

# 为资源绑定标签
aliyun ehpcinstant TagResources \
    --RegionId cn-shanghai \
    --ResourceType "Job" \
    --ResourceId.1 "job-xxxxxx" \
    --Tag.1.Key "Environment" \
    --Tag.1.Value "Production" \
    --Tag.2.Key "Project" \
    --Tag.2.Value "E-HPC"

查询标签（ListTagResources）

# 查询资源标签
aliyun ehpcinstant ListTagResources \
    --RegionId cn-shanghai \
    --ResourceType "Job" \
    --ResourceId.1 "job-xxxxxx"

解绑标签（UnTagResources）

# 解绑资源标签
aliyun ehpcinstant UnTagResources \
    --RegionId cn-shanghai \
    --ResourceType "Job" \
    --ResourceId.1 "job-xxxxxx" \
    --TagKey.1 "Environment"

8. 应用管理（Application Management）

同步应用（SynchronizeApp）

# 应用跨区域同步
aliyun ehpcinstant SynchronizeApp \
    --RegionId cn-shanghai \
    --AppName "my-app" \
    --TargetRegion "cn-beijing"

获取应用版本（GetAppVersions）

# 获取应用版本列表
aliyun ehpcinstant GetAppVersions \
    --RegionId cn-shanghai \
    --AppName "my-app"

9. 实用脚本示例

作业提交完整流程

#!/bin/bash
# E-HPC Instant 作业提交脚本

REGION="cn-shanghai"
JOB_NAME="e-hpc-job-$(date +%Y%m%d-%H%M%S)"
CONTAINER_IMAGE="registry.cn-shanghai.aliyuncs.com/test/test:v1.0"
COMMAND='["/bin/sh", "-c", "sleep 1000"]'
USER_AGENT="AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill"

# 创建作业
JOB_ID=$(aliyun ehpcinstant CreateJob \
    --region $REGION \
    --JobName "$JOB_NAME" \
    --Tasks "[{\"TaskSpec\":{\"TaskExecutor\":[{\"Container\":{\"Image\":\"$CONTAINER_IMAGE\",\"Command\":$COMMAND}}],\"Resource\":{\"Cores\":4,\"Memory\":8}}},\"ExecutorPolicy\":{\"MaxCount\":1}}]" \
    --user-agent $USER_AGENT \
    --output cols=JobId rows=1)

echo "Created Job: $JOB_ID"

# 等待作业启动
sleep 10

# 查询作业状态
aliyun ehpcinstant GetJob \
    --JobId $JOB_ID \
    --region $REGION \
    --user-agent $USER_AGENT

# 查询作业日志
aliyun ehpcinstant DescribeJobResults \
    --JobId $JOB_ID \
    --TaskName "Task0" \
    --ArrayIndex 0 \
    --region $REGION \
    --user-agent $USER_AGENT

作业监控脚本

#!/bin/bash
# 作业监控脚本

JOB_ID=$1
REGION=${2:-cn-shanghai}
USER_AGENT="AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill"

while true; do
    # 获取作业状态
    STATUS=$(aliyun ehpcinstant GetJob \
        --JobId $JOB_ID \
        --region $REGION \
        --user-agent $USER_AGENT \
        --output cols=Status rows=1)
    
    echo "Job $JOB_ID status: $STATUS"
    
    if [[ "$STATUS" == "Succeeded" || "$STATUS" == "Failed" ]]; then
        break
    fi
    
    sleep 30
done

# 获取最终日志
aliyun ehpcinstant DescribeJobResults \
    --JobId $JOB_ID \
    --TaskName "Task0" \
    --ArrayIndex 0 \
    --region $REGION \
    --user-agent $USER_AGENT

批量作业管理

# 批量查询运行中的作业
aliyun ehpcinstant ListJobs \
    --Filter '{"Status":"Running"}' \
    --region cn-shanghai \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill \
    --output cols=JobId,JobName,Status,CreateTime

# 批量删除已完成的作业
COMPLETED_JOBS=$(aliyun ehpcinstant ListJobs \
    --Filter '{"Status":"Succeeded"}' \
    --region cn-shanghai \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill \
    --output cols=JobId | tail -n +2)

if [ -n "$COMPLETED_JOBS" ]; then
    JOB_ARRAY=""
    for job in $COMPLETED_JOBS; do
        if [ -z "$JOB_ARRAY" ]; then
            JOB_ARRAY="{\"JobId\":\"$job\"}"
        else
            JOB_ARRAY="$JOB_ARRAY,{\"JobId\":\"$job\"}"
        fi
    done
    
    aliyun ehpcinstant DeleteJobs \
        --JobSpec "[$JOB_ARRAY]" \
        --region cn-shanghai \
        --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill
fi

10. 故障排查

常见错误及解决方案

调试技巧

# 查看详细错误信息
aliyun ehpcinstant CreateJob --debug ...

# 验证JSON格式
echo '{"TaskSpec":{...}}' | python -m json.tool

11. 最佳实践

1. 作业命名规范：

• 包含用途、环境、时间戳信息
• 示例：prod-training-20260411-1000

2. 资源配置优化：

• 根据应用需求选择合适的实例规格
• 使用InstanceTypes优先于Cores/Memory配置

3. 错误处理：

• 检查作业状态后再进行后续操作
• 实现重试机制处理临时性错误

4. 成本控制：

• 及时删除已完成的作业
• 使用适当的资源规格避免浪费

5. 安全性：

• 使用私有镜像仓库
• 配置适当的网络访问控制

12. 参考文档

• E-HPC Instant API文档
• 阿里云CLI官方文档

E-HPC Instant Image镜像管理

通过阿里云CLI（优先）或SDK工具，实现对E-HPC Instant计算平台镜像资源的管理。主要操作包括添加镜像、查询镜像列表、获取镜像详情、移除镜像等，支持VM虚拟机及Container容器镜像类型。

添加镜像

VM虚拟机镜像

aliyun ehpcinstant AddImage \
    --region cn-shanghai \
    --Name 'Custom-VM-Image' \
    --ImageVersion '1.0' \
    --Description 'Custom VM image for E-HPC Instant' \
    --ImageType 'VM' \
    --VMImageSpec '{"ImageId":"m-xxxx"}' \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

Container容器镜像

aliyun ehpcinstant AddImage \
    --region cn-shanghai \
    --Name 'Custom-Container-Image' \
    --ImageVersion '1.0' \
    --Description 'Custom container image for E-HPC Instant' \
    --ImageType 'Container' \
    --ContainerImageSpec '{"RegistryUrl":"registry.cn-shanghai.aliyuncs.com/namespace/image:tag"}' \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

查询镜像列表

aliyun ehpcinstant ListImages --region cn-shanghai \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

获取镜像详情

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

移除镜像

aliyun ehpcinstant RemoveImage --region cn-shanghai --ImageId 'm-xxxx' \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill
**注意：** 移除镜像操作前，必须与用户确认后方可执行。

E-HPC Instant 作业命令配置

容器作业命令配置

容器作业通过Command参数指定要执行的命令：

单命令执行

"Container": {
    "Image": "registry.cn-shanghai.aliyuncs.com/registry/image:tag",
    "Command": "python /app/main.py"
}

多参数命令

"Container": {
    "Image": "registry.cn-shanghai.aliyuncs.com/registry/image:tag",
    "Command": "bash -c 'echo hello && sleep 100'"
}

带参数的命令数组

对于复杂命令，可以使用数组格式：

"Container": {
    "Image": "registry.cn-shanghai.aliyuncs.com/registry/image:tag",
    "Command": ["python", "/app/main.py", "--param1", "value1", "--param2", "value2"]
}

VM作业脚本配置

VM作业通过Script参数指定初始化脚本（Base64编码）：

脚本编码示例

# 原始脚本
echo '#!/bin/bash
echo "Starting job..."
python /app/main.py
' | base64 -w 0

# 在API中使用
"VM": {
    "Image": "m-xxxx",
    "Script": "IyEvYmluL2Jhc2gKZWNobyAiU3RhcnRpbmcgam9iLi4uIgpweXRob24gL2FwcC9tYWluLnB5Cg=="
}

命令配置最佳实践

• 容器作业：使用绝对路径指定可执行文件
• 环境变量：在命令中直接设置或通过镜像预配置
• 工作目录：确保命令路径与镜像内路径一致
• 退出码：作业成功要求命令正常退出（exit code 0）

常见命令示例

数据处理作业

python /app/process_data.py --input /data/input.csv --output /data/output.csv

机器学习训练

python /app/train.py --epochs 100 --batch-size 32 --learning-rate 0.001

长期运行服务

sleep 1000  # 或其他长期运行命令

注意事项

• 命令必须在镜像环境中可执行
• 避免使用交互式命令（如需要用户输入）
• 对于长时间运行的作业，确保命令不会意外退出[

E-HPC Instant作业技能所需的 RAM 权限策略

E-HPC Instant作业技能所需的 RAM 权限说明。

权限列表

最小权限策略

当您仅需要即时作业功能时，使用此策略：

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ehpc:AddImage",
        "ehpc:CreateJob",
        "ehpc:CreateImageByExecutor",
        "ehpc:DeleteJobs",
        "ehpc:DeleteJobRecords",
        "ehpc:DescribeJobMetricData",
        "ehpc:DescribeJobMetricLast",
        "ehpc:DescribeJobResults",
        "ehpc:GetAppVersions",
        "ehpc:GetImage",
        "ehpc:GetJob",
        "ehpc:GetLoginUrlForExecutor",
        "ehpc:GetGlobalResourceLast",
        "ehpc:GetGlobalResourceStatistic",
        "ehpc:ListImages",
        "ehpc:ListJobExecutors",
        "ehpc:ListJobs",
        "ehpc:RemoveImage",
        "ehpc:SynchronizeApp",
        "ehpc:ListRegions",
        "ehpc:ListAvailableFileSystems"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "ecs:DescribeImages",
        "ecs:DescribeSecurityGroups",
        "vpc:DescribeVpcs",
        "vpc:DescribeVSwitches",
        "vpc:DescribeEipAddresses"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "tag:ListTagKeys",
        "tag:ListTagValues"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": "cms:QueryMetricList",
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": "oss:ListBuckets",
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": "ram:GetRole",
      "Resource": "*"
    }
  ]
}

完整权限策略（推荐）

推荐在生产环境中使用，包含额外的查询和监控权限：

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ehpc:AddImage",
        "ehpc:CreateJob",
        "ehpc:CreateImageByExecutor",
        "ehpc:DeleteJobs",
        "ehpc:DeleteJobRecords",
        "ehpc:DescribeJobMetricData",
        "ehpc:DescribeJobMetricLast",
        "ehpc:DescribeJobResults",
        "ehpc:GetAppVersions",
        "ehpc:GetImage",
        "ehpc:GetJob",
        "ehpc:GetLoginUrlForExecutor",
        "ehpc:GetGlobalResourceLast",
        "ehpc:GetGlobalResourceStatistic",
        "ehpc:ListImages",
        "ehpc:ListJobExecutors",
        "ehpc:ListJobs",
        "ehpc:RemoveImage",
        "ehpc:SynchronizeApp",
        "ehpc:ListRegions",
        "ehpc:ListAvailableFileSystems"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "ecs:DescribeImages",
        "ecs:DescribeSecurityGroups",
        "vpc:DescribeVpcs",
        "vpc:DescribeVSwitches",
        "vpc:DescribeEipAddresses"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "tag:ListTagKeys",
        "tag:ListTagValues"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": "cms:QueryMetricList",
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": "oss:ListBuckets",
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": "ram:GetRole",
      "Resource": "*"
    }
  ]
}

注意： ehpc:DescribeJobMetricData 和 ehpc:DescribeJobMetricLast 用于查询作业运行时的监控数据，有助于跟踪作业执行进度和资源使用情况。ehpc:GetGlobalResourceLast 和 ehpc:GetGlobalResourceStatistic 用于查看全局资源的使用状态和统计信息。ecs:DescribeImages 和 ecs:DescribeSecurityGroups 用于创建作业时选择镜像和安全组。vpc:DescribeVpcs、vpc:DescribeVSwitches 和 vpc:DescribeEipAddresses 用于配置作业的网络环境。cms:QueryMetricList 用于查询云监控指标数据。oss:ListBuckets 用于列出可用的 OSS 存储桶。ram:GetRole 用于获取服务关联角色信息。

权限验证命令

附加策略后，验证权限是否正确：

# 验证 E-HPC 作业列表查询权限
aliyun ehpcinstant ListJobs \
  --region-id cn-hangzhou \
  --PageSize 10 \
  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

# 验证 E-HPC 镜像列表查询权限
aliyun ehpcinstant ListImages \
  --region-id cn-hangzhou \
  --PageSize 10 \
  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

如果所有命令均成功返回数据，则说明权限已正确配置。

常见权限错误与排查

错误：Forbidden.RAM / NoPermission

原因： RAM 用户没有所需的权限。

解决方案： 1. 登录 RAM 控制台 2. 找到目标 RAM 用户 3. 点击"添加权限" 4. 选择"自定义策略"并粘贴上述最小权限策略 JSON 5. 或选择系统策略：AliyunEHPCFullAccess + AliyunECSReadOnlyAccess + AliyunVPCReadOnlyAccess（更宽泛的权限）

错误：ehpc:CreateJob 上的 Forbidden

原因： 缺少 E-HPC 作业创建权限。

解决方案： 确保策略中包含 ehpc:CreateJob 操作。

错误：ehpc:ListJobs 上的 Forbidden

原因： 缺少 E-HPC 作业查询权限。

解决方案： 确保策略中包含 ehpc:ListJobs 和 ehpc:GetJob 操作。作业管理流程需要这些权限来查询和获取作业状态。

错误：InvalidAccount.NotFound

原因： AccessKey 不正确或账号不存在。

解决方案：

• 检查 AccessKey ID 是否正确
• 在 RAM 控制台中验证 AccessKey 是否处于启用状态
• 在当前会话外使用 aliyun configure 交互式配置或通过环境变量重新配置凭据

使用预定义系统策略

如果自定义策略不方便，可以直接附加以下系统策略：

附加方法：

# 通过 RAM 控制台或 CLI 附加
aliyun ram attach-policy-to-user \
  --policy-type System \
  --policy-name AliyunEHPCFullAccess \
  --user-name <你的RAM用户名> \
  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

安全建议： 在生产环境中，建议使用自定义最小权限策略而非完整访问的系统策略，以遵循最小权限原则。

E-HPC Instant 计算资源配置

资源配置选项

E-HPC Instant支持两种资源配置方式： 1. 按规格配置：指定实例规格（InstanceType） 2. 按资源配置：指定CPU核数和内存大小

实例规格配置（推荐）

# 使用实例规格（高优先级）
"Resource": {
    "InstanceTypes": ["ecs.c6.xlarge"],
    "Disks": [{"Type":"System","Size":50}]
}

CPU/内存配置

# 指定CPU核数和内存（GB）
"Resource": {
    "Cores": 4,
    "Memory": 8,
    "Disks": [{"Type":"System","Size":40}]
}

常用实例规格参考

磁盘配置

• 系统盘：必需，最小40GB（容器）/40GB（VM）
• 数据盘：可选，格式：{"Type":"Data","Size":100}

完整资源配置示例

容器作业

"Resource": {
    "Cores": 4,
    "Memory": 8,
    "InstanceTypes": ["ecs.c6.xlarge"],
    "Disks": [{"Type":"System","Size":40}]
}

VM作业

"Resource": {
    "Cores": 4,
    "Memory": 8,
    "InstanceTypes": ["ecs.c6.xlarge"],
    "Disks": [
        {"Type":"System","Size":50},
        {"Type":"Data","Size":100}
    ]
}

注意事项

• InstanceType配置优先级高于Cores/Memory配置
• 确保所选规格在目标区域可用
• GPU实例需要特殊镜像支持

阿里云文件存储NAS管理手册（CLI版本）

概述

阿里云文件存储NAS（Network Attached Storage）提供共享文件存储服务，支持 NFS 和 SMB 协议。本手册介绍使用阿里云 CLI 进行 NAS 文件系统的增删改查操作。

前置条件

1. 安装阿里云CLI：确保已安装并配置阿里云 CLI 2. 权限配置：AccessKey 需要具备 NAS 相关权限 3. 区域选择：确认操作的区域（如 cn-shanghai） 4. User-Agent标识：所有命令均应附加 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill 参数，用于服务端识别调用来源。如已通过 aliyun configure ai-mode set-user-agent 配置，则会自动附加，无需手动添加。

1. 创建文件系统（Create）

创建通用型NAS文件系统

# 创建容量型通用NAS（NFS协议）
aliyun nas CreateFileSystem \
    --ProtocolType NFS \
    --StorageType Capacity \
    --Description "E-HPC Instant NAS for compute jobs" \
    --RegionId cn-shanghai

# 创建性能型通用NAS（NFS协议）
aliyun nas CreateFileSystem \
    --ProtocolType NFS \
    --StorageType Performance \
    --Description "E-HPC Instant NAS for compute jobs" \
    --RegionId cn-shanghai

# 创建容量型通用NAS（SMB协议）
aliyun nas CreateFileSystem \
    --ProtocolType SMB \
    --StorageType Capacity \
    --Description "SMB file system for Windows workloads" \
    --RegionId cn-shanghai

参数说明

• ProtocolType: 协议类型（NFS/SMB/cpfs）
• StorageType: 存储类型（Performance/Capacity/Premium/standard/advance）
• FileSystemType: 文件系统类型（standard/extreme/cpfs/cpfsse）
• Capacity: 容量（GiB），极速型和CPFS必需
• ZoneId: 可用区ID，极速型和CPFS必需
• EncryptType: 加密类型（0=不加密，1=NAS托管密钥，2=KMS托管密钥）

创建注意事项

• 默认创建规格：因涉及到成本及性价比因素，在用户未指定的情况下默认创建通用容量型NAS文件存储，NFS协议。
• 执行前与用户确认：配置明确后进一步与用户确认，用户同意后执行创建。

2. 查询文件系统（Read/List）

查询所有文件系统

# 查询所有类型的文件系统
aliyun nas DescribeFileSystems --RegionId cn-shanghai

# 分页查询（每页10条，第1页）
aliyun nas DescribeFileSystems \
    --PageSize 10 \
    --PageNumber 1 \
    --RegionId cn-shanghai

# 查询特定类型的文件系统
aliyun nas DescribeFileSystems \
    --FileSystemType standard \
    --RegionId cn-shanghai

# 查询特定文件系统
aliyun nas DescribeFileSystems \
    --FileSystemId 31a8e4xxxx \
    --RegionId cn-shanghai

查询结果字段说明

• FileSystemId: 文件系统ID
• ProtocolType: 协议类型
• StorageType: 存储类型
• MeteredSize: 已使用容量（Byte）
• CreateTime: 创建时间
• Status: 状态（Active/Creating/Stopping等）

3. 创建挂载点（Mount Target）

为VPC网络创建挂载点

# 为通用NAS创建VPC挂载点
aliyun nas CreateMountTarget \
    --FileSystemId 31a8e4xxxx \
    --NetworkType Vpc \
    --VpcId vpc-xxxx \
    --VSwitchId vsw-xxxx \
    --AccessGroupName DEFAULT_VPC_GROUP_NAME \
    --RegionId cn-shanghai

# 为极速NAS创建挂载点（自动使用默认权限组）
aliyun nas CreateMountTarget \
    --FileSystemId extreme-xxxx \
    --NetworkType Vpc \
    --VpcId vpc-xxxx \
    --VSwitchId vsw-xxxx \
    --RegionId cn-shanghai

查询挂载点

# 查询文件系统的所有挂载点
aliyun nas DescribeMountTargets \
    --FileSystemId 31a8e4xxxx \
    --RegionId cn-shanghai

# 查询特定挂载点
aliyun nas DescribeMountTargets \
    --FileSystemId 31a8e4xxxx \
    --MountTargetDomain 31a8e4xxxx.cn-shanghai.nas.aliyuncs.com \
    --RegionId cn-shanghai

挂载点关键信息

• MountTargetDomain: 挂载地址（用于实际挂载）
• VpcId: 关联的VPC ID
• VSwitchId: 关联的交换机ID
• Status: 挂载点状态（Active/Inactive）

4. 修改文件系统（Update）

修改文件系统描述

aliyun nas ModifyFileSystem \
    --FileSystemId 31a8e4xxxx \
    --Description "Updated description for E-HPC jobs" \
    --RegionId cn-shanghai

修改挂载点（仅支持修改描述）

aliyun nas ModifyMountTarget \
    --FileSystemId 31a8e4xxxx \
    --MountTargetDomain 31a8e4xxxx.cn-shanghai.nas.aliyuncs.com \
    --Description "Updated mount target description" \
    --RegionId cn-shanghai

扩容文件系统（仅极速型和CPFS）

# 扩容极速型NAS
aliyun nas UpgradeFileSystem \
    --FileSystemId extreme-xxxx \
    --Capacity 1000 \
    --RegionId cn-shanghai

5. 删除文件系统（Delete）

删除挂载点（必需先删除）

# 注意：NAS CLI没有直接删除挂载点的命令
# 需要通过控制台或等待文件系统删除时自动清理

删除文件系统

# 删除通用型NAS文件系统
aliyun nas DeleteFileSystem \
    --FileSystemId 31a8e4xxxx \
    --RegionId cn-shanghai

# 删除极速型NAS文件系统
aliyun nas DeleteFileSystem \
    --FileSystemId extreme-xxxx \
    --RegionId cn-shanghai

删除注意事项

• 必须先卸载：确保没有客户端正在使用文件系统
• 数据不可恢复：删除后数据无法恢复，请谨慎操作
• 挂载点自动清理：删除文件系统时，关联的挂载点会自动删除

6. E-HPC Instant 作业中的NAS使用

在容器作业中挂载NAS

aliyun ehpcinstant CreateJob \
    --region cn-shanghai \
    --JobName 'job-with-nas' \
    --Tasks '[{
        "TaskSpec": {
            "TaskExecutor": [{
                "Container": {
                    "Image": "registry.cn-shanghai.aliyuncs.com/registry/image:tag",
                    "Command": "[\"/bin/sh\", \"-c\", \"echo hello > /mnt/nas/output.txt\"]",
                }
            }],
            "Resource": {
                "Cores": 2,
                "Memory": 4
            },
            "VolumeMount": [
              {
                "MountPath": "/mnt",
                "VolumeDriver": "alicloud/nas",
                "MountOptions": "{\"server\":\"xxx.cn-shanghai.nas.aliyuncs.com\",\"vers\":\"3\",\"path\":\"/\",\"options\":\"nolock,tcp,noresvport\"}"
              }
            ],
        },
        "ExecutorPolicy": {"MaxCount": 1}
    }]' \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

NAS挂载参数说明

• Server: NAS服务器地址（挂载点域名）
• Path: NAS文件系统中的路径（通常为"/"）
• MountPath: 容器内的挂载路径
• ReadOnly: 是否只读挂载（true/false）

7. 常用操作示例

完整创建流程示例

#!/bin/bash
# 1. 创建文件系统
FILESYSTEM_ID=$(aliyun nas CreateFileSystem \
    --ProtocolType NFS \
    --StorageType Performance \
    --Description "E-HPC NAS" \
    --RegionId cn-shanghai \
    --output cols=FileSystemId rows=1)

echo "Created FileSystem: $FILESYSTEM_ID"

# 2. 等待文件系统激活（实际使用中需要检查状态）
sleep 60

# 3. 创建挂载点
aliyun nas CreateMountTarget \
    --FileSystemId $FILESYSTEM_ID \
    --NetworkType Vpc \
    --VpcId your-vpc-id \
    --VSwitchId your-vswitch-id \
    --RegionId cn-shanghai

# 4. 获取挂载地址
MOUNT_DOMAIN=$(aliyun nas DescribeMountTargets \
    --FileSystemId $FILESYSTEM_ID \
    --RegionId cn-shanghai \
    --output cols=MountTargetDomain rows=1)

echo "Mount Domain: $MOUNT_DOMAIN"

查询和监控脚本

# 查询文件系统使用情况
aliyun nas DescribeFileSystems \
    --FileSystemId 31a8e4xxxx \
    --RegionId cn-shanghai \
    --output cols=FileSystemId,MeteredSize,TotalSize

# 列出所有活跃的文件系统
aliyun nas DescribeFileSystems \
    --RegionId cn-shanghai \
    --output cols=FileSystemId,ProtocolType,StorageType,Status,CreateTime

8. 故障排查

常见问题及解决方案

权限组配置

通用型NAS需要配置权限组来控制访问权限：

# 创建权限组
aliyun nas CreateAccessGroup \
    --AccessGroupName e-hpc-access-group \
    --NetworkType Vpc \
    --RegionId cn-shanghai

# 添加访问规则
aliyun nas CreateAccessRule \
    --AccessGroupName e-hpc-access-group \
    --SourceCidrIp 192.168.0.0/16 \
    --RWAccessMode RW \
    --UserAccessType no_squash \
    --Priority 1 \
    --RegionId cn-shanghai

9. 最佳实践

1. 区域一致性：NAS文件系统与E-HPC Instant作业在同一区域 2. 可用区优化：极速型NAS选择与计算资源相同的可用区 3. 存储类型选择：

• 通用计算：通用型NAS（性能型）
• 高性能计算：极速型NAS
• 大规模并行：CPFS

4. 安全配置：启用加密保护敏感数据 5. 监控告警：设置容量和性能监控

10. 参考文档

• 阿里云NAS产品文档
• NAS API文档

阿里云网络vSwitch管理手册（CLI版本）

概述

虚拟交换机（vSwitch）是阿里云专有网络VPC中的基础网络组件，用于连接云资源（如ECS实例、容器等）。本手册介绍使用阿里云 CLI 进行 vSwitch 的增删改查操作。

前置条件

1. 安装阿里云CLI：确保已安装并配置阿里云 CLI 2. 权限配置：AccessKey 需要具备 VPC 相关权限 3. 区域选择：确认操作的区域（如 cn-shanghai） 4. VPC准备：vSwitch 必须关联到现有的 VPC 5. User-Agent标识：所有命令均应附加 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill 参数，用于服务端识别调用来源。如已通过 aliyun configure ai-mode set-user-agent 配置，则会自动附加，无需手动添加。

1. 创建vSwitch（Create）

基本创建命令

# 创建基本vSwitch
aliyun vpc CreateVSwitch \
    --VpcId vpc-xxxxxx \
    --ZoneId cn-shanghai-a \
    --CidrBlock 192.168.1.0/24 \
    --VSwitchName "e-hpc-compute-vswitch" \
    --Description "VSwitch for E-HPC Instant compute jobs" \
    --RegionId cn-shanghai

高级创建选项

# 创建支持IPv6的vSwitch
aliyun vpc CreateVSwitch \
    --VpcId vpc-xxxxxx \
    --ZoneId cn-shanghai-b \
    --CidrBlock 192.168.2.0/24 \
    --Ipv6CidrBlock 255 \
    --VSwitchName "ipv6-enabled-vswitch" \
    --Description "IPv6 enabled vSwitch for high-performance computing" \
    --RegionId cn-shanghai

# 带标签的vSwitch创建
aliyun vpc CreateVSwitch \
    --VpcId vpc-xxxxxx \
    --ZoneId cn-shanghai-c \
    --CidrBlock 192.168.3.0/24 \
    --VSwitchName "tagged-vswitch" \
    --Tag.1.Key Environment \
    --Tag.1.Value Production \
    --Tag.2.Key Project \
    --Tag.2.Value E-HPC \
    --RegionId cn-shanghai

参数说明

• VpcId: 关联的VPC ID（必需）
• ZoneId: 可用区ID（必需），可通过 aliyun ecs DescribeZones 查询
• CidrBlock: vSwitch网段（必需），必须在VPC网段范围内，子网掩码16-29位
• VSwitchName: vSwitch名称（可选），1-128字符
• Description: 描述信息（可选），1-256字符
• Ipv6CidrBlock: IPv6网段最后8位（0-255），仅当VPC启用IPv6时可用
• RegionId: 区域ID（可选），默认使用配置的区域

CIDR规划建议

• E-HPC场景：建议使用 /24 或 /25 网段（256或128个IP）
• 避免冲突：确保不与VPC路由表中的目标网段冲突
• 预留空间：为未来扩展预留IP地址空间

2. 查询vSwitch（Read/List）

查询所有vSwitch

# 查询指定区域的所有vSwitch
aliyun vpc DescribeVSwitches --RegionId cn-shanghai

# 分页查询（每页20条，第1页）
aliyun vpc DescribeVSwitches \
    --PageSize 20 \
    --PageNumber 1 \
    --RegionId cn-shanghai

条件查询

# 查询指定VPC下的vSwitch
aliyun vpc DescribeVSwitches \
    --VpcId vpc-xxxxxx \
    --RegionId cn-shanghai

# 查询指定可用区的vSwitch
aliyun vpc DescribeVSwitches \
    --ZoneId cn-shanghai-a \
    --RegionId cn-shanghai

# 查询特定名称的vSwitch
aliyun vpc DescribeVSwitches \
    --VSwitchName "e-hpc-compute-vswitch" \
    --RegionId cn-shanghai

# 查询特定vSwitch详情
aliyun vpc DescribeVSwitches \
    --VSwitchId vsw-xxxxxx \
    --RegionId cn-shanghai

查询结果字段说明

• VSwitchId: vSwitch ID（如 vsw-uf6wc3sfmxo6rsubsozcd）
• VpcId: 关联的VPC ID
• ZoneId: 所在可用区
• CidrBlock: 网段CIDR
• Status: 状态（Available/Deleting等）
• AvailableIpAddressCount: 可用IP数量
• CreationTime: 创建时间

3. 修改vSwitch（Update）

修改基本信息

# 修改vSwitch名称和描述
aliyun vpc ModifyVSwitchAttribute \
    --VSwitchId vsw-xxxxxx \
    --VSwitchName "updated-e-hpc-vswitch" \
    --Description "Updated description for E-HPC jobs" \
    --RegionId cn-shanghai

启用IPv6功能

# 为vSwitch启用IPv6（需要VPC已启用IPv6）
aliyun vpc ModifyVSwitchAttribute \
    --VSwitchId vsw-xxxxxx \
    --EnableIPv6 true \
    --Ipv6CidrBlock 200 \
    --RegionId cn-shanghai

参数说明

• VSwitchId: 要修改的vSwitch ID（必需）
• VSwitchName: 新名称（可选）
• Description: 新描述（可选）
• EnableIPv6: 是否启用IPv6（true/false）
• Ipv6CidrBlock: IPv6网段最后8位（仅当启用IPv6时需要）

4. 删除vSwitch（Delete）

删除vSwitch

# 删除vSwitch（确保没有关联资源）
aliyun vpc DeleteVSwitch \
    --VSwitchId vsw-xxxxxx \
    --RegionId cn-shanghai

删除前检查（Dry Run）

# 执行删除前的预检查
aliyun vpc DeleteVSwitch \
    --VSwitchId vsw-xxxxxx \
    --DryRun true \
    --RegionId cn-shanghai

删除注意事项

• 资源清理：确保vSwitch上没有运行的ECS实例、ENI等资源
• E-HPC依赖：如果vSwitch被E-HPC Instant作业使用，需先删除相关作业
• 不可恢复：删除后无法恢复，请谨慎操作
• 异步操作：删除操作可能需要几分钟完成

5. VPC管理基础（vSwitch依赖）

查询VPC列表

# 查询区域内的VPC
aliyun vpc DescribeVpcs --RegionId cn-shanghai

# 查询特定VPC
aliyun vpc DescribeVpcs \
    --VpcId vpc-xxxxxx \
    --RegionId cn-shanghai

创建VPC（如果需要）

# 创建基本VPC
aliyun vpc CreateVpc \
    --CidrBlock 192.168.0.0/16 \
    --VpcName "e-hpc-vpc" \
    --Description "VPC for E-HPC Instant" \
    --RegionId cn-shanghai

6. E-HPC Instant 作业中的vSwitch使用

在作业中指定vSwitch

# 容器作业指定vSwitch
aliyun ehpcinstant CreateJob \
    --region cn-shanghai \
    --JobName 'job-with-specific-vswitch' \
    --DeploymentPolicy '{"Network":{"Vswitch":["vsw-xxxxxx"]},"AllocationSpec":"Standard"}' \
    --Tasks '[{
        "TaskSpec": {
            "TaskExecutor": [{
                "Container": {
                    "Image": "registry.cn-shanghai.aliyuncs.com/registry/image:tag",
                    "Command": "[\"/bin/sh\", \"-c\", \"echo hello\"]"
                }
            }],
            "Resource": {
                "Cores": 2,
                "Memory": 4
            }
        },
        "ExecutorPolicy": {"MaxCount": 1}
    }]' \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

多vSwitch高可用配置

# 指定多个vSwitch实现高可用
aliyun ehpcinstant CreateJob \
    --region cn-shanghai \
    --DeploymentPolicy '{"Network":{"Vswitch":["vsw-xxxxxx","vsw-yyyyyy"]},"AllocationSpec":"Standard"}' \
    --Tasks '[{...}]' \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

7. 常用操作示例

完整vSwitch创建流程

#!/bin/bash
# 1. 查询可用区
ZONE_ID=$(aliyun ecs DescribeZones \
    --RegionId cn-shanghai \
    --output cols=ZoneId rows=1)

echo "Selected Zone: $ZONE_ID"

# 2. 查询VPC（假设已有VPC）
VPC_ID=$(aliyun vpc DescribeVpcs \
    --RegionId cn-shanghai \
    --output cols=VpcId rows=1)

echo "Using VPC: $VPC_ID"

# 3. 创建vSwitch
VSWITCH_ID=$(aliyun vpc CreateVSwitch \
    --VpcId $VPC_ID \
    --ZoneId $ZONE_ID \
    --CidrBlock 192.168.10.0/24 \
    --VSwitchName "auto-created-vswitch" \
    --Description "Auto created for E-HPC" \
    --RegionId cn-shanghai \
    --output cols=VSwitchId rows=1)

echo "Created vSwitch: $VSWITCH_ID"

# 4. 验证创建结果
aliyun vpc DescribeVSwitches \
    --VSwitchId $VSWITCH_ID \
    --RegionId cn-shanghai

vSwitch监控脚本

# 检查vSwitch可用IP数量
aliyun vpc DescribeVSwitches \
    --VSwitchId vsw-xxxxxx \
    --RegionId cn-shanghai \
    --output cols=VSwitchId,AvailableIpAddressCount,CidrBlock

# 列出所有活跃的vSwitch
aliyun vpc DescribeVSwitches \
    --RegionId cn-shanghai \
    --output cols=VSwitchId,VSwitchName,ZoneId,CidrBlock,AvailableIpAddressCount

批量操作示例

# 批量查询多个vSwitch
VSWITCH_IDS="vsw-xxxxxx,vsw-yyyyyy,vsw-zzzzzz"
aliyun vpc DescribeVSwitches \
    --VSwitchId $VSWITCH_IDS \
    --RegionId cn-shanghai

8. 故障排查

常见问题及解决方案

网络连通性检查

# 检查vSwitch状态
aliyun vpc DescribeVSwitches \
    --VSwitchId vsw-xxxxxx \
    --RegionId cn-shanghai

# 检查关联的路由表
aliyun vpc DescribeRouteTables \
    --VpcId vpc-xxxxxx \
    --RegionId cn-shanghai

# 检查安全组规则
aliyun ecs DescribeSecurityGroupAttribute \
    --SecurityGroupId sg-xxxxxx \
    --RegionId cn-shanghai

9. 最佳实践

1. 可用区选择：

• 选择与计算资源相同的可用区减少延迟
• 多可用区部署提高可用性

2. CIDR规划：

• 使用连续的网段便于管理
• 为不同用途的vSwitch分配不同网段
• 预留足够的IP地址空间

3. 命名规范：

• 包含用途、环境、区域信息
• 示例：prod-cn-shanghai-a-e-hpc-compute

4. 标签管理：

• 使用标签进行资源分类和成本分摊
• 标签示例：Environment=Production, Project=E-HPC, Owner=TeamA

5. 安全配置：

• 配置适当的网络安全组规则
• 使用网络ACL进行额外的安全控制
• 定期审查网络配置

10. 参考文档

• 阿里云VPC产品文档
• VPC API文档
• 可用区查询