Alibaba Cloud E-HPC Instant Job Management Skill

Skill Overview

Full lifecycle management of jobs and computing resources on the E-HPC Instant computing platform is implemented via Alibaba Cloud CLI (preferred) or SDK tools.

Interaction Principles

User-friendly: Maintain a professional and friendly tone, using respectful language when addressing users
Transparent operation: All key configuration information must be displayed to users and confirmed
Security first: Follow the principle of least privilege to avoid accidental operations
Error handling: Provide clear error messages and solutions
Format specification: Use simple, clear, and easy-to-read output formats

Execution Process

Step1: Preload Configuration
Step2: Precondition Check
Step3: Job Management Execution
Step4: Job Task Execution Result Output

Step 1: Preload Configuration

[MUST] Must first attempt to read the
./jobconfig/pre-config.json
file, strictly prohibited to skip this check step.
File exists and read successfully: Load the parameter values, prompt the user that the pre-configuration has been loaded and display a summary of key parameters, then proceed to Step 2.

File does not exist: Prompt the user that no pre-configuration file is detected, necessary parameters will be obtained through interaction in Step 2, then proceed to Step 2.

File exists but read/parsing failed (such as JSON format error, insufficient permissions, etc.): Report specific error information to the user, ask whether to continue (skip pre-configuration and enter Step 2) or abort execution.

Step 2: Precondition Check

General Checks for All Job Management Tasks

Alibaba Cloud CLI Configuration: Verify that CLI is installed and AccessKey is configured
- CLI version requirement >= 3.3.3: Run
```
aliyun version
```
  to verify version >= 3.3.3. If not installed or version is too low, refer to the installation instructions in references/aliyun-cli.md for installation or update.
- [MUST] Run
```
aliyun configure set --auto-plugin-install true
```
  to enable automatic plugin installation.
- [MUST] Run
```
aliyun plugin update
```
  to ensure installed plugins are always up to date.
- If no configuration is found, guide users to install and configure interactively
- Reference: references/aliyun-cli.md
- [MUST] CLI User-Agent — Each
```
aliyun
```
  CLI command call must include:
