ascend/agent-skills/ascend-docker

Name: ascend-docker
Author: ascend

Claude Code and agent skill by ascend/agent-skills

Trust tier 3

community
ext:[{"type":"plugin","description":"Custom plugin integration"}]

Source check pending

Checking that the SKILL.md file is still in the repository.

Create Docker containers for Huawei Ascend NPU development with proper device mappings and volume mounts. Use when setting up Ascend development environments in Docker, running CANN applications in containers, or creating isolated NPU development workspaces. Supports privileged mode (default), basic mode, and full mode with profiling/logging. Auto-detects available NPU devices.

Install

npx vskill@latest install ascend/agent-skills/ascend-docker

Semi-extensibleMentions customization, but needs skill-specific knowledge. Read the extensible skills standard

SKILL.md

The same SKILL.md was published earlier as ascend-ai-coding/awesome-ascend-skills/ascend-docker.

Ascend Docker Container

Create Docker containers configured for Huawei Ascend NPU development.

Quick Start

bash

# Privileged mode (default, auto-detect all devices)
./scripts/run-ascend-container.sh <image> <container_name>
 
# Basic mode with specific devices
./scripts/run-ascend-container.sh <image> <container_name> --mode basic
 
# Full mode with selected devices
./scripts/run-ascend-container.sh <image> <container_name> --mode full --device-list "0,1,2,3"

Device Selection

The script auto-detects available NPU devices from /dev/davinci*. Use --device-list to select specific devices:

bash

# Use all detected devices (default)
./scripts/run-ascend-container.sh <image> <container_name>
 
# Use specific devices
./scripts/run-ascend-container.sh <image> <container_name> --device-list "0,1,2,3"
 
# Use device range
./scripts/run-ascend-container.sh <image> <container_name> --device-list "0-3"
 
# Combine ranges and individual devices
./scripts/run-ascend-container.sh <image> <container_name> --device-list "0-3,7,10-11"

Check available devices:

bash

ls /dev/davinci* | grep -oE 'davinci[0-9]+$'

Container Modes

1. Privileged Mode (Default)

Maximum permissions, suitable when no specific requirements.

bash

docker run -itd --privileged --name=<CONTAINER_NAME> --ipc=host --net=host \
  --device=/dev/davinci_manager \
  --device=/dev/devmm_svm \
  --device=/dev/hisi_hdc \
  -v /usr/local/sbin:/usr/local/sbin:ro \
  -v /usr/local/Ascend/driver:/usr/local/Ascend/driver:ro \
  -v /home:/home \
  -w /home \
  <IMAGE> \
  /bin/bash

2. Basic Mode

Specific device mapping with network host, for inference workloads.

bash

docker run -itd --net=host \
  --name=<CONTAINER_NAME> \
  --device=/dev/davinci_manager \
  --device=/dev/hisi_hdc \
  --device=/dev/devmm_svm \
  --device=/dev/davinci0 \
  --device=/dev/davinci1 \
  ... \
  -v /usr/local/Ascend/driver:/usr/local/Ascend/driver:ro \
  -v /usr/local/sbin:/usr/local/sbin:ro \
  -v /etc/localtime:/etc/localtime \
  -v /home:/home \
  <IMAGE> \
  /bin/bash

3. Full Mode

With profiling, logging, dump, and add-ons support.

bash

docker run -itd --ipc=host \
  --name=<CONTAINER_NAME> \
  --device=/dev/davinci_manager \
  --device=/dev/devmm_svm \
  --device=/dev/hisi_hdc \
  --device=/dev/davinci0 \
  --device=/dev/davinci1 \
  ... \
  -v /usr/local/Ascend/driver:/usr/local/Ascend/driver \
  -v /usr/local/Ascend/add-ons/:/usr/local/Ascend/add-ons/ \
  -v /usr/local/sbin/npu-smi:/usr/local/sbin/npu-smi \
  -v /usr/local/sbin/:/usr/local/sbin/ \
  -v /var/log/npu/conf/slog/slog.conf:/var/log/npu/conf/slog/slog.conf \
  -v /var/log/npu/slog/:/var/log/npu/slog \
  -v /var/log/npu/profiling/:/var/log/npu/profiling \
  -v /var/log/npu/dump/:/var/log/npu/dump \
  -v /var/log/npu/:/usr/slog \
  -v /etc/localtime:/etc/localtime \
  -v /home:/home \
  <IMAGE> \
  /bin/bash

Mode Comparison

Feature	Privileged	Basic	Full
Network mode	host	host	-
IPC mode	host	-	host
Device access	All (via privileged)	Selected devices	Selected devices
Profiling support	✓	✗	✓
Dump support	✓	✗	✓
Logging (slog)	✓	✗	✓
Security	Lowest	Higher	Higher

Device Parameters

Device	Purpose
`/dev/davinci_manager`	NPU device manager
`/dev/devmm_svm`	Device memory management
`/dev/hisi_hdc`	HDC communication device
`/dev/davinci<N>`	Individual NPU devices (0, 1, 2, ...)

Volume Parameters

Volume	Purpose
`/usr/local/Ascend/driver`	Ascend driver libraries
`/usr/local/sbin`	NPU management tools (npu-smi)
`/usr/local/Ascend/add-ons`	Additional Ascend components
`/var/log/npu/slog`	System logs
`/var/log/npu/profiling`	Profiling data
`/var/log/npu/dump`	Dump data
`/etc/localtime`	Timezone sync
`/home`	User workspace

Common Images

bash

ascendhub.huawei.com/public-ascendhub/ascend-pytorch:24.0.RC1
ascendhub.huawei.com/public-ascendhub/ascend-mindspore:24.0.RC1
ascendhub.huawei.com/public-ascendhub/ascend-toolkit:24.0.RC1

Container Management

bash

docker exec -it <container_name> bash
docker stop <container_name>
docker start <container_name>
docker rm -f <container_name>

Post-Setup

For self-built images, configure environment variables:

bash

echo 'source /usr/local/Ascend/ascend-toolkit/set_env.sh' >> ~/.bashrc
source ~/.bashrc

Official References

Ascend Docker Guide

Security

Security scanPassed, 90 of 100Pattern checks on the skill's files.
Model reviewPassed

See the full security report

Quality evaluation

Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

SKILL.md in the repositoryCheckingskills/ascend-docker/SKILL.md

Popularity

7-day trend score: 0

Not refreshed yet.

Extension points

pluginCustom plugin integration

Learn the extensible skills standard

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

Claude Code
Cursor
GitHub Copilot
Windsurf
Codex
Gemini CLI
Cline
Amp
Roo Code
Goose
Continue
Kilo Code
Junie
Trae
OpenHands
Qwen Code
AI Agent
Tabnine Chat
Sourcegraph Cody
Amazon Q
Firebase Genkit
Sweep
Devin
Phind
Mentat
Claude Desktop
Aider
GPT Pilot
Plandex
bolt.new
v0
Replit Agent
Anse
TypingMind
BetterChatGPT
LibreChat
Warp AI
Pieces
Fig AI

Embed badge

[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/ascend/agent-skills/ascend-docker/badge)](https://verified-skill.com/skills/ascend/agent-skills/ascend-docker)

Something wrong with this skill or its page? Tell us.