附录

命令行接口列表

此处仅列出系统容器与普通容器的差异命令，其他命令用户可以查阅iSulad容器引擎相关章节，或者执行isula XXX —help进行查询。

命令

参数

参数指定值说明

isula create/run

—external-rootfs
  • 字符串变量。
  • 宿主机某个绝对路径。
  • 运行系统容器时，必须使用此参数指定特定虚拟机的rootfs。

—system-container
  • 布尔变量。
  • 指定某个容器是否属于系统容器，如果是系统容器场景，必须使能。

—add-host
  • 字符串变量。
  • 格式为：<hostname>:<ip>，指定容器的hosts配置，可以指定多个参数。

—dns，—dns-option，—dns-search
  • 字符串变量。
  • 可以指定多个，指定容器的dns配置。

—ns-change-opt
  • 字符串变量。
  • 容器namespace化内核参数可修改选项，参数只能为net或ipc，如果指定多个，用逗号隔开，例如—ns-change-opt=net,ipc。

—oom-kill-disable
  • 布尔变量。
  • 表示是否打开oom-kill-disable功能。

—shm-size
  • 字符串变量。
  • 设置/dev/shm大小，默认64MB。 支持单位B(b)、K(k)、M(m)、G(g)、T(t)、P(p)。

—sysctl
  • 字符串变量。
  • 指定容器内核参数值，格式为key=value，可传入多个，sysctl白名单如下：

kernel.msgmax，kernel.msgmnb，kernel.msgmni，kernel.sem，kernel.shmall，kernel.shmmax，kernel.shmmni， kernel.shm_rmid_forced，kernel.pid_max，net.，fs.mqueue。

说明：

容器内kernel.pid_max参数需要内核支持pid_max namespace化，否则会报错。

容器内sysctl白名单参数值限制与物理机对应的内核参数限制保持一致（包括参数类型、参数取值范围等）。

—env-target-file
  • 字符串变量。
  • 指定env持久化文件路径（路径必须为绝对路径，且文件必须在rootfs目录下），文件如果存在不能超过10MB，如果—env和文件里面的env出现冲突，—env指定值生效。
  • 绝对路径的根目录/为rootfs根目录,，即要指定文件路径为容器内/etc/environment，只用指定env-target-file=/etc/environment，而不是env-target-file=/path/of/root-fs/etc/environemt。

—cgroup-parent
  • 字符串变量。
  • 指定容器的cgroup父目录，cgroup根路径为/sys/fs/cgroup/<controller>。

—host-channel
  • 字符串变量。
  • 指定宿主机和容器共享内存空间（tmpfs），格式为：

<host path>:<container path>:<rw/ro>:<size limit>

—files-limit
  • 字符串变量。
  • 整数值，指定容器内文件句柄数最大值。

—user-remap
  • 字符串变量。
  • 参数格式为：<uid>:<gid>:<offset>