Appendix ​

isula create/run

--external-rootfs

• Variable of the string type.
• Absolute path on the host.
• Specifies the rootfs of a VM when running a system container.

--system-container

• Boolean variable.
• Specifies whether a container is a system container. In a system container scenario, this function must be enabled.

--add-host

• Variable of the string type.
• Specifies the hosts configuration for a container. The format is hostname:ip. Multiple values can be set.

--dns, --dns-option, --dns-search

• Variable of the string type.
• Specifies the DNS configuration for a container. Multiple values can be set.

--ns-change-opt

• Variable of the string type.
• Container namespace kernel parameter. The value can only be net or ipc. If multiple values are set, separate them with commas (,), for example, --ns-change-opt=net,ipc.

--oom-kill-disable

• Boolean variable.
• Indicates whether to enable the oom-kill-disable function.

--shm-size

• Variable of the string type.
• Sets the size of /dev/shm. The default value is 64 MB. The unit can be byte (B), kilobyte (KB), megabyte (MB), gigabyte (GB), terabyte (TB), or petabyte (PB).

--sysctl

• Variable of the string type.
• Specifies container kernel parameters. The format is key=value. Multiple values can be set. The sysctl whitelist is as follows:

kernel.msgmax, kernel.msgmnb, kernel.msgmni, kernel.sem, kernel.shmall, kernel.shmmax, kernel.shmmni, kernel.shm_rmid_forced, kernel.pid_max, net., and fs.mqueue

--env-target-file

• Variable of the string type.
• Specifies the env persistent file path. (The path must be an absolute path and the file must be in the rootfs directory.) The file size cannot exceed 10 MB. If the value of --env conflicts with that of env in the file, the value of --env takes effect.
• The root directory of the absolute path is the rootfs root directory. That is, to set the file path to /etc/environment in the container, you need to specify env-target-file=/etc/environment only.

--cgroup-parent

• Variable of the string type.
• Specifies the cgroup parent directory of a container. The cgroup root directory is /sys/fs/cgroup/controller.

--host-channel

• Variable of the string type.
• Specifies the memory space shared between the host and a container (tmpfs). The format is as follows:

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

--files-limit

• Variable of the string type.
• Specifies the maximum number of file handles in a container. The value must be an integer.

--user-remap

• Variable of the string type.
• The parameter format is uid:gid:offset.