由于边缘设备存储空间有限，并且边缘设备多采用EMMC等flash作为存储介质，该介质存在使用寿命的限制。为避免存储空间过快被写满从而影响业务或存储介质过快达到使用寿命，用户可以参考本章节边缘容器日志的输出建议，使边缘容器以合适的方式输出日志。

当前Atlas硬件上运行的边缘容器应用一般是通过K8s兼容的边缘管理平台来进行管理，如华为云IEF或基于kubeedge搭建的第三方边缘平台等。在该平台下，容器日志的输出方式主要分为以下三种：

如果系统中有日志服务器，建议直接在容器中将日志输出到日志服务中；如果没有，建议采用挂载到主机目录的方式输出日志，减少日志对硬件和其他业务影响的风险。

在这种方式下，应用将容器的日志输出到标准输出。缺省情况下，Docker引擎捕捉所有容器的标准输出，使用JSON格式写入到文件里，该文件会保存到主机的“/var/lib/docker/containers/containerid”目录下，如图1所示。

图1 containerid-json.log文件所在路径示例

如果边缘管理平台不支持该目录下日志文件的绕接或日志绕接配置错误，会导致/var/lib/docker被占满，从而影响新容器的部署及其他容器业务的正常运行。故不建议采用该方式。

该方式下边缘平台日志收集的方式如图2所示。

图2 方案架构

应用将容器日志挂载到边缘主机上。边缘管理平台提供主机上日志收集能力，并将主机文件日志进行绕接。

应用可以将容器日志挂载到主机上的非关键大容量目录，建议不要挂载到EMMC等存储介质上，避免影响硬件整体寿命。
边缘容器管理平台一般会支持该能力，建议使用该方案，以减少对系统目录var/lib/docker的影响。基于安全性考虑，该配置需要符合所在组织的安全要求。

如图3所示，应用环境里如果有日志服务器，可以将日志直接送到外部的日志服务器，这样日志不用在边缘环境里落盘，最大限度减少对硬件和其他业务的影响。

图3 方案架构

Ascend Docker Runtime会根据实际环境情况默认以只读方式挂载以下目录和文件到容器中。

表1 默认挂载目录和文件（Atlas 200 AI加速模块 RC场景）
路径	说明
/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	文件，驱动的版本信息。

表3 默认挂载目录和文件（Atlas 200I A2 加速模块和Atlas 200I DK A2 开发者套件）
路径	说明
/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

表5 默认挂载目录和文件（Atlas 500 A2 智能小站）
路径	说明
/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

表6 默认挂载目录和文件（其他设备）
路径	说明
/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安装后，会在安装目录生成可执行工具，涉及到的指令为内部命令，用户请勿直接使用，相关指令如表7所示。

表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	-	-
ascend-docker-runtime	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工具会忽略参数运行，运行时会接受标准输入。

Ascend Docker Runtime组件参考信息说明