'%20fill='%23C31D20'%20fill-rule='nonzero'%3e%3cpath%20d='M7.55269822,13.7609409%20C10.8552199,9.97176134%2014.2271223,7.63452926%2017.1034483,6.5677512%20L17.0816429,0.884990191%20C17.0593112,0.508963963%2016.8188535,0.182653682%2016.4703158,0.055395956%20C16.1217781,-0.0718617705%2015.7322263,0.0244201241%2015.4799397,0.300178022%20L12.9584465,3.07097775%20L0.368821458,17.4916392%20C0.0232151224,17.8857306%20-0.0894678188,18.437454%200.0732192079,18.9389805%20C0.235906234,19.4405071%200.649247199,19.815643%201.15754056,19.9230783%20C1.66583392,20.0305135%202.19185783,19.853926%202.53746417,19.4598346%20L7.5467513,13.7690073%20L7.55269822,13.7609409%20Z'%20id='路径'%3e%3c/path%3e%3cpath%20d='M10.6896552,12.0927463%20L15.1004089,17.5535201%20C15.4511303,17.8402432%2015.9409156,17.8973222%2016.3502521,17.6991755%20C16.7595885,17.5010287%2017.0117165,17.0848129%2016.993637,16.6370685%20L17.1034483,10.0202479%20C14.5615201,9.75868982%2012.477139,10.7130773%2010.6896552,12.0927463%20Z'%20id='路径'%3e%3c/path%3e%3c/g%3e%3crect%20id='矩形'%20x='0'%20y='0'%20width='24'%20height='24'%3e%3c/rect%3e%3c/g%3e%3c/g%3e%3c/svg%3e)
Ascend Docker Runtime组件参考信息说明
Ascend Docker Runtime组件参考信息分为边缘容器日志输出指导、Ascend Docker Runtime默认挂载内容和Ascend Docker Runtime命令说明。
背景
由于边缘设备存储空间有限，并且边缘设备多采用EMMC等flash作为存储介质，该介质存在使用寿命的限制。为避免存储空间过快被写满从而影响业务或存储介质过快达到使用寿命，用户可以参考本章节边缘容器日志的输出建议，使边缘容器以合适的方式输出日志。
简介
当前Atlas硬件上运行的边缘容器应用一般是通过K8s兼容的边缘管理平台来进行管理，如华为云IEF或基于kubeedge搭建的第三方边缘平台等。在该平台下，容器日志的输出方式主要分为以下三种：
- 容器控制台标准输出（STDOUT和STDERR）方式
- 挂载到主机目录方式
- 容器日志直接输出到日志服务
如果系统中有日志服务器，建议直接在容器中将日志输出到日志服务中；如果没有，建议采用挂载到主机目录的方式输出日志，减少日志对硬件和其他业务影响的风险。
容器控制台标准输出方式
在这种方式下，应用将容器的日志输出到标准输出。缺省情况下，Docker引擎捕捉所有容器的标准输出，使用JSON格式写入到文件里，该文件会保存到主机的“/var/lib/docker/containers/containerid”目录下，如图1所示。
如果边缘管理平台不支持该目录下日志文件的绕接或日志绕接配置错误，会导致/var/lib/docker被占满，从而影响新容器的部署及其他容器业务的正常运行。故不建议采用该方式。
挂载到主机目录方式
该方式下边缘平台日志收集的方式如图2所示。
应用将容器日志挂载到边缘主机上。边缘管理平台提供主机上日志收集能力，并将主机文件日志进行绕接。
- 应用可以将容器日志挂载到主机上的非关键大容量目录，建议不要挂载到EMMC等存储介质上，避免影响硬件整体寿命。
- 边缘容器管理平台一般会支持该能力，建议使用该方案，以减少对系统目录var/lib/docker的影响。基于安全性考虑，该配置需要符合所在组织的安全要求。
Ascend Docker Runtime默认挂载内容
Ascend Docker Runtime会根据实际环境情况默认以只读方式挂载以下目录和文件到容器中。
路径 |
说明 |
|---|---|
/dev/davinciX |
NPU设备，X是ID号。例如：davinci0。 |
/dev/davinci_manager |
管理设备。 |
/usr/local/Ascend/driver/tools |
目录，驱动提供的工具包。 |
/usr/local/Ascend/driver/lib64 |
目录，驱动提供的用户态库。 |
/usr/local/sbin/npu-smi |
文件，NPU-SMI工具。 |
/etc/hdcBasic.cfg |
文件，hdc基础文件。 |
/etc/sys_version.conf |
文件，驱动的版本信息。 |
路径 |
说明 |
|---|---|
/dev/davinciX |
NPU设备，X是ID号。例如：davinci0。 |
/dev/davinci_manager |
davinci相关的设备管理的设备。 |
/usr/local/bin/npu-smi |
文件，NPU-SMI工具。 |
/etc/hdcBasic.cfg |
文件，hdc基础文件。 |
/etc/sys_version.conf |
文件，驱动的版本信息。 |
路径 |
说明 |
|---|---|
/dev/davinciX |
NPU设备，X是ID号。例如：davinci0。 |
/dev/davinci_manager |
davinci相关的设备管理的设备。 |
/dev/svm0 |
内存管理的设备。 |
/dev/ts_aisle |
aicpudrv驱动设备，为任务调度提供事件驱动的渠道接口。 |
/dev/upgrade |
驱动设备。 |
/dev/sys |
|
/dev/vdec |
设备文件，支撑推理业务。 |
/dev/vpc |
|
/dev/pngd |
|
/dev/venc |
|
/dev/dvpp_cmdlist |
|
/dev/log_drv |
日志驱动设备。 |
/etc/sys_version.conf |
文件，驱动的版本信息。 |
/etc/hdcBasic.cfg |
文件，hdc基础文件。 |
/usr/local/sbin/npu-smi |
文件，NPU-SMI工具。 |
/usr/local/Ascend/driver/lib64 |
目录，驱动提供的用户态库。 |
/usr/lib64/aicpu_kernels/ |
|
/var/slogd |
文件，日志组件。 |
/var/dmp_daemon |
文件，dmp守护进程。 |
/usr/lib64/libaicpu_processer.so |
文件，驱动所需动态库。 |
/usr/lib64/libaicpu_prof.so |
|
/usr/lib64/libaicpu_sharder.so |
|
/usr/lib64/libadump.so |
|
/usr/lib64/libtsd_eventclient.so |
|
/usr/lib64/libaicpu_scheduler.so |
|
/usr/lib64/libdcmi.so |
|
/usr/lib64/libmpi_dvpp_adapter.so |
|
/usr/lib64/libstackcore.so |
路径 |
说明 |
|---|---|
/dev/davinciX |
NPU设备，X是ID号。例如：davinci0。 |
/dev/davinci_manager |
管理设备。 |
/dev/hisi_hdc |
管理设备。 |
/dev/devmm_svm |
管理设备。 |
/home/data/miniD/driver/lib64 |
目录，驱动提供的用户态库。 |
/usr/local/lib/libdcmi.so |
文件，DCMI动态库。 |
/usr/local/bin/npu-smi |
文件，NPU-SMI工具。 |
路径 |
说明 |
|---|---|
/dev/davinciX |
NPU设备，X是ID号。例如：davinci0。 |
/dev/davinci_manager |
davinci相关的设备管理的设备。 |
/dev/svm0 |
内存管理的设备。 |
/dev/ts_aisle |
aicpudrv驱动设备，为任务调度提供事件驱动的渠道接口。 |
/dev/upgrade |
驱动设备。 |
/dev/sys |
|
/dev/vdec |
设备文件，支撑推理业务。 |
/dev/vpc |
|
/dev/pngd |
|
/dev/venc |
|
/dev/dvpp_cmdlist |
|
/dev/log_drv |
日志驱动设备。 |
/usr/local/Ascend/driver/lib64 |
目录，驱动提供的用户态库。 |
/usr/lib64/aicpu_kernels |
|
/usr/local/sbin/npu-smi |
文件，NPU-SMI工具。 |
/etc/sys_version.conf |
文件，驱动的版本信息。 |
/etc/ld.so.conf.d/mind_so.conf |
驱动动态库路径配置文件 |
/etc/hdcBasic.cfg |
文件，hdc基础文件。 |
/var/dmp_daemon |
文件，dmp守护进程。 |
/var/slogd |
文件，日志组件。 |
/usr/lib64/libsemanage.so.2 |
文件，驱动所需动态库。 |
/usr/lib64/libmmpa.so |
|
/usr/lib64/libcrypto.so.1.1 |
|
/usr/lib64/libdrvdsmi.so |
|
/usr/lib64/libdcmi.so |
|
/usr/lib64/libstackcore.so |
|
/usr/lib64/libmpi_dvpp_adapter.so |
|
/usr/lib64/libaicpu_scheduler.so |
|
/usr/lib64/libaicpu_processer.so |
|
/usr/lib64/libaicpu_prof.so |
|
/usr/lib64/libaicpu_sharder.so |
|
/usr/lib64/libadump.so |
|
/usr/lib64/libtsd_eventclient.so |
|
/usr/lib64/libyaml-0.so.2 |
路径 |
说明 |
|---|---|
/dev/davinciX |
NPU设备，X是ID号。例如：davinci0。 |
/dev/davinci_manager |
管理设备。 |
/dev/hisi_hdc |
管理设备。 |
/dev/devmm_svm |
管理设备。 |
/usr/local/Ascend/driver/lib64 |
目录，驱动提供的用户态库。 |
/usr/local/Ascend/driver/include |
目录，驱动提供的头文件。 |
/usr/local/dcmi |
目录，DCMI头文件和库。 |
/usr/local/bin/npu-smi |
文件，NPU-SMI工具。 |
Ascend Docker Runtime命令说明
Ascend Docker Runtime安装后，会在安装目录生成可执行工具，涉及到的指令为内部命令，用户请勿直接使用，相关指令如表7所示。
工具名 |
短指令 |
长指令 |
其他参数类型 |
其他参数位置 |
|---|---|---|---|---|
ascend-docker-cli |
p |
pid |
- |
- |
r |
rootfs |
- |
- |
|
o |
options |
- |
- |
|
f |
mount-file |
- |
- |
|
l |
allow-link |
- |
- |
|
i |
mount-dir |
- |
- |
|
ascend-docker-plugin-install-helper |
- |
add |
- |
1 |
- |
rm |
- |
1 |
|
h |
- |
- |
- |
|
- |
- |
destPath |
2 |
|
- |
- |
srcPath |
3 |
|
- |
- |
installPath |
安装时为4 |
|
- |
- |
reserveDefault |
安装时为5，卸载时为4 |
|
ascend-docker-runtime |
0 |
create |
- |
- |
b |
bundle |
- |
- |
|
ascend-docker-destroy |
- |
- |
cardId |
1 |
- |
- |
- |
deviceId |
2 |
- |
- |
- |
vDeviceId |
3 |
- 因为Ascend Docker Runtime会将输入参数直接传递至runc或者docker-runc，所以runc/docker-runc的相关参数也会被Ascend Docker Runtime接受，用户请自行参考所在环境的runc/docker-runc的命令行选项使用相关参数。
- ascend-docker-hook工具会忽略参数运行，运行时会接受标准输入。