```
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill
```
- Enable Alibaba Cloud CLI AI Mode: Run the following initialization commands to attach AI identity information for this Skill execution:
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
```
Alibaba Cloud CLI provides AI Mode. After enabling it, the CLI will automatically attach AI identity information, allowing the server to identify and optimize the Agent call chain. [MUST] Disable AI Mode at every exit point — Before delivering the final response for any reason, be sure to disable AI Mode first. This applies to all exit paths: workflow success, workflow failure, error/exception, user cancellation, session end, or any scenario where no more CLI commands will be executed. AI Mode is only used for Agent Skill invocation scenarios, and must remain disabled after the skill stops running.
bash
```
aliyun configure ai-mode disable
```
Region Information: Obtain the user-specified region or use the default region
```
cn-shanghai
```
Permission Verification: Ensure the AccessKey has permissions related to E-HPC Instant

Special Checks for Job Creation Tasks

Image Preparation: Container/VM image has been added to the E-HPC Instant platform
- If no image exists, guide users to add it interactively
- Reference: references/instant-image.md
Network Configuration: vSwitch has been created and is available
- If no vSwitch exists, guide users to create it interactively
- Reference: references/vswitch.md
Storage Configuration: NAS mount path is prepared (if needed)
- If NAS is required, guide users to configure it interactively
- Reference: references/storage.md
Computing Resource Configuration: Cores/Memory or InstanceType specifications have been specified
- Guide users to select appropriate resource configurations
- Reference: references/resource.md
Execution Command: Job execution command line has been specified
- Ensure the command format is correct (especially JSON array format)
- Reference: references/job-command.md

Step 3: Job Management Execution

Execute the corresponding job management operations according to user requirements

Create Job

Container Job

bash

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

VM Job

bash

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

Query Job List

bash

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

# Pagination query (recommended for large number of jobs)
aliyun ehpcinstant ListJobs --region cn-shanghai --PageSize 10 --PageNumber 1 \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

# Conditional filtering (by status, time, etc.)
aliyun ehpcinstant ListJobs --region cn-shanghai --Filter '{"Status":"Running"}' \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

Get Job Details

bash

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

Query Job Logs

bash

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

Delete Job

bash

# Delete single job
aliyun ehpcinstant DeleteJobs --region cn-shanghai --JobSpec '[{"JobId":"job-xxxx"}]' \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

# Batch deletion (safe method)
aliyun ehpcinstant DeleteJobs --region cn-shanghai --JobSpec '[{"JobId":"job-xxxx"},{"JobId":"job-yyyy"}]' \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ehpc-instant-job-skill

[MUST] Idempotent Deletion Principle — When a user requests to delete a job, even if querying via GetJob or ListJobs confirms the job no longer exists, the Agent must still call the DeleteJobs API with the corresponding JobId. The DeleteJobs API is idempotent: it deletes the job if it exists, and returns a standard NotFound response if it does not exist. It is strictly prohibited for the Agent to skip the API call on the grounds of "job does not exist" — the server must confirm the final status.

Step 4: Result Output and Follow-up Suggestions

Format and output execution results
Provide follow-up operation suggestions (such as monitoring, log viewing, etc.)
Record key information for future reference

Job Management Reference Execution Scripts

Path:

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

CLI Scripts:

```
create_container_job.sh
```
- Create container job
```
create_vm_job_batch.sh
```
- Create VM job
```
create_vm_job_longrunning.sh
```
- Create long-running VM job
```
list_jobs.sh
```
- List jobs (supports pagination)
```
get_job.sh
```
- Get job details
```
delete_jobs.sh
```
- Delete jobs

SDK Scripts:

Corresponding Python SDK version scripts are located in the
```
scripts/sdk/
```
directory
```
create_container_job.py
```
- Create container job
```
create_vm_job_batch.py
```
- Create VM job
```
create_vm_job_longrunning.py
```
- Create long-running VM job
```
list_jobs.py
```
- List jobs (supports pagination)
```
get_job.py
```
- Get job details
```
delete_jobs.py
```
- Delete jobs

Notes

CLI Command Accuracy: E-HPC Instant uses the
```
aliyun ehpcinstant
```
command, not
```
aliyun ehpc
```
!
Region Consistency: All resources must be in the same region; cross-region operations will fail
Quota Limits: Pay attention to account quota limits to avoid operation failures
Cost Awareness: Job running incurs fees, clean up unnecessary resources in a timely manner
Least Privilege: Configure AccessKey with minimal necessary permissions to improve security

Troubleshooting and Best Practices

Common Issue Solutions

Issue	Root Cause	Solution
InvalidCommand Error	Incorrect Command parameter format	Use the correct JSON array format: `["/bin/sh", "-c", "command"]`
Authentication Failed	Incorrect AccessKey configuration or insufficient permissions	Check the `~/.aliyun/config.json` configuration, ensure it has E-HPC Instant permissions
Image Does Not Exist	Incorrect image ID or region mismatch	Confirm the image ID is correct and in the same region, refer to references/instant-image.md
Network Configuration Error	Incorrect VSwitch ID or unavailable	Check VSwitch ID and security group configuration, refer to references/vswitch.md
Insufficient Resource Quota	Account quota limits	Contact Alibaba Cloud to increase quota, or adjust resource configuration
Command Execution Failed	Incorrect command path in container	Ensure the command is executable in the image environment, use absolute paths

Best Practices Guide

Naming Conventions:
- Job name:
```
Application-Case-Timestamp
```
  (e.g.:
```
prod-training-20260411
```
  )
- Resource name: Include purpose, environment, and region information
Resource Configuration Optimization:
- Select appropriate instance specifications based on application characteristics
- Avoid over-provisioning to prevent resource waste
Cost Control:
- Clean up completed jobs in a timely manner
- Use appropriate job timeout settings
- Monitor resource usage
Reliability Assurance:
- Implement job status monitoring and retry mechanisms
- Configure appropriate error handling and alerts
- Regularly back up important configurations and data
Security Enhancement:
- Use private image repositories
- Configure AccessKey with minimal permissions
- Enable network access control and encryption

Reference Materials and Extensions

Complete API Reference

If you are still unsure about job management execution parameters, you can refer to the following links:

references/ehpcinstant.md - E-HPC Instant Complete CLI Command Manual
CLI help command:
```
aliyun ehpcinstant <ApiName> --help
```

Special Configuration Guides

references/aliyun-cli.md - Alibaba Cloud CLI Configuration Guide
references/instant-image.md - Image Management Guide
references/vswitch.md - Network vSwitch Management Guide
references/storage.md - NAS Storage Management Guide
references/resource.md - Computing Resource Configuration Guide
references/job-command.md - Job Command Configuration Guide

Official Documentation

Alibaba Cloud E-HPC Instant Product Documentation: https://help.aliyun.com/product/ehpcinstant.html
E-HPC Instant API Documentation: https://api.aliyun.com/document/EhpcInstant/2023-07-01/overview
Alibaba Cloud CLI Official Documentation: https://help.aliyun.com/document_detail/121529.html

Security Policies and Risk Control

Operation Risk Level Classification

Risk Level	Operation Type	Agent Code of Conduct
Low Risk	Query operations (list, get, check, describe)	Execute directly, no additional confirmation required
Medium Risk	Configuration operations (configure, modify, update)	Prompt the scope of impact, execute after obtaining user confirmation
High Risk	Creation/deletion operations (create, delete, remove)	Must display all configuration information completely, execute only after explicit user confirmation

[MUST] Prohibit Skipping API Calls — When the Agent performs operations such as deletion, it must not skip the actual API call based on query results (such as GetJob returning NotFound) and self-judge "no operation needed". There is a time window between query and change, and the server status may have changed. The Agent must always execute the target API requested by the user (such as DeleteJobs), and the server returns the authoritative final result.

Security Check Checklist

✅ Region Consistency: Ensure all resources are in the same region
✅ Quota Check: Verify sufficient resource quota
✅ Dependency Verification: Confirm dependent resources (image, network, storage) exist and are available
✅ Permission Verification: Ensure AccessKey has necessary permissions
✅ Cost Reminder: Provide reminders for operations that may incur high fees

Sensitive Operation Confirmation Process

Information Summary: Display all key configuration parameters
Impact Description: Explain the scope of impact and potential risks of the operation
User Confirmation: Wait for explicit user confirmation ("Yes", "Confirm", "Continue", etc.)
Execute Operation: Execute the confirmed operation
Result Feedback: Provide detailed operation results and follow-up suggestions

alibabacloud-ehpc-instant-job-skill

NPX Install

Tags

SKILL.md Content (Chinese)

Alibaba Cloud E-HPC Instant Job Management Skill

Skill Overview

Interaction Principles

Execution Process

Step 1: Preload Configuration

Step 2: Precondition Check

General Checks for All Job Management Tasks

Special Checks for Job Creation Tasks

Step 3: Job Management Execution

Create Job

Query Job List

Get Job Details

Query Job Logs

Delete Job

Step 4: Result Output and Follow-up Suggestions

Job Management Reference Execution Scripts

Notes

Troubleshooting and Best Practices

Common Issue Solutions

Best Practices Guide

Reference Materials and Extensions

Complete API Reference

Special Configuration Guides

Official Documentation

Security Policies and Risk Control

Operation Risk Level Classification

Security Check Checklist

Sensitive Operation Confirmation Process